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.
REMARQUE
| Colonne | Description |
|---|---|
| Nom | Le champ nom correspond soit au nom du modèle, soit aux premiers caractères de votre requête SQL. Toute requête créée à l’aide de l’interface utilisateur avec le Query Editor est nommée dès le départ. Si la requête a été créée via l’API, son nom devient un fragment de code SQL initial utilisé pour créer la requête. Pour afficher la liste de toutes les exécutions associées à la requête, sélectionnez un élément dans la colonne Nom. Pour plus d’informations, voir la section détails du planning d’exécution de requête . |
| Modèle | Nom du modèle de la requête. Sélectionnez un nom de modèle pour accéder à l’éditeur de requêtes. Le modèle de requête est affiché dans l’éditeur de requêtes pour plus de commodité. S’il n’existe aucun nom de modèle, la ligne est marquée d’un trait d’union et il n’est pas possible d’effectuer une redirection vers l’éditeur de requêtes pour afficher la requête. |
| SQL | Fragment de la requête SQL. |
| Fréquence d’exécution | La cadence d’exécution de votre requête. Les valeurs disponibles sont Run once et Scheduled. |
| Créé par | Nom de la personne qui a créé la requête. |
| Créé | La date et l’heure de création de la requête, au format UTC. |
| Horodatage de la dernière exécution | La date et l’heure les plus récentes auxquelles la requête a été exécutée. Cette colonne met en évidence si une requête a été exécutée conformément à son planning actuel. |
| État de la dernière exécution | Statut de la dernière exécution de la requête. Les valeurs d’état sont : Success, Failed, In progress et No runs. |
| État de planification |
État actuel de la requête planifiée. Il existe six valeurs potentielles, Enregistrement, Actif, Inactif, Supprimé, un trait d'union et Quarantiné.
|
CONSEILPersonnaliser les paramètres des tableaux pour les requêtes planifiées
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 (
REMARQUE
Activez/désactivez les cases à cocher appropriées pour supprimer ou ajouter une colonne de tableau. Ensuite, sélectionnez Appliquer pour confirmer vos choix.
REMARQUE
Gestion des requêtes planifiées avec des actions intégrées
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
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.
REMARQUESuppression d’une requête planifiée
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
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 (
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 :
| Type d’alerte | Description |
|---|---|
start | Cette alerte vous avertit lorsqu’une exécution de requête planifiée est lancée ou commence à être traitée. |
success | Cette alerte vous informe lorsqu’une requête planifiée s’exécute correctement, ce qui indique que la requête s’est exécutée sans erreur. |
failed | Cette alerte se déclenche lorsqu’une exécution de requête planifiée rencontre une erreur ou échoue à s’exécuter correctement. Il vous aide à identifier et à résoudre rapidement les problèmes. |
quarantine | Cette alerte est activée lorsqu’une exécution de requête planifiée est mise en quarantaine. Lorsque des requêtes sont inscrites 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. Elles nécessitent alors votre intervention avant toute autre exécution. |
delay | Cette alerte vous avertit si le résultat d’une exécution de requête 🔗 est retardé au-delà d’un seuil spécifié. Vous pouvez définir une heure personnalisée qui déclenche l’alerte lorsque la requête s’exécute pendant cette durée sans avoir terminé ou échoué. |
REMARQUEPour plus d’informations, consultez la documentation de l’API d’abonnements aux alertes .
Afficher les détails de la requête
Sélectionnez l’icône d’information (
Requêtes en quarantaine
REMARQUELorsqu’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
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.
REMARQUE
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
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 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 .
REMARQUE
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
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.
| Nom de la colonne | Description |
|---|---|
| ID d’exécution de requête | Identifiant d’exécution de requête pour l’exécution quotidienne. Sélectionnez l’ identifiant d’exécution de requête pour accéder à la présentation de l’exécution de requête. |
| Démarrage de l’exécution de requête | Date et heure de l’exécution de la requête. L’horodatage est au format UTC. |
| Fin de requête | Date et heure de la fin de la requête. L’horodatage est au format UTC. |
| Statut | Statut de la dernière exécution de la requête. Les valeurs d’état sont : Success, Failed, In progress ou Quarantined. |
| Jeu de données | Jeu de données présent dans l’exécution. |
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.
