Query Editor Benutzerhandbuch

Query Editor ist ein interaktives Tool von Adobe Experience Platform Query Service, mit dem Sie Abfragen für Kundenerlebnisdaten in der Experience Platform Benutzeroberfläche schreiben, validieren und ausführen können. Query Editor unterstützt die Entwicklung von Abfragen für die Analyse und Datenforschung und ermöglicht Ihnen, interaktive Abfragen zu Entwicklungszwecken sowie nicht interaktive Abfragen zum Ausfüllen von Datensätzen in auszuführen 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.

Erste Schritte

Query Editor ermöglicht eine flexible Ausführung von Abfragen durch Verbinden mit Query Serviceund Abfragen werden nur ausgeführt, wenn diese Verbindung aktiv ist.

Connecting to Query Service

Query Editor Es dauert einige Sekunden, bis das Programm initialisiert und eine Verbindung hergestellt wird, Query Service wenn es geöffnet wird. Die Konsole gibt an, ob eine Verbindung besteht (siehe unten). Wenn Sie versuchen, eine Abfrage auszuführen, bevor der Editor eine Verbindung hergestellt hat, wird die Ausführung verzögert, bis die Verbindung hergestellt ist.

Bild

Ausführung von Abfragen Query Editor

Abfragen, die interaktiv ausgeführt Query Editor werden. Das bedeutet, dass die Abfrage abgebrochen wird, wenn Sie den Browser schließen oder wegnavigieren. Dies gilt auch für Abfragen, die zum Generieren von Datensätzen aus Abfrageausgaben vorgenommen werden.

Erstellen von Abfragen mit 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.

Zugreifen auf Query Editor

In the Experience Platform UI, click Queries in the left navigation menu to open the Query Service workspace. Klicken Sie dann oben rechts im Bildschirm auf Abfrage erstellen, um Abfragen zu schreiben. This link is available from any of the pages in the Query Service workspace.

Bild

Schreiben von Abfragen

Der Abfrage-Editor ist so organisiert, dass das Schreiben von Abfragen so einfach wie möglich ist. Der folgende Screenshot zeigt, wie der Editor in der Benutzeroberfläche angezeigt wird, wobei die Schaltfläche Abspielen und das SQL-Eingabefeld hervorgehoben sind.

Bild

Um Ihre Entwicklungszeit zu minimieren, sollten Sie Ihre Abfragen mit Begrenzungen für die zurückgegebenen Zeilen entwickeln. Beispiel: SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Nachdem Sie überprüft haben, ob Ihre Abfrage die erwartete Ausgabe erzeugt, entfernen Sie die Begrenzungen und führen Sie die Abfrage mit CREATE TABLE tablename AS SELECT aus, um einen Datensatz mit der Ausgabe zu generieren.

Schreiben von Werkzeugen in Query Editor

  • Automatische Syntaxhervorhebung: Erleichtert das Lesen und Organisieren von SQL.

Bild

  • SQL-Schlüsselwort automatisch vervollständigen: Beginnen Sie mit der Eingabe Ihrer Abfrage, navigieren Sie mit den Pfeiltasten zum gewünschten Begriff und drücken Sie die Eingabetaste.

Bild

  • Tabelle und Felder automatisch vervollständigen: Beginnen Sie mit der Eingabe des Tabellennamens für den SELECT-Vorgang, navigieren Sie mit den Pfeiltasten zur gewünschten Tabelle und drücken Sie die Eingabetaste. Sobald eine Tabelle ausgewählt ist, erkennt das automatische Vervollständigung die Felder in dieser Tabelle.

Bild

Fehlererkennung

Query Editor überprüft eine Abfrage beim Schreiben automatisch, wobei eine generische SQL-Überprüfung und eine spezifische Ausführungsüberprüfung bereitgestellt werden. Wenn eine rote Unterstreichung unter der Abfrage angezeigt wird (wie in der Abbildung unten dargestellt), handelt es sich um einen Fehler in der Abfrage.

Bild

Wenn Fehler erkannt werden, können Sie die spezifischen Fehlermeldungen anzeigen, indem Sie den Mauszeiger über den SQL-Code bewegen.

Bild

Details zur Abfrage

While you are viewing a query in Query Editor, the Query Details panel provides tools to manage the selected query.

Bild

In diesem Bedienfeld können Sie ein Ausgabedatensatz direkt über die Benutzeroberfläche generieren, die angezeigte Abfrage löschen oder benennen und den SQL-Code in einem einfach zu kopierenden Format auf der Registerkarte SQL-Abfrage anzeigen. In diesem Bedienfeld werden außerdem nützliche Metadaten angezeigt, z. B. das letzte Mal, dass die Abfrage geändert wurde und wer sie ggf. geändert hat. Klicken Sie auf Ausgabedatensatz, um einen Datensatz zu erstellen. Das Dialogfeld Ausgabedatensatz wird angezeigt. Geben Sie einen Namen und eine Beschreibung ein und klicken Sie dann auf Abfrage ausführen. The new dataset is displayed in the Datasets tab on the Query Service user interface on Platform.

Speichern von Abfragen

Query Editor bietet eine Speicherfunktion, mit der Sie eine Abfrage speichern und später daran arbeiten können. To save a query, click Save in the top right corner of Query Editor. Bevor eine Abfrage gespeichert werden kann, muss über das Bedienfeld Details zur Abfrage ein Name für die Abfrage angegeben werden.

Auffinden früherer Abfragen

All queries executed from Query Editor are captured in the Log table. Sie können die Suchfunktion auf der Registerkarte Protokoll verwenden, um Abfrageausführungen zu finden. Gespeicherte Abfragen werden auf der Registerkarte Durchsuchen angezeigt.

Weitere Informationen finden Sie in der Übersicht über die Query Service-Benutzeroberfläche.

Hinweis

Nicht ausgeführte Abfragen werden nicht im Protokoll gespeichert. In order for the query to be available in Query Service, it must be run or saved in Query Editor.

Ausführen von Abfragen mit dem Abfrage-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. Der Ausführungsstatus der Abfrage wird auf der Registerkarte Konsole angezeigt und die Ausgabedaten werden auf der Registerkarte Ergebnisse angezeigt.

Konsole

Die Konsole bietet Informationen zum Status und zum Betrieb von Query Service. The console displays the connection status to Query Service, query operations being executed, and any error messages that result from those queries.

Bild

Hinweis

Die Konsole zeigt nur Fehler an, die beim Ausführen einer Abfrage aufgetreten sind. Es werden keine Fehler bei der Abfragevalidierung angezeigt, bevor eine Abfrage ausgeführt wird.

Abfrageergebnisse

Nach Abschluss einer Abfrage werden die Ergebnisse auf der Registerkarte Ergebnisse neben der Registerkarte Konsole angezeigt. Diese Ansicht zeigt die tabellarische Ausgabe Ihrer Abfrage mit bis zu 100 Zeilen an. Mit dieser Ansicht können Sie überprüfen, ob Ihre Abfrage die erwartete Ausgabe erzeugt. Um einen Datensatz mit Ihrer Abfrage zu generieren, entfernen Sie Begrenzungen für zurückgegebene Zeilen und führen Sie die Abfrage mit CREATE TABLE tablename AS SELECT aus, um einen Datensatz mit der Ausgabe zu generieren. See the generating datasets tutorial for instructions on how to generate a dataset from query results in Query Editor.

Bild

Abfragen mit Query Service Lernvideo ausführen

Das folgende Video zeigt, wie Abfragen auf der Adobe Experience Platform-Oberfläche und in einem PSQL-Client ausgeführt werden. Darüber hinaus werden die Verwendung einzelner Eigenschaften in einem XDM-Objekt, die Verwendung von Adobe-definierten Funktionen und die Verwendung von CREATE TABLE AS SELECT (CTAS) demonstriert.

Nächste Schritte

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. Beispiel-SQL-Abfragen für die Arbeit mit Adobe Analytics- und Adobe Target-Daten finden Sie in der Referenz für Beispielabfragen.

Auf dieser Seite