Query Editor UI-Handbuch

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.

Weitere Informationen zu Konzepten und Funktionen von Query Service finden Sie unter Übersicht über den Abfrage-Dienst. Weitere Informationen zum Navigieren in der Benutzeroberfläche des Abfrage-Dienstes unter Platform finden Sie unter Übersicht über die Benutzeroberfläche des Abfrage-Dienstes.

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.

Verbindung zu Query Service

Query Editor Es dauert einige Sekunden, bis die Verbindung zum Query Service Öffnen initialisiert 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 von Query Editor

Von Query Editor ausgeführte Abfragen werden interaktiv ausgeführt. 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

Mit Query Editor können Sie Abfragen für Kundenerlebnisdaten schreiben, ausführen und speichern. Alle in Query Editor ausgeführten oder gespeicherten Abfragen stehen allen Benutzern in Ihrem Unternehmen mit Zugriff auf Query Service zur Verfügung.

Zugreifen auf Query Editor

Wählen Sie in der Benutzeroberfläche Experience Platform im linken Navigationsmenü Abfragen aus, um den Arbeitsbereich Query Service zu öffnen. Wählen Sie dann oben rechts im Bildschirm Abfrage erstellen, um Abfragen zu schreiben. Dieser Link ist auf allen Seiten im Arbeitsbereich Query Service verfügbar.

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

Während Sie eine Abfrage in Query Editor anzeigen, bietet das Bedienfeld Abfrage Details Tools zum Verwalten der ausgewählten Abfrage.

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. Um einen Datensatz zu erstellen, wählen Sie Ausgabedatensatz. Das Dialogfeld Ausgabedatensatz wird angezeigt. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie Abfrage ausführen. Der neue Datensatz wird auf der Registerkarte Datensätze der Query Service-Benutzeroberfläche unter Platform angezeigt.

Speichern von Abfragen

Query Editor bietet eine Speicherfunktion, mit der Sie eine Abfrage speichern und später daran arbeiten können. Um eine Abfrage zu speichern, wählen Sie Speichern oben rechts in 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

Alle von Query Editor ausgeführten Abfragen werden in der Tabelle "Protokoll"erfasst. 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. Damit die Abfrage in Query Service verfügbar ist, muss sie in Query Editor ausgeführt oder gespeichert werden.

Ausführen von Abfragen mit dem Abfrage-Editor

Um eine Abfrage in Query Editor auszuführen, können Sie SQL im Editor eingeben oder eine vorherige Abfrage von der Registerkarte Protokoll oder Durchsuchen laden und Abspielen auswählen. 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. Die Konsole zeigt den Verbindungsstatus zu Query Service, ausgeführte Abfragen-Vorgänge und alle Fehlermeldungen an, die sich aus diesen Abfragen ergeben.

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. Anweisungen zum Generieren eines Datensatzes aus Abfragen finden Sie im Tutorial Generieren von Datensätzen.Query Editor

Bild

Abfragen mit einem Tutorial zum Thema Query Service 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

Nachdem Sie wissen, welche Funktionen in Query Editor verfügbar sind und wie Sie in der Anwendung navigieren, können Sie Ihre eigenen Abfragen direkt in Platform erstellen. Weitere Informationen zum Ausführen von SQL-Abfragen für Datasets in Data Lake finden Sie im Handbuch Ausführen von Abfragen.

Auf dieser Seite