Handbuch für die Query Editor-Benutzeroberfläche

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 Erstellung von Abfragen für die Analyse und Datenexploration und ermöglicht das Ausführen interaktiver Abfragen für Entwicklungszwecke sowie nicht interaktiver Abfragen zum Befüllen von Datensätzen in Experience Platform.

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

Erste Schritte

Query Editor bietet eine flexible Ausführung von Abfragen durch Herstellen einer Verbindung mit Query Service. Abfragen werden nur ausgeführt, solange diese Verbindung aktiv ist.

Herstellen einer Verbindung mit Query Service

Query Editor benötigt beim Öffnen einige Sekunden, um zu initialisieren und eine Verbindung mit Query Service herzustellen. 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.

Die Konsolenausgabe des Abfrage-Editors bei der ersten Verbindung.

Ausführen von Abfragen über Query Editor

Von Query Editor durchgefü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.

Abfragenerstellung 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 Benutzenden in Ihrem Unternehmen mit Zugriff auf Query Service zur Verfügung.

Zugreifen auf Query Editor

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

Die Registerkarte „Übersicht“ für den Abfragearbeitsbereich mit hervorgehobener Option „Abfrage erstellen“.

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 das SQL-Eingabefeld und Abspielen hervorgehoben sind.

Der Abfrage-Editor mit dem SQL-Eingabefeld und hervorgehobener „Abspielen“-Option.

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.

Schreib-Tools in Query Editor

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

Eine SQL-Anweisung im Abfrage-Editor, in der die Syntaxfarbhervorhebung veranschaulicht ist.

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

Einige SQL-Zeichen mit dem Dropdown-Menü zur automatischen Vervollständigung mit Optionen aus dem Abfrage-Editor.

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

Die Eingabe im Abfrage-Editor mit einem Dropdown-Menü mit Tabellennamenvorschlägen.

Umschalter für die Konfiguration der Benutzeroberfläche für die automatische Vervollständigung

Query Editor schlägt automatisch potenzielle SQL-Schlüsselwörter zusammen mit Tabellen- oder Spaltendetails für die Abfrage vor, während Sie sie schreiben. Die Funktion zur automatischen Vervollständigung ist standardmäßig aktiviert und kann jederzeit deaktiviert oder aktiviert werden, indem Sie den Umschalter Automatische Syntaxvervollständigung oben rechts im Abfrage-Editor auswählen.

Die Konfigurationseinstellung für die automatische Vervollständigung erfolgt pro Benutzer bzw. Benutzerin und wird für die späteren Anmeldungen dieser Person gespeichert.

Abfrage-Editor mit hervorgehobenem Umschalter für die automatische Syntaxvervollständigung.

Die Deaktivierung dieser Funktion verhindert, dass mehrere Metadatenbefehle verarbeitet werden, und bietet Empfehlungen, die in der Regel die Bearbeitung von Abfragen durch den Autor beschleunigt.

Wenn Sie den Umschalter verwenden, um die Funktion für die automatische Vervollständigung zu aktivieren, sind nach einer kurzen Pause empfohlene Vorschläge für Tabellen- und Spaltennamen sowie SQL-Schlüsselwörter verfügbar. Eine Erfolgsmeldung in der Konsole unter dem Abfrage-Editor zeigt an, dass die Funktion aktiv ist.

Wenn Sie die Funktion zur automatischen Vervollständigung deaktivieren, ist eine Seitenaktualisierung erforderlich, damit die Funktion wirksam wird. Wenn Sie den Umschalter Automatische Syntaxvervollständigung deaktivieren, wird ein Bestätigungsdialogfeld mit drei Optionen angezeigt:

  • Abbrechen
  • Änderungen speichern und aktualisieren
  • Ohne Speichern von Änderungen aktualisieren
WICHTIG

Falls Sie eine Abfrage erstellen oder bearbeiten, wenn Sie diese Funktion deaktivieren, müssen Sie alle Änderungen an Ihrer Abfrage speichern, bevor Sie die Seite aktualisieren. Andernfalls geht der gesamte Fortschritt verloren.

Das Bestätigungsdialogfeld zum Deaktivieren der Funktion für die automatische Vervollständigung.

Wählen Sie die entsprechende Option aus, um die Funktion zur automatischen Vervollständigung zu deaktivieren.

Fehlererkennung

Query Editor validiert eine Abfrage automatisch, während Sie sie schreiben, und bietet dabei eine allgemeine SQL-Validierung und eine spezifische Ausführungsvalidierung. Wenn die Abfrage rot unterstrichen ist (wie in der Abbildung unten), liegt ein Fehler in der Abfrage vor.

Die Eingabe in den Abfrage-Editor, in der SQL rot unterstrichen ist, um einen Fehler anzugeben.

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

Ein Dialogfeld mit einer Fehlermeldung.

Details zur Abfrage

Wählen Sie eine gespeicherte Vorlage auf der Registerkarte Vorlagen aus, um sie im Abfrage-Editor anzuzeigen. Das Bedienfeld mit Abfragedetails enthält weitere Informationen und Tools zur Verwaltung der ausgewählten Abfrage.

Der Abfrage-Editor mit hervorgehobenem Bedienfeld mit Abfragedetails.

In diesem Bedienfeld können Sie einen Ausgabedatensatz direkt über die Benutzeroberfläche generieren, die angezeigte Abfrage löschen oder benennen und der Abfrage einen Zeitplan hinzufügen.

In diesem Bedienfeld werden außerdem nützliche Metadaten angezeigt, z. B. wann die Abfrage zuletzt geändert wurde und wer sie gegebenenfalls geändert hat. Wählen Sie Ausgabedatensatz aus, um einen Datensatz zu generieren. Das Dialogfeld Ausgabedatensatz wird angezeigt. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie dann Abfrage ausführen aus. Der neue Datensatz wird in der Query Service-Benutzeroberfläche von Platform auf der Registerkarte Datensätze angezeigt.

Geplante Abfragen

Abfragen, die als Vorlage gespeichert wurden, können im Abfrage-Editor geplant werden. Auf diese Weise können Sie die Ausführung von Abfragen in einem benutzerdefinierten Cadence automatisieren. Sie können Abfragen basierend auf Häufigkeit, Datum und Uhrzeit planen und bei Bedarf auch einen Ausgabedatensatz für Ihre Ergebnisse auswählen. Abfragezeitpläne können auch über die Benutzeroberfläche deaktiviert oder gelöscht werden.

Zeitpläne werden im Abfrage-Editor festgelegt. Im Folgenden finden Sie eine Liste der Einschränkungen für geplante Abfragen bei Verwendung des Abfrage-Editors. Sie gelten nicht für die Query Service API:

  • Sie können einen Zeitplan nur zu einer Abfrage hinzufügen, die bereits erstellt, gespeichert und ausgeführt wurde.
  • Sie können keinen Zeitplan zu einer parametrisierten Abfrage hinzufügen.
  • Geplante Abfragen können keinen anonymen Block enthalten.

Weitere Informationen finden Sie in der Dokumentation zu Abfragezeitplänen . Erstellen von Abfrageplänen in der Benutzeroberfläche. Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie auch in der Endpunktleitfaden für geplante Abfragen.

Alle geplanten Abfragen werden der Liste im Geplante Abfragen Registerkarte. Von diesem Arbeitsbereich aus können Sie den Status aller geplanten Abfrageaufträge über die Benutzeroberfläche überwachen. Im Geplante Abfragen finden Sie wichtige Informationen zu Ihren Abfrageausführungen und abonnieren Warnungen. Zu den verfügbaren Informationen gehören Status, Planungsdetails und Fehlermeldungen/Codes für den Fall, dass eine Ausführung fehlschlägt. Siehe Dokument zur Überwachung geplanter Abfragen für weitere Informationen.

Speichern von Abfragen

Der Query Editor bietet eine Speicherfunktion, mit der Sie eine Abfrage speichern und später daran arbeiten können. Klicken Sie zum Speichern einer Abfrage oben rechts im Query Editor auf Speichern. Bevor eine Abfrage gespeichert werden kann, muss über das Bedienfeld Details zur Abfrage ein Name für die Abfrage angegeben werden.

HINWEIS

Mit dem Abfrage-Editor benannte und gespeicherte Abfragen sind als Vorlagen in der Registerkarte Vorlagen im Abfrage-Dashboard verfügbar. Weitere Informationen finden Sie in der Dokumentation zu Vorlagen.

Auffinden früherer Abfragen

Alle vom Query Editor ausgeführten Abfragen werden in der Protokolltabelle erfasst. Sie können die Suchfunktion auf der Registerkarte Protokoll verwenden, um Abfrageausführungen zu finden. Gespeicherte Abfragen werden auf der Registerkarte Vorlagen angezeigt.

Wenn eine Abfrage geplant wurde, bietet die Registerkarte Geplante Abfragen über die Benutzeroberfläche eine verbesserte Sichtbarkeit für diese Abfrageaufträge. Weitere Informationen finden Sie in der Dokumention zur Abfrageüberwachung.

HINWEIS

Nicht ausgeführte Abfragen werden nicht im Protokoll gespeichert. Damit die Abfrage in Query Service verfügbar ist, muss sie im Query Editor ausgeführt oder gespeichert werden.

Ausführen von Abfragen mit dem Abfrage-Editor

Um eine Abfrage im Query Editor auszuführen, können Sie SQL im Editor eingeben oder eine frühere Abfrage über die Registerkarte Protokoll oder Vorlagen laden und auf Abspielen klicken. 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 zum Query Service, die ausgeführten Abfragen und alle Fehlermeldungen an, die aus diesen Abfragen resultieren.

Die Registerkarte „Konsole“ der Abfrage-Editor-Konsole.

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

Auf der Registerkarte „Ergebnisse“ der Abfrage-Editor-Konsole werden die Ergebnisse einer Abfrageausführung angezeigt.

Tutorial-Video zum Ausführen von Abfragen mit Query Service

Im folgenden Video erfahren Sie, wie Sie Abfragen in der Adobe Experience Platform-Benutzeroberfläche und in einem PSQL-Client ausführen. Darüber hinaus wird 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 nun wissen, welche Funktionen im Query Editor verfügbar sind und wie Sie in der Anwendung navigieren, können Sie damit beginnen, Ihre eigenen Abfragen direkt im Platform zu erstellen. Weitere Informationen zum Ausführen von SQL-Abfragen für Datensätze im Data Lake finden Sie im Handbuch zum Ausführen von Abfragen.

Auf dieser Seite