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.

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 ( ) 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 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, et Abonner pour interroger des alertes.

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 d’une 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 d’une 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’alerte d’ajout grisé. 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ête planifiées, sélectionnez les points de suspension d’une requête planifiée à gérer, puis sélectionnez Abonner dans les options du menu contextuel.

La variable Alertes s’ouvre. La variable Alertes vous abonne aux notifications de l’interface utilisateur et aux alertes par courrier électronique. Les alertes reposent sur le statut de la requête. Trois options sont disponibles : start, success et failure. Cochez la ou les cases correspondantes et sélectionnez Enregistrer pour vous abonner. Vous pouvez vous abonner à des alertes tant qu’elles n’ont pas de Horodatage de la dernière exécution .

Voir 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 ( ) 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.

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 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.

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.

Présentation de l’exécution de 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.