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 maintenant trouver des informations importantes sur les exécutions de requête qui incluent l’état, les détails de 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 fournit 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

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 de paramètres Personnaliser le tableau et modifier les colonnes disponibles, sélectionnez l’icône de paramètres ( ) en haut à droite de l’écran.

Activez/désactivez les cases à cocher appropriées pour supprimer ou ajouter une colonne de tableau. Ensuite, sélectionnez 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 par des points de suspension dans chaque ligne. 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 contextuel. Les options disponibles sont les suivantes : Désactiver le planning ou Activer le planning, Supprimer le planning, S’abonner aux alertes de requête, et Activer ou Désactiver la quarantaine.

Désactivation ou activation d’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 la planification dans les options du menu contextuel. 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 biais du même processus. Sélectionnez les points de suspension, puis Activer le planning parmi les options disponibles.

Suppression d’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 contextuel. 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 ellipses sont supprimées et remplacées par l’icône d’abonnement d’une alerte grisée. Vous ne pouvez pas vous abonner à des 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 dans la ligne appropriée pour accéder à l’éditeur de requêtes, 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 aux alertes pour les exécutions de requête planifiées, sélectionnez l’icône ... (points de suspension) ou l’icône d’abonnement 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 .

Afficher les 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 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 de planification et le planning défini actuel.

Requêtes en quarantaine quarantined-queries

Lorsqu’elle est inscrite dans la fonction de quarantaine, toute requête planifiée qui échoue dix exécutions consécutives est automatiquement placée dans un état Quarantined. 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 toute autre exécution. Cela permet de protéger les ressources système, car vous devez examiner et corriger les problèmes liés à votre SQL avant d’autres exécutions.

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

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

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

Contrôlez les heures de votre ordinateur en définissant des alertes pour les délais des requêtes. Vous pouvez surveiller les performances des requêtes et recevoir des notifications si l’état d’une requête reste inchangé après une période spécifique. Utilisez l’alerte "Délai d’exécution de requête" pour être averti si une requête continue à traiter après une période spécifique sans avoir terminé.

Lorsque vous vous abonnez aux 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 la durée de l’exécution, à ce stade, vous serez informé du retard de traitement.

Pour choisir une durée de seuil qui déclenche la notification, saisissez un nombre dans le champ de saisie de texte ou utilisez les flèches haut et bas pour augmenter d'une minute. Puisque 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 abonner aux alertes pour savoir comment s’abonner aux alertes de délai d’exécution de requête.

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 filtre Planifié ou Exécuter une fois .

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

Détails du planning des exécutions de requête 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é.

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 requête fournit des informations sur les exécutions individuelles pour cette requête planifiée et une ventilation plus détaillée de l’état de l’exécution. Cette page contient également les informations sur le client et les détails des 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écution des détails des requêtes avec 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 identifiés à l'aide d'un préfixe $$ avant la requête. Pour en savoir plus sur les blocs anonymes dans le service de requête, consultez le document de bloc anonyme.

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

En cas d’échec d’une requête bloquée anonyme, vous pouvez trouver le code d’erreur correspondant à 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.