Modèles de requête

Dernière mise à jour : 2024-01-30
  • Rubriques :
  • Queries
    Afficher plus sur ce sujet
  • Créé pour :
  • User
    Developer

Adobe Experience Platform Query Service 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 Query Service.

Conditions préalables

Vous devez avoir l’autorisation Gestion des requêtes activée pour accéder à Query Editor et afficher le tableau de bord des requêtes dans l’interface utilisateur de 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 Query Editor.

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

Consultez la documentation pour obtenir des instructions sur l’utilisation de Query Editor 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 Modèles.

CONSEIL

Lorsque vous enregistrez une requête dans l’éditeur de requêtes, 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. Voir documentation sur les requêtes de planification pour savoir comment exécuter des requêtes sur une cadence personnalisée.

Parcourir les modèles de requête

Dans l’espace de travail Requêtes de l’interface utilisateur de Platform, sélectionnez Modèles 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 Détails, vous pouvez exécuter les actions suivantes :

  • Sélectionner Exécuter comme CTAS pour créer un tableau en sélectionnant les données d’une ou de plusieurs tables existantes. Cette option n’est disponible que si vous avez une requête SELECT.
  • Sélectionner Ajouter un planning pour commencer à modifier votre planning pour votre modèle de requête.
  • Sélectionner Afficher le planning pour accéder au Planifications de l’éditeur de requêtes. Cette vue contient toutes les informations de planification associées à la requête.
  • Sélectionner Supprimer la requête pour supprimer le modèle.
  • Sélectionnez le nom du modèle pour accéder à l’éditeur de requêtes dans lequel 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.

REMARQUE

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 de 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 Query Service. Voir la présentation de l’interface utilisateur, ou le guide de l’API Query Service pour en savoir plus sur les fonctionnalités de Query Service.

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 de Query Editor pour l’interface utilisateur.

Sur cette page