Plannings de requête

Vous pouvez automatiser les exécutions de requêtes en créant des plannings de requête. Les requêtes planifiées s’exécutent sur une cadence personnalisée pour gérer vos données en fonction de la fréquence, de la date et de l’heure. Vous pouvez également choisir un jeu de données de sortie pour vos résultats, si nécessaire. Les requêtes qui ont été enregistrées en tant que modèle peuvent être planifiées à partir de l’éditeur de requêtes.

IMPORTANT
Vous pouvez uniquement ajouter un planning à une requête qui a déjà été créée et enregistrée.

Toutes les requêtes planifiées sont ajoutées à la liste dans l’onglet Requêtes planifiées . Depuis cet espace de travail, vous pouvez surveiller l’état de toutes les tâches de requête planifiées via l’interface utilisateur. Dans l’onglet ​ Requêtes planifiées ​, vous pouvez trouver des informations importantes sur les exécutions de vos requêtes et vous abonner à des alertes. Les informations disponibles incluent l’état, les détails de planification et les codes/messages d’erreur en cas d’échec de l’exécution. Pour plus d’informations, consultez le document Surveiller les requêtes planifiées .

Ce workflow couvre le processus de planification dans l’interface utilisateur de Query Service. Pour savoir comment ajouter des plannings à l’aide de l’API, veuillez lire le guide de point d’entrée des requêtes planifiées.

Créer un planning de requête create-schedule

Pour planifier une requête, sélectionnez un modèle de requête à partir de l’onglet Modèles ou de la colonne Modèle de l’onglet Requêtes planifiées. Lorsque vous sélectionnez le nom du modèle, vous accédez à l’éditeur de requêtes.

Si vous accédez à une requête enregistrée à partir de l’éditeur de requêtes, vous pouvez créer un planning pour la requête ou afficher le planning de la requête à partir du panneau Détails.

TIP
Sélectionnez Afficher la planification pour accéder à l’espace de travail des plannings et afficher les exécutions de requête planifiées en un coup d’oeil.

L’éditeur de requêtes avec Afficher le planning et Ajouter le planning surligné.

Sélectionnez Ajouter un planning pour accéder à la page des détails du planning.

Vous pouvez également sélectionner l’onglet Planifications sous le nom de la requête.

Query Editor avec l’onglet Plannings en surbrillance.

L’espace de travail des plannings s’affiche. L’interface utilisateur affiche la liste des exécutions planifiées auxquelles le modèle est associé. Sélectionnez Ajouter un planning pour créer un planning.

Espace de travail Planning du Query Editor avec l’option Ajouter un planning mise en surbrillance.

Ajout des détails du planning schedule-details

La page Détails du planning s’affiche. Sur cette page, vous pouvez modifier divers détails pour la requête planifiée. Les détails incluent la fréquence et le jour de semaine de l’exécution de la requête planifiée, la date de début et de fin, le jeu de données vers lequel exporter les résultats et les alertes d’état de la requête.

Le panneau Détails du planning est mis en surbrillance.

Fréquence de requête planifiée scheduled-query-frequency

Vous pouvez choisir les options suivantes pour Fréquence  :

  • Horaire  : la requête planifiée s’exécute toutes les heures pour la période que vous avez sélectionnée.
  • Quotidien  : la requête planifiée s’exécute tous les X jours à l’heure et à la période que vous avez sélectionnées. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Hebdomadaire  : la requête sélectionnée sera exécutée aux jours de la semaine, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Mensuel  : la requête sélectionnée s’exécute tous les mois au jour, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Annuel  : la requête sélectionnée s’exécute chaque année au jour, au mois, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.

Fournir des détails sur les jeux de données dataset-details

Gérez les résultats de la requête en ajoutant les données à un jeu de données existant ou en créant un nouveau jeu de données et en y ajoutant les données.

Sélectionnez Créer et ajouter dans un nouveau jeu de données pour créer un jeu de données lorsque vous exécutez une requête pour la première fois. Les exécutions suivantes continuent à insérer des données dans ce jeu de données. Enfin, fournissez un nom et une description pour le jeu de données.

IMPORTANT
Puisque vous utilisez un jeu de données existant ou que vous en créez un nouveau, vous n’avez pas besoin d’inclure INSERT INTO ou CREATE TABLE AS SELECT dans le cadre de la requête, puisque les jeux de données sont déjà définis. L’inclusion de INSERT INTO ou CREATE TABLE AS SELECT dans le cadre de vos requêtes planifiées entraînera une erreur.

Le panneau Détails de la planification avec les détails du jeu de données et les options Créer et ajouter dans un nouveau jeu de données mises en surbrillance.

Vous pouvez également sélectionner Ajouter au jeu de données existant suivi de l’icône du jeu de données ( Icône du jeu de données. ).

Panneau Détails de la planification avec les détails du jeu de données et l’ajout dans le jeu de données existant mis en surbrillance.

La boîte de dialogue Sélectionner le jeu de données de sortie s’affiche.

Ensuite, parcourez les jeux de données existants ou utilisez le champ de recherche pour filtrer les options. Sélectionnez la ligne du jeu de données que vous souhaitez utiliser. Les détails du jeu de données s’affichent dans le panneau de droite. Sélectionnez Terminé pour confirmer votre choix.

La boîte de dialogue Sélectionner le jeu de données de sortie avec le champ de recherche, une ligne de jeu de données et Terminé en surbrillance.

Requêtes de mise en quarantaine en cas d’échec continu quarantine

Lors de la création d’un planning, vous pouvez inscrire votre requête dans la fonctionnalité de quarantaine afin de protéger les ressources système et d’éviter toute interruption potentielle. La fonction de quarantaine identifie et isole automatiquement les requêtes qui échouent à plusieurs reprises en les plaçant dans un état Quarantined. En mettant en quarantaine les requêtes après dix échecs consécutifs, vous pouvez intervenir, examiner et corriger les problèmes avant d’autoriser d’autres exécutions. Cela permet de préserver l’efficacité opérationnelle et l’intégrité des données.

Lespace de travail des planifications de requêtes avec la mise en quarantaine de requête mise en surbrillance et Oui sélectionné.

Une fois qu’une requête est inscrite pour la fonction de quarantaine, vous pouvez vous abonner à des alertes pour ce changement de statut de la requête. Si une requête planifiée n’est pas inscrite en quarantaine, elle n’apparaît pas comme option dans la boîte de dialogue Alertes.

Vous pouvez également inscrire une requête planifiée dans la fonction de quarantaine à partir des actions intégrées de l’onglet Requêtes planifiées . Pour plus d’informations, consultez la documentation sur les requêtes de moniteur .

Définition d’alertes pour un état de requête planifié alerts-for-query-status

Vous pouvez également vous abonner aux alertes de requête dans le cadre des paramètres de requête planifiés. Vous pouvez configurer vos paramètres pour recevoir des notifications dans diverses situations. Les alertes peuvent être définies pour un état en quarantaine, des retards dans le traitement des requêtes ou une modification de l’état de votre requête. Les options d’alerte d’état de requête disponibles incluent le début, la réussite et l’échec. Les alertes peuvent être reçues sous la forme de notifications contextuelles ou d’emails. Cochez la case pour vous abonner à des alertes pour cet état de requête planifiée.

Panneau Détails de la planification avec les options d’alerte en surbrillance.

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. Une fois qu’une requête est inscrite dans la fonctionnalité 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 mise en quarantaine requiert alors votre intervention avant que d’autres exécutions ne puissent avoir lieu. Remarque : les requêtes doivent être inscrites pour la fonction de quarantaine pour que vous puissiez vous abonner aux alertes de quarantaine.
delay
Cette alerte vous avertit en cas de retard dans le résultat d’une exécution de requête planifiée 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é. Le comportement par défaut définit une alerte de 150 minutes après le début du traitement de la requête.
NOTE
Si vous choisissez de définir une alerte Délai d’exécution de requête, vous devez définir le délai souhaité en minutes dans l’interface utilisateur de Platform. Saisissez la durée en minutes. Le délai maximal est de 24 heures (1 440 minutes).

Pour un aperçu des alertes dans Adobe Experience Platform, y compris la structure de la définition des règles d’alerte, consultez la présentation des alertes. Pour plus d’informations sur la gestion des alertes et des règles d’alerte dans l’interface utilisateur de Adobe Experience Platform, consultez le guide de l’interface utilisateur des alertes.

Définir les paramètres d’une requête planifiée planifiée set-parameters

IMPORTANT
La fonctionnalité d’IU de requête paramétrée est actuellement disponible dans une version limitée uniquement et n’est pas disponible pour tous les clients. Si vous n’avez pas accès aux requêtes paramétrées, passez à la section supprimer ou désactiver un planning .

Si vous créez une requête planifiée pour une requête paramétrée, vous devez maintenant définir les valeurs des paramètres pour ces exécutions de requête.

La section Détails du planning du workflow de création du planning avec la section Paramètres de requête mise en surbrillance.

Après avoir confirmé les détails de votre planification, sélectionnez Enregistrer pour créer une planification. Vous revenez alors à l’onglet Planifications de votre modèle. Cet espace de travail affiche les détails du planning nouvellement créé, y compris l’identifiant du planning, le planning lui-même et le jeu de données de sortie du planning.

Afficher les exécutions de requête planifiées scheduled-query-runs

Dans l’onglet Planifications de votre modèle, sélectionnez l’ID de planification pour accéder à la liste des exécutions de requête pour votre requête nouvellement planifiée.

Espace de travail des plannings avec le nouveau planning mis en surbrillance.

Ou bien, pour afficher la liste des exécutions planifiées d’un modèle de requête, accédez à l’onglet Requêtes planifiées et sélectionnez un nom de modèle dans la liste disponible.

Onglet Requêtes planifiées avec un modèle nommé en surbrillance.

La liste des exécutions de requête pour cette requête planifiée s’affiche.

La section des détails de l’espace de travail Requêtes planifiées avec une liste d’exécutions de requête mise en surbrillance pour une requête planifiée.

Pour obtenir des informations complètes sur la manière de surveiller l’état de toutes les tâches de requête via l’interface utilisateur, consultez le guide de surveillance des requêtes planifiées .

Sélectionnez un identifiant d’exécution de requête dans la liste pour accéder à la présentation de l’exécution de requête. Pour obtenir une ventilation complète des informations disponibles sur la présentation de l’exécution de requête, consultez la documentation de surveillance des requêtes planifiées .

Pour surveiller les requêtes planifiées à l’aide de l’API Query Service, consultez le guide des points de terminaison d’exécution de requête planifiés.

Activation, désactivation ou suppression d’une planification delete-schedule

Vous pouvez activer, désactiver ou supprimer une planification dans l’espace de travail des plannings d’une requête spécifique ou dans l’espace de travail ​ Requêtes planifiées qui répertorie toutes les requêtes planifiées.

Pour accéder à l’onglet Planifications de la requête choisie, vous devez sélectionner le nom d’un modèle de requête à partir de l’onglet ​ Modèles ou de l’onglet Requêtes planifiées. L’éditeur de requêtes de cette requête est alors accessible. Dans l’éditeur de requêtes, sélectionnez Planifications pour accéder à l’espace de travail des planifications.

Sélectionnez une planification dans les lignes des plannings disponibles pour remplir le panneau Détails. Utilisez le bouton d’activation/désactivation pour désactiver (ou activer) la requête planifiée.

Suppression de requêtes désactivées

IMPORTANT
Vous devez désactiver le planning avant de pouvoir supprimer un planning pour une requête.

Liste des plannings d’un modèle avec le panneau des détails surligné.

Une boîte de dialogue de confirmation s’affiche. Sélectionnez Désactiver pour confirmer l’action.

Boîte de dialogue de confirmation de la planification de désactivation.

Sélectionnez Supprimer un planning pour supprimer le planning désactivé.

L’espace de travail des plannings avec l’option Supprimer le planning mise en surbrillance.

L’onglet ​ Requêtes planifiées offre également une collection d’actions intégrées pour chaque requête planifiée. Les actions intégrées disponibles sont les suivantes : Désactiver le planning ou Activer le planning, Supprimer le planning et S’abonner aux alertes pour la requête planifiée. Pour obtenir des instructions complètes sur la manière de supprimer ou de désactiver une requête planifiée via l’onglet Requêtes planifiées, consultez le guide de surveillance des requêtes planifiées.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb