Modèles de requête

Le service de requête Adobe Experience Platform vous permet d’enregistrer et de réutiliser du code SQL sous la forme de modèles de requête. Les modèles économisent des efforts en évitant la répétition de tâches courantes. Vous pouvez partager des modèles au sein de votre organisation et modifier facilement les valeurs de requête sans avoir à accéder au SQL sous-jacent ni à le comprendre.

Ce document fournit les informations nécessaires à la création de modèles de requête dans le service de requête.

Conditions préalables

Vous devez avoir l’autorisation Manage queries activée pour accéder à Query Editor et afficher le tableau de bord des requêtes dans l’interface utilisateur d’Experience Platform. L’autorisation est activée via l’Admin Console d’Adobe. Contactez l’administrateur ou administratrice de votre organisation si vous ne disposez pas des privilèges d’administrateur pour activer cette autorisation. Consultez la documentation sur le contrôle d’accès pour des instructions complètes sur l’ajout d’autorisations via Admin Console.

Créer un modèle de requête

Vous pouvez créer des modèles de requête par le biais de deux méthodes, en adressant une requête POST au point d’entrée query-templates de l’API Query Service, ou en écrivant, en nommant et en enregistrant une requête via le requêteur.

Utiliser le requêteur pour créer et enregistrer une requête en tant que modèle

Consultez la documentation pour obtenir des instructions sur l’utilisation du requêteur pour écrire et enregistrer des requêtes. Une fois que vous avez nommé et enregistré votre requête, elle peut être réutilisée en tant que modèle de requête à partir de l’onglet Templates .

Création d’un modèle à partir d’un accélérateur de Distiller de données create-from-accelerator

Les accélérateurs de Distiller de données sont en lecture seule. Pour modifier un accélérateur, créez un modèle modifiable à partir de celui-ci dans le Query Editor.

Ouvrez un accélérateur, puis sélectionnez Create custom template pour cloner le code SQL. Enregistrez le modèle pour l’ajouter à l’onglet Templates . Le modèle cloné est entièrement modifiable et peut être exécuté, planifié ou modifié selon les besoins.

Consultez le guide Accélérateurs de Distiller de données pour obtenir des instructions détaillées.

TIP
Lorsque vous enregistrez une requête dans le Query Editor, un message de confirmation s’affiche pour vous informer de la réussite de l’action. Ce message contextuel contient un lien qui permet d'accéder facilement à l'espace de travail de planification des requêtes. Consultez la documentation sur la planification des requêtes pour savoir comment exécuter des requêtes à une cadence personnalisée.

Parcourir les modèles de requête browse

Dans l’espace de travail Requêtes de l’interface utilisateur d’Experience Platform, sélectionnez Templates pour afficher la liste des requêtes enregistrées disponibles.

Espace de travail des requêtes avec l’onglet Modèles mis en surbrillance.

Pour trouver les informations de modèle pertinentes, sélectionnez un modèle de requête dans la liste disponible afin d’ouvrir le panneau de détails.

Panneau de détails de l’espace de travail des requêtes avec l’identifiant de requête en surbrillance.

Dans le panneau des détails, vous pouvez exécuter les actions suivantes :

  • Sélectionnez Run as CTAS pour créer une table en sélectionnant les données d'une ou de plusieurs tables existantes. Cette option n’est disponible que si vous disposez d’une requête SELECT.
  • Sélectionnez Add schedule pour commencer à modifier le planning de votre modèle de requête.
  • Sélectionnez View schedule pour accéder à l’onglet Schedules de Query Editor. Cette vue contient toutes les informations de planification associées à la requête.
  • Sélectionnez Delete query pour supprimer le modèle.
  • Sélectionnez le nom du modèle pour accéder à Query Editor où le code SQL est prérenseigné pour modification.

Utiliser l’API Query Service pour créer un modèle

Consultez la documentation pour obtenir des instructions sur comment créer un modèle de requête à l’aide de l’API Query Service. Les détails d’un nouveau modèle de requête créé sont contenus dans le corps de la réponse.

NOTE
Les modèles créés à l’aide de l’API sont également visibles dans l’onglet Modèles de Query Service de l’interface utilisateur d’Experience Platform .

Étapes suivantes

En lisant ce document, vous avez maintenant une meilleure compréhension de la manière de créer des modèles de requête dans le service de requête. Voir la présentation de l’interface utilisateur, ou le guide de l’API Query Service pour en savoir plus sur les fonctionnalités du service de requête.

Voir le guide de point de d’entrée des requêtes planifiées pour savoir comment planifier des requêtes à l’aide de l’API, ou le guide du requêteur pour l’interface d’utilisation.

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