Documentation Experience Platform Guide de Query Service

Plannings de requête

Dernière mise à jour : 4 avril 2025

Rubriques :
Requêtes

Créé pour :

Utilisateur ou utilisatrice
Développeur

Vous pouvez automatiser les exécutions de requête en créant des plannings de requête. Les requêtes planifiées s’exécutent à 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 Query Editor.

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 le statut de toutes les tâches de requête planifiées via l’interface utilisateur. Sur l’onglet Requêtes planifiées vous pouvez trouver des informations importantes sur les exécutions de vos requêtes et vous abonner aux alertes. Les informations disponibles incluent le statut, les détails du planning et les messages/codes 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

Pour planifier une requête, sélectionnez un modèle de requête dans l’onglet Modèles ou dans la colonne Modèle de l’onglet Requêtes planifiées. La sélection du nom du modèle vous permet d’accéder au Query Editor.

Si vous accédez à une requête enregistrée à partir du Query Editor, vous pouvez créer un planning pour la requête ou afficher le planning de la requête à partir du panneau des détails.

TIP

Sélectionnez Afficher le planning pour accéder à l’espace de travail des plannings et afficher en un coup d’œil les exécutions de requête planifiées.

Query Editor avec les options Afficher le planning et Ajouter un planning mises en surbrillance.

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

Vous pouvez également sélectionner l’onglet Plannings 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 une liste de toutes les 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.

Ajouter les détails du planning

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

IMPORTANT

L’interface utilisateur du planificateur de requêtes ne prend pas en charge la planification indéfinie ou permanente. Une date de fin doit être spécifiée. Il n’existe pas de limite supérieure pour la date de fin.

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

Périodicité de requête planifiée

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 le jeu de données

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 d’insérer des données dans ce jeu de données. Enfin, indiquez 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 du planning 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 à un jeu de données existant suivi de l’icône du jeu de données ( ).

Le panneau Détails du planning avec les détails du jeu de données et Ajouter 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.

Les requêtes en quarantaine en cas d’échec continu

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

Espace de travail des plannings de requête avec Query Quarantine en surbrillance et Oui sélectionné.

Une fois qu’une requête est inscrite à 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 mise 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 à la fonction de quarantaine à partir des actions intégrées de l’onglet Requêtes planifiées. Pour plus d’informations, consultez la documentation surveiller les requêtes.

Définir des alertes pour le statut d’une requête planifiée

Vous pouvez également vous abonner aux alertes de requêtes dans le cadre des paramètres de vos requêtes planifiées. Vous pouvez configurer vos paramètres pour recevoir des notifications pour diverses situations. Les alertes peuvent être définies pour un statut mis en quarantaine, des retards dans le traitement des requêtes ou un changement de statut 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 pop-up ou d’e-mails. Cochez la case pour vous abonner aux alertes concernant ce statut de requête planifiée.

Panneau Détails du planning avec les options d’alerte mises 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 exécution de requête planifiée se termine avec succès, indiquant 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 ne s’exécute pas correctement. Cela vous aide à identifier et à résoudre les problèmes rapidement.

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 fonction de quarantaine, toute requête planifiée qui échoue dix exécutions consécutives passe automatiquement à l’état En quarantaine. Une requête en quarantaine nécessite ensuite votre intervention avant que d’autres exécutions ne puissent avoir lieu. Remarque : les requêtes doivent être inscrites à 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 terminer ni échouer. Le comportement par défaut définit une alerte pendant 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 des requêtes, vous devez définir le délai souhaité en minutes dans l’interface utilisateur d’Experience Platform. Saisissez la durée en minutes. Le délai maximal est de 24 heures (1 440 minutes).

Pour obtenir un aperçu des alertes dans Adobe Experience Platform, y compris la structure de la définition des règles d’alerte, reportez-vous à la présentation des alertes. Pour obtenir des conseils 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éfinition des paramètres d’une requête paramétrée planifiée

Si vous créez une requête planifiée pour une requête paramétrée, vous devez maintenant définir les valeurs de paramètre 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 planning, sélectionnez Enregistrer pour créer un planning. Vous revenez sur l’onglet Plannings 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

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

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

Vous pouvez également afficher la liste des exécutions planifiées d’un modèle de requête en accédant à l’onglet Requêtes planifiées et en sélectionnant un nom de modèle dans la liste disponible.

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

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

Heures de calcul au niveau de la tâche

Effectuez le suivi des heures de calcul consommées au niveau de l’exécution des requêtes pour vos requêtes par lots CTAS/ITAS. Cette fonctionnalité offre des informations sur l’utilisation du calcul, ce qui vous permet d’optimiser l’allocation des ressources et d’améliorer les performances des requêtes.

AVAILABILITY

La fonctionnalité Heures de calcul est réservée aux utilisateurs qui ont acheté le SKU de Data Distiller. Pour plus d’informations, contactez votre représentant Adobe.

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

Le tableau suivant fournit des descriptions de chaque colonne disponible dans la section détails qui répertorie les exécutions de requête planifiées.

Titre de colonne

Description

ID d’exécution de requête

Affiche un identifiant unique pour chaque exécution de requête, ce qui vous permet de suivre et de référencer les exécutions individuelles de vos requêtes planifiées.

Début de l’exécution de la requête

Indique la date et l’heure de début de l’exécution de la requête afin de vous aider à surveiller le début de chaque exécution.

Exécution de la requête terminée

Affiche la date et l’heure d’achèvement de l’exécution de la requête, afin de fournir à insight la durée et le statut d’exécution.

Statut

Affiche le statut actuel de l’exécution de la requête, tel que Completed, Running, ou Failed, pour évaluer le résultat rapidement.

Jeux de données

Répertorie les jeux de données utilisés dans l’exécution de la requête afin d’indiquer les sources de données impliquées dans l’exécution.

Heures de calcul

Affiche le temps de calcul utilisé pour chaque exécution de requête, mesuré en heures. Cela permet de suivre l’utilisation des ressources et d’optimiser les performances des requêtes.

NOTE

Les données des heures de calcul sont disponibles à partir du 08/15/2024. Les données antérieures à cette date apparaissent comme « Non disponibles ».

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

Sélectionnez un ID 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 répartition complète des informations disponibles dans la présentation de l’exécution des requêtes, consultez la documentation sur la 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 d’entrée d’exécution de requête planifiée.

Activation, désactivation ou suppression d’un planning

Vous pouvez activer, désactiver ou supprimer un planning 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 Plannings de la requête de votre choix, vous devez sélectionner le nom d’un modèle de requête dans l’onglet Modèles ou Requêtes planifiées. Cette action permet d’accéder à l’éditeur de requêtes pour cette requête. Dans le Query Editor, sélectionnez Plannings pour accéder à l’espace de travail des plannings.

Sélectionnez un planning dans les lignes des plannings disponibles pour remplir le panneau des détails. Utilisez le bouton (bascule) pour désactiver (ou activer) la requête planifiée.

Supprimer les 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 mis en surbrillance.

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

Boîte de dialogue de confirmation Désactiver le planning.

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

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

L’onglet Requêtes planifiées propose é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 suppression ou la désactivation d’une requête planifiée via l’onglet Requêtes planifiées , consultez le guide surveiller les requêtes planifiées.

recommendation-more-help