Guide de l’interface utilisateur de Query Service

Dernière mise à jour : 2023-04-12
  • Rubriques :
  • Queries
    Afficher plus sur ce sujet
  • Créé pour :
  • Developer
    User
    Admin
    Leader

Adobe Experience Platform Query Service fournit une interface utilisateur qui peut être utilisée pour écrire et exécuter des requêtes, afficher des requêtes précédemment exécutées et accéder aux requêtes enregistrées par les utilisateurs de votre entreprise. Pour accéder à l’interface utilisateur d’Adobe Experience Platform, sélectionnez Requêtes dans le volet de navigation de gauche.

Query Editor

Le Query Editor vous permet d’écrire et d’exécuter des requêtes sans utiliser de client externe. Cliquez sur Créer une requête pour ouvrir le Query Editor et créer une requête. Vous pouvez également accéder au Query Editor en sélectionnant une requête dans les onglets Journal ou Modèles. La sélection d’une requête exécutée ou enregistrée précédemment déclenche l’ouverture du Query Editor et affiche le code SQL de la requête sélectionnée.

Le tableau de bord Requêtes avec l’option Créer une requête mise en surbrillance.

Query Editor offre un espace d’édition dans lequel vous pouvez commencer à saisir une requête. Au fur et à mesure que vous tapez, l’éditeur complète automatiquement les mots réservés SQL, les tables et les noms des champs dans les tables. Une fois votre requête rédigée, cliquez sur le bouton Lire pour exécuter la requête. L’onglet Console situé sous l’éditeur indique ce que fait actuellement Query Service, indiquant le moment où une requête a été renvoyée. L’onglet Résultat, en regard de la Console, affiche les résultats de la requête. Pour plus d’informations sur l’utilisation de Query Editor, reportez-vous au Guide d’utilisation de Query Editor.

Un zoom sur le Query Editor.

Requêtes planifiées

Les requêtes qui ont déjà été enregistrées en tant que modèle peuvent être planifiées pour une exécution régulière. Lors de la planification d’une requête, vous pouvez choisir la fréquence des exécutions, la date de début et de fin, le jour de la semaine où la requête planifiée s’exécute, ainsi que le jeu de données vers lequel exporter la requête. Les plannings de requête sont définis à l’aide de Query Editor.

Pour savoir comment planifier une requête via l’interface utilisateur, reportez-vous à la section guide des requêtes planifiées. 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.

Une fois qu’une requête a été planifiée, elle apparaît dans la liste des requêtes planifiées de la variable Requêtes planifiées . Vous trouverez des détails complets sur la requête, les exécutions, le créateur et les minutages en sélectionnant une requête planifiée dans la liste.

L’espace de travail Requêtes avec l’onglet Requêtes planifiées mis en surbrillance et qui affiche des lignes de plannings de requête.

Colonne Description
Nom Le champ nom correspond soit au nom du modèle, soit aux premiers caractères de votre requête SQL. Toute requête créée à l’aide de l’interface utilisateur avec le Query Editor est nommée dès le départ. Si la requête a été créée via l’API, le nom de la requête est un extrait du SQL initial utilisé pour créer la requête.
Modèle Nom du modèle de la requête. Sélectionnez un nom de modèle pour accéder à l’éditeur de requêtes. Le modèle de requête est affiché dans l’éditeur de requêtes pour plus de commodité. S’il n’existe aucun nom de modèle, la ligne est marquée d’un trait d’union et il n’est pas possible d’effectuer une redirection vers l’éditeur de requêtes pour afficher la requête.
SQL Fragment de la requête SQL.
Fréquence d’exécution Il s’agit de la cadence d’exécution de votre requête. Les valeurs disponibles sont Run once et Scheduled. Les requêtes peuvent être filtrées en fonction de leur fréquence d’exécution.
Créé par Nom de la personne qui a créé la requête.
Créé La date et l’heure de création de la requête, au format UTC.
La date et l’heure de la dernière exécution La date et l’heure les plus récentes auxquelles la requête a été exécutée. Cette colonne met en évidence si une requête a été exécutée conformément à son planning actuel.
Statut de la dernière exécution Statut de la dernière exécution de la requête. Les trois valeurs de statut sont les suivantes : successful failed ou in progress.

Consultez la documentation pour plus d’informations sur la manière de Surveillance des requêtes via l’interface utilisateur de Query Service.

Modèles

L’onglet Modèles affiche les requêtes enregistrées par les utilisateurs de votre organisation. Il est utile de les voir comme des projets de requêtes, car les requêtes enregistrées ici peuvent encore être en cours de construction. Les requêtes affichées dans l’onglet Modèles s’affichent également sous la forme de requêtes exécutées dans l’onglet Journal si elles ont été exécutées par Query Service.

Un zoom dans l’onglet Modèles du tableau de bord Requêtes qui affiche plusieurs requêtes enregistrées.

Colonne Description
Nom Le nom du champ est soit le nom de la requête donné par l’utilisateur, soit les premiers caractères de votre requête SQL. Toute requête créée à l’aide de l’interface utilisateur avec le Query Editor est nommée dès le départ. Si la requête a été créée via l’API, le nom de la requête est un extrait du SQL initial utilisé pour créer la requête. Vous pouvez sélectionner le nom de la requête à ouvrir dans le Query Editor. Vous pouvez également utiliser la barre de recherche pour rechercher le nom d’une requête. Les recherches sont sensibles à la casse.
SQL Premiers caractères de la requête SQL. Placez le pointeur de la souris sur le code pour afficher la requête entière.
Modifié par Dernier utilisateur à avoir modifié la requête. Tout utilisateur de votre organisation ayant accès à Query Service peut modifier les requêtes.
Dernière modification Date et heure de la dernière modification apportée à la requête, dans le fuseau horaire du navigateur.

Voir modèles de requête documentation pour plus d’informations sur les modèles dans l’interface utilisateur de Platform.

Journal

L’onglet Journal fournit une liste de requêtes qui ont été exécutées précédemment. Par défaut, le journal répertorie les requêtes dans l’ordre chronologique décroissant.

Un zoom de l’onglet Journal du tableau de bord Requêtes qui affiche une liste des requêtes dans l’ordre chronologique inverse.

Colonne Description
Nom Nom de la requête, composé des premiers caractères de la requête SQL. Sélectionnez le nom du modèle à ouvrir. Détails du journal de requête pour cette exécution. Vous pouvez utiliser la barre de recherche pour effectuer une recherche sur le nom d’une requête. Les recherches sont sensibles à la casse.
Heure de début Heure à laquelle la requête a été exécutée.
Durée complète Heure à laquelle la requête s’est exécutée.
Statut Statut actuel de la requête.
Jeu de données Jeu de données d’entrée utilisé par la requête. Cliquez sur le jeu de données pour accéder à l’écran des détails du jeu de données d’entrée.
Client Client utilisé pour la requête.
Créé par Nom de la personne qui a créé la requête.

!![Note]
Sélectionnez l’icône de crayon (Une icône en forme de crayon.) de n’importe quelle ligne du journal de requête pour accéder à la variable Query Editor. La requête est prérenseignée pour faciliter la modification.

Voir documentation sur les journaux de requête pour plus d’informations sur les fichiers journaux générés automatiquement par un événement de requête.

Informations d’identification

L’onglet Informations d’identification affiche vos informations d’identification arrivant à expiration et les autres. Pour plus d’informations sur l’utilisation de ces informations d’identification pour établir une connexion avec des clients externes, consultez le guide des informations d’identification.

Le tableau de bord Requêtes avec l’onglet Informations d’identification mis en surbrillance.

Étapes suivantes

Maintenant que vous connaissez l’interface utilisateur de Query Service sur Platform, vous pouvez accéder à Query Editor pour créer vos propres projets de requêtes à partager avec d’autres utilisateurs de votre organisation. Pour plus d’informations sur la création et l’exécution de requêtes dans Query Editor, consultez le guide d’utilisation de Query Editor .

Sur cette page