Show Menu
SUJETS×

Query Editor guide de l'utilisateur

Query Editor est un outil interactif fourni par Adobe . Il permet d’écrire, de valider et d’exécuter des requêtes pour les données d’expérience client dans l’interface utilisateur d’Experience Platform. Query Service​Experience Platform Query Editor prend en charge le développement de requête pour l’analyse et l’exploration de données. Il vous permet également d’exécuter des requêtes interactives à des fins de développement, ainsi que des requêtes non interactives pour renseigner les jeux de données dans Experience Platform.
For more information about the concepts and features of Query Service, see the Query Service overview . To learn more about how to navigate the Query Service user interface on Platform, see the Query Service UI overview .

Prise en main

Query EditorEn se connectant à permet une exécution flexible des requêtes, possible uniquement tant que cette connexion est active.Query Service

Connecting to Query Service

Query Editor prend quelques secondes pour initialiser et se connecter à Query Service quand il est ouvert. La console vous indique qu’il est connecté, comme illustré ci-dessous. Si vous tentez d’exécuter une requête avant que l’éditeur ne soit connecté, l’exécution est retardée jusqu’à ce que la connexion soit établie.

How queries are run from Query Editor

Queries executed from Query Editor run interactively. Cela signifie que la requête sera annulée si vous fermez le navigateur ou quittez l’éditeur. Cela concerne également les requêtes visant à générer des jeux de données à partir de sorties de requête.

Query authoring using Query Editor

Using Query Editor, you can write, execute, and save queries for customer experience data. All queries executed in Query Editor, or saved, are available to all users in your organization with access to Query Service.

Accéder aux Query Editor

In the Experience Platform UI, click Queries in the left navigation menu to open the Query Service workspace. Cliquez ensuite sur Créer une requête dans la partie supérieure droite de l’écran pour commencer à écrire des requêtes. This link is available from any of the pages in the Query Service workspace.

Rédaction de requêtes

Query Editor est organisé de façon à rendre l’écriture de requête aussi facile que possible. La capture d’écran ci-dessous présente l’affichage de l’éditeur dans l’interface utilisateur. Le bouton Lire et le champ d’entrée SQL sont mis en surbrillance.
Pour réduire le temps de développement, nous vous recommandons de développer vos requêtes en fixant des limites sur les lignes renvoyées. Par exemple : SELECT fields FROM table WHERE conditions LIMIT number_of_rows . Une fois que vous avez vérifié que votre requête produit la sortie attendue, supprimez les limites et exécutez la requête avec CREATE TABLE tablename AS SELECT , afin de générer un jeu de données avec la sortie.

Writing tools in Query Editor

  • Mise en surbrillance automatique de la syntaxe : facilite la lecture et l’organisation SQL.
  • Saisie automatique de mot-clé SQL : commencez à saisir votre requête, puis utiliser les touches fléchées pour accéder au terme souhaité et appuyez sur Entrée .
  • Saisie automatique de tableau et de champ : commencez à saisir le nom du tableau auquel vous souhaitez appliquer SELECT , puis utilisez les touches fléchées pour accéder au tableau recherché et appuyez sur Entrée . Une fois le tableau sélectionné, la saisie automatique reconnaît les champs de ce tableau.

Détection des erreurs

Query Editor valide automatiquement la requête au fur et à mesure que vous l’écrivez grâce à une validation SQL générique et une validation d’exécution spécifique. Si un trait de soulignement rouge apparaît sous la requête (comme illustré dans l’image ci-dessous), il indique une erreur dans la requête.
Lorsque des erreurs sont détectées, vous pouvez afficher les messages d’erreur spécifiques en survolant le code SQL avec la souris.

Détails de la requête

While you are viewing a query in Query Editor, the Query Details panel provides tools to manage the selected query.
Ce panneau vous permet de générer un jeu de données de sortie directement depuis l’interface utilisateur, de supprimer ou de nommer la requête affichée, et d’afficher le code SQL dans un format facile à copier dans l’onglet Requête SQL . Ce panneau présente également des métadonnées utiles, telles que la dernière fois où la requête a été modifiée et qui l’a modifiée, le cas échéant. Pour générer un jeu de données, cliquez sur Jeu de données de sortie . La boîte de dialogue Jeu de données de sortie s’affiche. Saisissez un nom et une description, puis cliquez sur Exécuter la requête . Le nouveau jeu de données s’affiche dans l’onglet Jeux de données Query Service de l’interface utilisateur de dans Platform.

Enregistrement des requêtes

Query Editor dispose d’une fonction d’enregistrement qui vous permet d’enregistrer une requête et d’y revenir ultérieurement. Pour enregistrer une requête, cliquez sur Enregistrer dans le coin supérieur droit de Query Editor. Avant de pouvoir enregistrer une requête, vous devez lui donner un nom à l’aide du panneau Détails .

Accès aux requêtes précédentes

All queries executed from Query Editor are captured in the Log table. Vous pouvez utiliser la fonctionnalité de recherche dans l’onglet Journal pour rechercher des exécutions de requête. Les requêtes enregistrées sont répertoriées dans l’onglet Parcourir .
Pour plus d’informations, reportez-vous à la Présentation de l’interface utilisateur de Query Service .
Les requêtes non exécutées ne sont pas enregistrées dans le journal. In order for the query to be available in Query Service, it must be run or saved in Query Editor.

Exécution de requête à l’aide de Query Editor

To run a query in Query Editor, you can enter SQL in the editor or load a previous query from the Log or Browse tab, and click Play . L’état de l’exécution de la requête s’affiche dans l’onglet Console ci-dessous et les données de sortie s’affichent dans l’onglet Résultats .

Console

La console fournit des informations sur l’état et le fonctionnement de Query Service. The console displays the connection status to Query Service, query operations being executed, and any error messages that result from those queries.
La console affiche uniquement les erreurs résultant de l’exécution d’une requête. Elle n’affiche pas les erreurs de validation de requête avant l’exécution de la requête.

Résultats de requête

Une fois la requête terminée, les résultats s’affichent dans l’onglet Résultats , en regard de l’onglet Console . Cet affichage indique la sortie tabulaire de votre requête (jusqu’à 100 lignes). Il vous permet de vérifier que votre requête produit la sortie attendue. Pour générer un jeu de données avec votre requête, supprimez les limites sur les lignes renvoyées, puis exécutez la requête avec CREATE TABLE tablename AS SELECT pour générer un jeu de données avec la sortie. Consultez le tutoriel sur la génération de jeux de données pour apprendre à générer un jeu de données à partir des résultats de requête dans Query Editor.

Exécution de requêtes avec une vidéo Query Service didacticiel

La vidéo suivante montre comment exécuter des requêtes dans l'interface d'Adobe Experience Platform et dans un client PSQL. En outre, l'utilisation de propriétés individuelles dans un objet XDM, l'utilisation de fonctions définies par Adobe et l'utilisation de CREATE TABLE AS SELECT (CTAS) sont démontrées.

Étapes suivantes

Now that you know what features are available in Query Editor and how to navigate the application, you can start authoring your own queries directly in Platform. For more information about running SQL queries against datasets in Data Lake, see the guide on running queries . Pour obtenir un exemple de requête SQL avec des données d’Adobe Analytics et d’Adobe Target, consultez la référence d’exemples de requête .