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. Dans la Requêtes planifiées , vous pouvez maintenant trouver des informations importantes sur les exécutions de votre 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
La variable 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.
Run once et Scheduled.Success, Failed, In progress, et No runs.État actuel de la requête planifiée. Il existe six valeurs potentielles, Enregistrement, Actif, Inactif, Supprimé, un trait d’union et Quarantiné.
- La variable Enregistrement Le statut indique que le système traite toujours la création du nouveau planning pour la requête. Remarque : vous ne pouvez pas désactiver ou supprimer une requête planifiée lors de son enregistrement.
- La variable Actif le statut indique que la requête planifiée possède pas encore passé date et heure d’achèvement.
- La variable Inactif le statut indique que la requête planifiée possède transmis sa date et son heure d’achèvement ou a été marquée par un utilisateur comme étant inactif.
- La variable Supprimé Le statut indique que le planning de requête a été supprimé.
- Le trait d’union indique que la requête planifiée est une requête ponctuelle non récurrente.
- La variable Quarantiné Le statut indique que la requête a échoué dix exécutions consécutives et nécessite votre intervention avant que d’autres exécutions ne puissent avoir lieu.
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 Personnalisation du tableau la boîte de dialogue paramètres et modifiez les colonnes disponibles, sélectionnez l’icône paramètres (
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 variable Requêtes planifiées view propose 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 incluent Désactiver le planning ou Activation du planning, Supprimer le planning, Abonner pour interroger des alertes, et Activez ou Désactiver la mise en 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 le planning dans les options du menu contextuel. Une boîte de dialogue s’affiche pour confirmer votre action. Sélectionner 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 sélectionnez Activation du planning dans 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électionner Supprimer pour confirmer votre paramètre.
Une fois une requête planifiée supprimée, elle est not supprimé 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 le 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êtes planifiées, sélectionnez l’une des options suivantes : ... (points de suspension) ou icône d’abonnement aux alertes (
La variable Alertes s’ouvre. La variable Alertes vous abonne aux notifications de l’interface utilisateur et aux alertes par courrier électronique. 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 :
startsuccessfailedquarantinedelayVoir documentation de l’API d’abonnements des alertes pour plus d’informations.
Afficher les détails de la requête query-details
Sélectionnez l’icône d’information (
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 une Quarantiné statut. 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 (...) suivie de Activer la mise en 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. Voir documentation sur les plannings de requête pour plus d’informations.
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 le ""Délai d’exécution de la requête" pour être averti si le traitement d’une requête se poursuit après une période spécifique sans avoir abouti.
Lorsque vous abonner aux alertes pour les exécutions de requête planifiées, l’une des alertes disponibles est la Délai d’exécution de la 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 Abonnement aux alertes pour savoir comment abonner à Délai d’exécution de la requête alertes.
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 filtrer la liste des requêtes selon leur fréquence d’exécution, sélectionnez l’une des options suivantes : Planifié ou Exécuter une seule fois des cases à cocher de filtre.
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 le 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.
Success, Failed, In progress, ou Quarantined.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 variable 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 d’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’une $$ avant la requête. Pour en savoir plus sur les blocs anonymes dans le service de requête, voir la section 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.
