Surveiller les requêtes planifiées

Adobe Experience Platform offre une meilleure visibilité du statut de toutes les tâches de requête via l’interface utilisateur. Depuis l’onglet Requêtes planifiées, vous pouvez désormais trouver des informations importantes sur vos exécutions de requêtes qui incluent le statut, les détails de la planification et les messages/codes d’erreur en cas d’échec. Vous pouvez également vous abonner à des alertes pour les requêtes en fonction de leur statut par le biais de l’interface utilisateur pour l’une de ces requêtes via l’onglet Requêtes planifiées.

Requêtes planifiées

L’onglet Requêtes planifiées donne un aperçu de toutes vos requêtes CTAS et ITAS planifiées. Vous trouverez des détails sur l’exécution pour toutes les requêtes planifiées, ainsi que des codes d’erreur et des messages pour toutes les requêtes ayant échoué.

Pour accéder à l’onglet ​ Requêtes planifiées ​, sélectionnez Requêtes dans la barre de navigation de gauche, suivi de Requêtes planifiées

Le tableau ci-dessous décrit chaque colonne disponible.

NOTE

L’icône d’abonnement aux alertes ( ) est contenu dans chaque ligne d’une colonne sans titre. Consultez la section Abonnements aux alertes pour plus d’informations.

Personnaliser les paramètres des tableaux pour les requêtes planifiées customize-table

Vous pouvez ajuster les colonnes de l’onglet Requêtes planifiées à vos besoins. Pour ouvrir la boîte de dialogue des paramètres Personnaliser le tableau et modifier les colonnes disponibles, sélectionnez l’icône des paramètres ( ) en haut à droite de l’écran.

Activez/désactivez les cases à cocher appropriées pour supprimer ou ajouter une colonne de tableau. Sélectionnez ensuite Appliquer pour confirmer vos choix.

Gestion des requêtes planifiées avec des actions intégrées inline-actions

La vue Requêtes planifiées offre diverses actions intégrées pour gérer toutes vos requêtes planifiées à partir d’un seul emplacement. Les actions intégrées sont indiquées dans chaque ligne par des points de suspension. Sélectionnez les points de suspension d’une requête planifiée que vous souhaitez gérer pour afficher les options disponibles dans un menu pop-up. Les options disponibles sont les suivantes : Désactiver le planning ou Activer le planning, Modifier le planning, Supprimer le planning, S’abonner pour envoyer des alertes de requête, et Activer ou Désactiver la quarantaine.

Désactiver ou activer une requête planifiée disable

Pour désactiver une requête planifiée, sélectionnez les points de suspension de la requête planifiée que vous souhaitez gérer, puis sélectionnez Désactiver le planning dans les options du menu pop-up. Une boîte de dialogue s’affiche pour confirmer votre action. Sélectionnez Désactiver pour confirmer votre paramètre.

Une fois qu’une requête planifiée est désactivée, vous pouvez activer le planning par le même processus. Sélectionnez les points de suspension, puis sélectionnez Activer le planning dans les options disponibles.

Modification d’une requête planifiée edit

Pour modifier une requête planifiée, sélectionnez les points de suspension (…) pour le planning que vous souhaitez modifier, puis sélectionnez Modifier le planning dans les options du menu pop-up. Le workflow de modification s’ouvre, vous permettant de mettre à jour les paramètres de planification pris en charge, tels que la fréquence, la date de fin, l’inscription à la quarantaine de requête et les abonnements aux alertes.

L’option Modifier le planning n’est disponible que pour les plannings actifs ou à venir. Les planifications terminées sont en lecture seule et ne peuvent pas être modifiées. Les horaires qui ont été supprimés ou qui s’enregistrent toujours n’affichent pas non plus cette option.

Pour obtenir des instructions complètes sur le workflow de modification, les champs modifiables et les exigences d’éligibilité, consultez Modifier un planning.

Supprimer une requête planifiée delete

Pour supprimer une requête planifiée, sélectionnez les points de suspension de la requête planifiée que vous souhaitez gérer, puis sélectionnez Supprimer le planning dans les options du menu pop-up. Une boîte de dialogue s’affiche pour confirmer votre action. Sélectionnez Supprimer pour confirmer votre paramètre.

Une fois qu’une requête planifiée est supprimée, elle n’est pas supprimée de la liste des requêtes planifiées. Les actions intégrées fournies par les points de suspension sont supprimées et remplacées par l’icône grisée Ajouter un abonnement aux alertes. Vous ne pouvez pas vous abonner aux alertes pour le planning supprimé. La ligne reste dans l’interface utilisateur pour fournir des informations sur les exécutions effectuées dans le cadre de la requête planifiée.

Si vous souhaitez planifier des exécutions pour ce modèle de requête, sélectionnez le nom du modèle à partir de la ligne appropriée pour accéder à Query Editor, puis suivez les instructions pour ajouter un planning à une requête comme décrit dans la documentation.

S’abonner aux alertes alert-subscription

Pour vous abonner à des alertes pour les exécutions de requête planifiées, sélectionnez l’icône d’abonnement aux ... (points de suspension) ou aux alertes ( ) pour la requête planifiée que vous souhaitez gérer. Le menu déroulant des actions intégrées s’affiche. Sélectionnez ensuite S’abonner parmi les options disponibles.

La boîte de dialogue Alertes s’ouvre. La boîte de dialogue Alertes vous abonne à la fois aux notifications de l’interface utilisateur et aux alertes par e-mail. Plusieurs options d’abonnement aux alertes sont disponibles : start, success, failure, quarantine et delay. Cochez la ou les cases correspondantes et sélectionnez Enregistrer pour vous abonner.

Le tableau ci-dessous décrit les types d’alerte de requête pris en charge :

Pour plus d’informations, consultez la documentation de l’API d’abonnements aux alertes.

Affichage des détails de la requête query-details

Sélectionnez l’icône d’information ( ) pour afficher le panneau des détails de la requête. Le panneau de détails contient toutes les informations pertinentes sur la requête au-delà des faits inclus dans le tableau des requêtes planifiées. Les informations supplémentaires incluent l’identifiant de la requête, la date de dernière modification, le code SQL de la requête, l’identifiant du planning et le planning défini actuel.

Requêtes mises en quarantaine quarantined-queries

Lorsqu’elle est inscrite à la fonction de quarantaine, toute requête planifiée qui échoue dix exécutions consécutives passe automatiquement au statut Quarantaine. Une requête avec ce statut devient inactive et ne s’exécute pas à sa cadence planifiée. Il nécessite ensuite votre intervention avant que d’autres exécutions ne puissent avoir lieu. Cela permet de préserver les ressources système, car vous devez examiner et corriger les problèmes liés à votre SQL avant que d’autres exécutions ne se produisent.

Pour activer une requête planifiée pour la fonction de quarantaine, sélectionnez les points de suspension (...) suivis de Activer la quarantaine dans le menu déroulant qui s’affiche.

Les requêtes peuvent également être inscrites à la fonction de quarantaine pendant le processus de création du planning. Pour plus d’informations, consultez la documentation sur les plannings de requête.

Retard d’exécution de la requête query-run-delay

Gardez le contrôle de vos heures de calcul en définissant des alertes pour les retards de requête. Vous pouvez surveiller les performances des requêtes et recevoir des notifications si le statut d’une requête reste inchangé après une période spécifique. Utilisez l’alerte « Délai d’exécution de la requête » pour recevoir une notification si une requête continue à être traitée après une période spécifique sans être terminée.

Lorsque vous vous abonnez à des alertes pour les exécutions de requête planifiées, l’une des alertes disponibles est le Délai d’exécution de requête. Cette alerte nécessite de définir un seuil pour le temps d’exécution. Vous serez alors informé du retard de traitement.

Pour choisir une durée seuil qui déclenche la notification, saisissez un nombre dans le champ de saisie de texte ou utilisez les flèches vers le haut et vers le bas pour augmenter par incréments d’une minute. Comme le seuil est défini en minutes, la durée maximale d’observation d’un délai d’exécution de requête est de 1 440 minutes (24 heures). La période par défaut d’un délai d’exécution est de 150 minutes.

Consultez la section Abonnement aux alertes pour savoir comment vous abonner aux alertes Délai d’exécution des requêtes.

Filtrer des requêtes filter

Vous pouvez filtrer les requêtes selon la fréquence d’exécution. Dans l’onglet Requêtes planifiées, sélectionnez l’icône de filtre ( ) pour ouvrir la barre latérale du filtre.

Pour filtrer la liste des requêtes en fonction de leur fréquence d’exécution, cochez les cases de filtrage Planifié ou Exécuter une fois.

Une fois vos critères de filtre activés, sélectionnez Masquer les filtres pour fermer le panneau de filtrage.

Page Détails du planning query-runs

Pour ouvrir la page des détails du planning, sélectionnez un nom de requête dans l’onglet Requêtes planifiées. Cette vue fournit une liste de toutes les exécutions exécutées dans le cadre de cette requête planifiée. Les informations fournies incluent l’heure de début et de fin, le statut et le jeu de données utilisé. Pour les plannings actifs, sélectionnez Modifier le planning dans le coin supérieur droit pour modifier la configuration du planning. Voir Modifier un planning pour obtenir des instructions complètes.

Ces informations apparaissent dans un tableau à cinq colonnes. Chaque ligne indique l’exécution d’une requête.

Les détails de la requête en cours de planification sont visibles dans le panneau Propriétés. Ce panneau comprend l’ID de requête initial, le type de client, le nom du modèle, la requête SQL et la cadence du planning.

Sélectionnez un ID d’exécution de requête pour accéder à la page des détails de l’exécution et afficher les informations de la requête.

Vue d’ensemble de l’exécution de la requête query-run-overview

La présentation de l’exécution de la requête fournit des informations sur les exécutions individuelles de cette requête planifiée et une répartition plus détaillée du statut de l’exécution. Cette page inclut également les informations sur le client et les détails de toutes les erreurs qui ont pu entraîner l’échec de la requête.

La section du statut de la requête indique le code d’erreur et le message correspondant en cas d’échec de la requête.

Vous pouvez copier la requête SQL dans le presse-papiers à partir de cette vue. Pour copier la requête, sélectionnez l’icône de copie en haut à droite du fragment de code SQL. Un message contextuel confirme que le code a été copié.

Exécuter les détails des requêtes avec un bloc anonyme anonymous-block-queries

Les requêtes qui utilisent des blocs anonymes pour comprendre leurs instructions SQL sont séparées dans leurs sous-requêtes individuelles. La séparation en sous-requêtes vous permet d’examiner individuellement les détails d’exécution de chaque bloc de requête.

Les blocs anonymes sont signalés par l’utilisation d’un préfixe $$ avant la requête. Pour en savoir plus sur les blocs anonymes dans Query Service, consultez le document Bloc anonyme.

Les sous-requêtes en bloc anonymes comportent des onglets à gauche du statut d’exécution. Sélectionnez un onglet pour afficher les détails de l’exécution.

Dans le cas où une requête de bloc anonyme échoue, vous pouvez trouver le code d’erreur pour ce bloc spécifique via cette interface utilisateur.

Sélectionnez Requête pour revenir à l’écran des détails du planning, ou Requêtes planifiées pour revenir à l’onglet Requêtes planifiées.