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.
Toutes les requêtes planifiées sont ajoutées à la liste dans la variable 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. Sur le Requêtes planifiées vous pouvez trouver des informations importantes sur vos exécutions de requête 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. Voir Surveiller le document des requêtes planifiées pour plus d’informations.
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 dans l’une des options suivantes : Modèles ou le Modèle de la colonne 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.
Sélectionner Ajouter un planning pour accéder au page détails du planning.
Vous pouvez également sélectionner la variable Planifications sous le nom de la requête.
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.
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 fréquence et jour de semaine de la requête planifiée run, les dates de début et de fin, le jeu de données vers lequel exporter les résultats et alertes d'état des requêtes.
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électionner Création et ajout dans un nouveau jeu de données pour créer un jeu de données lors de la première exécution d’une requête. 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.
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.
Vous pouvez également sélectionner Ajouter à un jeu de données existant suivi de l’icône du jeu de données (
La variable 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électionner Terminé pour confirmer votre choix.
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 une Quarantiné état. 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.
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 une option sur 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 la fonction Requêtes planifiées . Voir documentation sur les requêtes de contrôle pour plus d’informations.
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.
Le tableau ci-dessous décrit les types d’alerte de requête pris en charge :
startsuccessfailedquarantinedelayPour une vue d’ensemble des alertes dans Adobe Experience Platform, y compris la structure de la définition des règles d’alerte, voir la section aperçu 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, voir Guide de l’interface utilisateur des alertes.
Définir les paramètres d’une requête planifiée planifiée set-parameters
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.
Après avoir confirmé les détails de votre planning, sélectionnez Enregistrer pour créer un planning. 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
De votre modèle Planifications sélectionnez l’ID de planning pour accéder à la liste des exécutions de requête pour votre requête nouvellement planifiée.
Vous pouvez également accéder au Requêtes planifiées et sélectionnez un nom de modèle dans la liste disponible.
La liste des exécutions de requête pour cette requête planifiée s’affiche.
Voir guide de suivi des requêtes planifiées 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.
Sélectionnez une Identifiant d’exécution de requête de la liste pour accéder à la présentation de l’exécution de la requête. Pour une répartition complète des informations disponibles dans la variable 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, voir guide des points de fin d’exécution de requête planifiée.
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 particulière ou dans la variable Requêtes planifiées Workspace qui répertorie toutes les requêtes planifiées.
Pour accéder au Planifications de la requête choisie, vous devez sélectionner le nom d'un modèle de requête parmi les Modèles ou le Requêtes planifiées . L’éditeur de requêtes de cette requête est alors accessible. Dans Query Editor, sélectionnez Planifications pour accéder à l’espace de travail des plannings.
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
Une boîte de dialogue de confirmation s’affiche. Sélectionner Désactiver pour confirmer l’action.
Sélectionnez Supprimer un planning pour supprimer le planning désactivé.
Vous pouvez également utiliser la variable Requêtes planifiées tab propose 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 Activation du planning, Supprimer le planning, et 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, voir la section guide de suivi des requêtes planifiées.