Guide de l’interface utilisateur du Query Editor

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 ServiceExperience 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.

Pour plus d’informations sur les concepts et les fonctionnalités de Query Service, reportez-vous à la section Présentation de Query Service. Pour en savoir plus sur la navigation dans l’interface utilisateur de Query Service sur Platform, reportez-vous à la section Présentation de l’interface utilisateur de Query Service.

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

Connexion à Query Service

Query Editor prend quelques secondes pour l’initialisation et la connexion à Query Service lorsqu’il est ouvert. La console vous indique quand elle est connectée, 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.

Image

Exécution des requêtes à partir de Query Editor

Requêtes exécutées depuis Query Editor s’exécuter de manière interactive. 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.

Création de requêtes à l’aide de Query Editor

Utilisation Query Editor, vous pouvez écrire, exécuter et enregistrer des requêtes pour les données d’expérience client. Toutes les requêtes exécutées ou enregistrées dans Query Editor sont disponibles pour tous les utilisateurs de votre entreprise ayant accès à Query Service.

Accéder à Query Editor

Dans le Experience Platform Interface utilisateur, sélectionnez Requêtes dans le menu de navigation de gauche pour ouvrir la Query Service workspace. Ensuite, sélectionnez Créer une requête en haut à droite de l’écran pour commencer à écrire des requêtes. Ce lien est disponible à partir de n’importe quelle page de la Query Service workspace.

Image

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.

Image

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.

Outils d’écriture dans Query Editor

  • Mise en surbrillance automatique de la syntaxe : facilite la lecture et l’organisation SQL.

Image

  • Saisie automatique des mots-clés SQL : Commencez à saisir votre requête, puis utilisez les touches fléchées pour accéder au terme souhaité et appuyez sur Entrée.

Image

  • 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.

Interface de ligne de commande de l’éditeur de requêtes qui affiche les suggestions de liste déroulante.

Bascule de configuration de l’interface utilisateur à saisie automatique

Le Query Editor suggère automatiquement des mots-clés SQL potentiels ainsi que des détails de tableau ou de colonne pour la requête au fur et à mesure que vous l’écrivez. La fonction de saisie automatique est activée par défaut et peut être désactivée ou activée à tout moment en sélectionnant l’option Saisie automatique de la syntaxe basculez sur le coin supérieur droit de l’éditeur de requêtes.

Le paramètre de configuration de saisie automatique est défini par utilisateur et mémorisé pour les connexions consécutives de cet utilisateur.

Éditeur de requêtes avec la bascule de saisie automatique de la syntaxe mise en surbrillance.

La désactivation de cette fonction empêche le traitement de plusieurs commandes de métadonnées et fournit des recommandations qui profitent généralement à la vitesse de l’auteur lors de la modification des requêtes.

Lorsque vous utilisez le bouton d’activation/désactivation pour activer la fonction de saisie semi-automatique, les suggestions recommandées pour les noms de tableau et de colonne ainsi que les mots-clés SQL deviennent disponibles après une courte pause. Un message de réussite dans la console sous l’éditeur de requêtes indique que la fonctionnalité est principale.

Si vous désactivez la fonction de saisie semi-automatique, une actualisation de page est nécessaire pour que cette dernière soit appliquée. Une boîte de dialogue de confirmation s’affiche avec trois options lorsque vous désactivez la fonction Saisie automatique de la syntaxe bascule :

  • Annuler
  • Enregistrer les modifications et actualiser
  • Actualiser sans enregistrer les modifications
IMPORTANT

Si vous écrivez ou modifiez une requête lors de la désactivation de cette fonction, vous devez enregistrer les modifications apportées à votre requête avant d’actualiser la page, sinon toute progression sera perdue.

Boîte de dialogue de confirmation permettant de désactiver la fonction de saisie semi-automatique.

Sélectionnez l’option appropriée pour désactiver la fonction de saisie semi-automatique.

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.

Image

Lorsque des erreurs sont détectées, vous pouvez afficher les messages d’erreur spécifiques en survolant le code SQL avec la souris.

Image

Détails de la requête

Lorsque vous affichez une requête dans Query Editor, la variable Détails de la requête fournit des outils pour gérer la requête sélectionnée.

Image

Ce panneau vous permet de générer un jeu de données de sortie directement à partir de l’interface utilisateur, de supprimer ou de nommer la requête affichée, et d’ajouter un planning à la requête.

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, sélectionnez 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 sélectionnez Exécuter la requête. Le nouveau jeu de données s’affiche dans l’onglet Jeux de donnéesQuery Service de l’interface utilisateur de dans Platform.

Requêtes planifiées

IMPORTANT

Vous trouverez ci-dessous une liste des limites relatives aux requêtes planifiées lors de l’utilisation de Query Editor. Elles ne s’appliquent pas au Query Service API :
Vous pouvez uniquement ajouter un planning à une requête qui a déjà été créée, enregistrée et exécutée.
You cannot ajoutez un planning à une requête paramétrée.
Requêtes planifiées cannot contiennent un bloc anonyme.

Pour ajouter un planning à une requête, sélectionnez Ajouter un planning.

Image

Le Détails de la planification s’affiche. Sur cette page, vous pouvez choisir la fréquence de la requête planifiée, les dates d’exécution de la requête planifiée, ainsi que le jeu de données vers lequel exporter la requête.

Image

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ée. Notez que l’heure sélectionnée est indiquée dans UTC, et non votre fuseau horaire local.
  • Hebdomadaire: La requête sélectionnée s’exécute les jours de la semaine, de l’heure et de la période que vous avez sélectionnée. Notez que l’heure sélectionnée est indiquée dans UTC, et non 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ée. Notez que l’heure sélectionnée est indiquée dans UTC, et non 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ée. Notez que l’heure sélectionnée est indiquée dans UTC, et non votre fuseau horaire local.

Pour le jeu de données, vous avez la possibilité d’utiliser un jeu de données existant ou de créer un nouveau jeu de données.

IMPORTANT

Puisque vous utilisez un jeu de données existant ou que vous en créez, vous procédez comme suit : not Vous devez inclure : 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. Y compris l’une ou l’autre INSERT INTO ou CREATE TABLE AS SELECT dans le cadre de vos requêtes planifiées, une erreur se produira.

Après avoir confirmé tous ces détails, sélectionnez Enregistrer pour créer un planning.

La page des détails de la requête réapparaît. Elle affiche désormais les détails du nouveau planning, y compris l’identifiant du planning, le planning lui-même et le jeu de données de sortie du planning. Vous pouvez utiliser l’ID de planning pour rechercher plus d’informations sur les exécutions de la requête planifiée elle-même. Pour en savoir plus, veuillez lire le guide des points de fin d’exécution de requête planifiée.

REMARQUE

Vous pouvez uniquement planifier one modèle de requête à l’aide de l’interface utilisateur. Si vous souhaitez ajouter des plannings supplémentaires à un modèle de requête, vous devez utiliser l’API . Si un planning a déjà été ajouté à l’aide de l’API, vous serez not peuvent ajouter des plannings supplémentaires à l’aide de l’interface utilisateur. Si plusieurs planifications sont déjà jointes à un modèle de requête, seule la planification la plus ancienne s’affiche. Pour savoir comment ajouter des plannings à l’aide de l’API, veuillez lire le guide de point de terminaison des requêtes planifiées.

En outre, vous devez actualiser la page si vous souhaitez vous assurer que vous disposez de l’état le plus récent pour le planning que vous consultez.

Suppression d’un planning

Vous pouvez supprimer un planning en sélectionnant Suppression d’un planning.

Image

IMPORTANT

Si vous souhaitez supprimer un planning pour une requête, vous devez d’abord désactiver ce planning.

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, sélectionnez 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.

REMARQUE

Les requêtes nommées et enregistrées dans à l’aide de l’éditeur de requêtes sont disponibles sous forme de modèles dans le tableau de bord Requête . Parcourir . Voir documentation sur les modèles pour plus d’informations.

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

Toutes les requêtes exécutées depuis Query Editor sont capturés dans le tableau Journal. 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.

REMARQUE

Les requêtes non exécutées ne sont pas enregistrées dans le journal. Pour que la requête soit disponible dans Query Service, il doit être exécuté ou enregistré dans Query Editor.

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

Pour exécuter une requête dans Query Editor, vous pouvez saisir du code SQL dans l’éditeur ou charger une requête précédente à partir de la fonction Journal ou Parcourir et sélectionnez 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. La console affiche l’état de la connexion à Query Service, les opérations de requête en cours d’exécution et les messages d’erreur qui en résultent.

Image

REMARQUE

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 la variable 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.

Image

Exécuter des requêtes avec Query Service tutoriel vidéo

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

Étapes suivantes

Maintenant que vous savez quelles fonctionnalités sont disponibles dans Query Editor et comment naviguer dans l’application, vous pouvez commencer à créer vos propres requêtes directement dans Platform. Pour plus d’informations sur l’exécution de requêtes SQL par rapport à des jeux de données dans Data Lake, reportez-vous au guide sur la exécution de requêtes.

Sur cette page