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 getting-started

Query Editor bietet flexible Ausführung von Abfragen durch Verbinden mit Query Service, und Abfragen werden nur ausgeführt, während diese Verbindung aktiv ist.

Zugreifen auf Query Editor accessing-query-editor

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

Herstellen einer Verbindung mit Query Service connecting-to-query-service

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

Ausführen von Abfragen über Query Editor run-a-query

Von ausgeführten Abfragen Query Editor interaktiv ausführen, was bedeutet, dass die Abfrage abgebrochen wird, wenn Sie den Browser schließen oder wegnavigieren. Dasselbe gilt für Abfragen, die zum Generieren von Datensätzen aus Abfrageausgaben durchgeführt werden.

Mit der erweiterten Bearbeitung des Abfrage-Editors können Sie mehr als eine Abfrage im Abfrage-Editor schreiben und alle Abfragen sequenziell ausführen. Siehe Abschnitt zu Ausführen mehrerer sequenzieller Abfragen für weitere Informationen.

Abfragenerstellung mit Query Editor query-authoring

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.

Erweiterter Umschalter des Abfrage-Editors enhanced-editor-toggle

Mit einem UI-Umschalter können Sie zwischen der alten und der erweiterten Version des Abfrage-Editors wechseln. Die ältere Version ist standardmäßig aktiviert, obwohl die verbesserte Version bessere Zugänglichkeit und Unterstützung für mehrere Designs bietet. Aktivieren Sie die erweiterte Version, um auf die Einstellungen des Abfrage-Editors zuzugreifen.

Durch Aktivierung des Umschalters wird der Editor zu einem helleren Design geändert und die Lesbarkeit der Syntax verbessert. Darüber hinaus wird über dem Eingabefeld Abfrage-Editor ein Einstellungssymbol angezeigt, das den Umschalter für die automatische Vervollständigung enthält. Über das Einstellungssymbol können Sie das Dunkle Design aktivieren oder die automatische Vervollständigung deaktivieren/aktivieren.

Um dunkle oder helle Themen zu aktivieren, wählen Sie das Einstellungssymbol ( ) gefolgt von der Option im angezeigten Dropdown-Menü.

Mehrere sequenzielle Abfragen ausführen execute-multiple-sequential-queries

Mit der erweiterten Bearbeitung des Abfrage-Editors können Sie mehr als eine Abfrage im Abfrage-Editor schreiben und alle Abfragen sequenziell ausführen.

Die Ausführung mehrerer Abfragen in einer Sequenz generiert jeweils einen Protokolleintrag. In der Konsole "Abfrage-Editor"werden jedoch nur die Ergebnisse der ersten Abfrage angezeigt. Überprüfen Sie das Abfrageprotokoll, ob Sie eine Fehlerbehebung durchführen oder die ausgeführten Abfragen bestätigen müssen. Siehe Dokumentation zu Abfrageprotokollen für weitere Informationen.

Ausgewählte Abfrage ausführen execute-selected-query

Wenn Sie mehrere Abfragen geschrieben haben, aber nur eine Abfrage ausführen müssen, können Sie Ihre ausgewählte Abfrage markieren und die
Ausgewählte Abfrage ausführen Symbol. Dieses Symbol ist standardmäßig deaktiviert, bis Sie im Editor die Abfragesyntax auswählen.

Ergebnisanzahl result-count

Der Abfrage-Editor verfügt über eine Ausgabe von maximal 50.000 Zeilen. Sie können die Anzahl der Zeilen auswählen, die gleichzeitig in der Konsole "Abfrage-Editor"angezeigt werden. Um die Anzahl der in der Konsole angezeigten Zeilen zu ändern, wählen Sie die Ergebnisanzahl und wählen Sie aus den Optionen 50, 100, 150, 300 und 500 aus.

Schreiben von Abfragen writing-queries

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.

Um Ihre Entwicklungszeit zu minimieren, sollten Sie Ihre Abfragen mit Begrenzungen für die Anzahl der 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 writing-tools

Text formatieren format-text

Die Text formatieren -Funktion ermöglicht eine bessere Lesbarkeit Ihrer Abfrage durch das Hinzufügen standardisierter Syntaxstile. Auswählen Text formatieren , um den gesamten Text im Abfrage-Editor zu standardisieren.

SQL kopieren copy-sql

Wählen Sie das Kopiersymbol aus, um SQL aus dem Abfrage-Editor in die Zwischenablage zu kopieren. Diese Kopierfunktion ist sowohl für Abfragevorlagen als auch für neu erstellte Abfragen im Abfrage-Editor verfügbar.

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

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.

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:

Um die Funktion zur automatischen Vervollständigung zu deaktivieren, wählen Sie die entsprechende Bestätigungsoption aus.

Fehlererkennung error-detection

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.

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

Details zur Abfrage query-details

Um eine Abfrage im Abfrage-Editor anzuzeigen, wählen Sie eine beliebige gespeicherte Vorlage aus dem Vorlagen Registerkarte. Das Bedienfeld "Abfragedetails"enthält weitere Informationen und Tools zur Verwaltung der ausgewählten Abfrage. Außerdem werden nützliche Metadaten angezeigt, z. B. das letzte Mal, dass die Abfrage geändert wurde und wer sie gegebenenfalls geändert hat.

Im Detailbereich können Sie einen Ausgabedatensatz direkt über die Benutzeroberfläche generieren, die angezeigte Abfrage löschen oder benennen, den Zeitplan für die Ausführung der Abfrage anzeigen und die Abfrage einem Zeitplan hinzufügen.

Um einen Ausgabedatensatz zu generieren, wählen Sie Als CTAS ausführen. Die Ausgabedatasdetails eingeben angezeigt. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie Als CTAS ausführen. Der neue Datensatz wird im Datensätze Registerkarte Durchsuchen . Siehe die Dokumentation zum Anzeigen von Datensätzen , um mehr über verfügbare Datensätze für Ihre Organisation zu erfahren.

Nachdem Sie die Als CTAS ausführen -Aktion, wird eine Bestätigungsmeldung angezeigt, die Sie über die erfolgreiche Aktion informiert. Diese Popup-Nachricht enthält einen Link, der eine praktische Möglichkeit bietet, zum Arbeitsbereich "Abfrageprotokolle"zu navigieren. Siehe Dokumentation zu Abfrageprotokollen für weitere Informationen zu Abfrageprotokollen.

Speichern von Abfragen saving-queries

Der 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 in der oberen rechten Ecke von Query Editor. Bevor eine Abfrage gespeichert werden kann, muss über das Bedienfeld Details zur Abfrage ein Name für die Abfrage angegeben werden.

Wenn Sie eine Abfrage im Abfrage-Editor speichern, wird eine Bestätigungsmeldung angezeigt, die Sie über die erfolgreiche Aktion informiert. Diese Popup-Nachricht enthält einen Link, der eine praktische Möglichkeit bietet, zum Arbeitsbereich "Planung von Abfragen"zu navigieren. Siehe Planungsabfragedokumentation , um zu erfahren, wie Sie Abfragen für eine benutzerdefinierte Cadence ausführen.

Geplante Abfragen scheduled-queries

Abfragen, die als Vorlage gespeichert wurden, können im Abfrage-Editor geplant werden. Mit der Planung von Abfragen können Sie die Ausführung von Abfragen in einem benutzerdefinierten Ordner 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. Bei Verwendung des Abfrage-Editors können Sie einer bereits erstellten, gespeicherten und ausgeführten Abfrage nur einen Zeitplan hinzufügen. Dieselbe Einschränkung gilt nicht für Query Service API:

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 im Abschnitt 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, falls eine Ausführung fehlgeschlagen ist. Siehe Dokument zur Überwachung geplanter Abfragen für weitere Informationen.

Auffinden früherer Abfragen previous-queries

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.

Ausführen von Abfragen mit dem Abfrage-Editor executing-queries

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 console

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.

Abfrageergebnisse query-results

Nach Abschluss einer Abfrage werden die Ergebnisse auf der Registerkarte Ergebnisse neben der Registerkarte Konsole angezeigt. Diese Ansicht zeigt die tabellarische Ausgabe Ihrer Abfrage, die je nach ausgewähltem Ergebnis zwischen 50 und 500 Zeilen der Ergebnisse anzeigt Ergebnisanzahl. 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.

Anwendungsfälle use-cases

Query Service bietet Lösungen für eine Vielzahl von Anwendungsfällen in verschiedenen Branchen und Geschäftsszenarien. Diese praktischen Beispiele belegen die Flexibilität und die Wirkung des Dienstes bei der Bewältigung verschiedener Bedürfnisse. nach Erfahren Sie, wie Query Service für Ihre spezifischen Geschäftsanforderungen von Nutzen sein kann., lesen Sie die umfassende Sammlung von Anwendungsfalldokumenten. Erfahren Sie, wie Sie mithilfe von Query Service Einblicke und Lösungen für eine verbesserte betriebliche Effizienz und Geschäftserfolg erhalten.

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

Im folgenden Video erfahren Sie, wie Sie Abfragen in der Adobe Experience Platform-Benutzeroberfläche und in einem PSQL-Client ausführen. Das Video zeigt außerdem die Verwendung einzelner Eigenschaften in einem XDM-Objekt, Adobe-definierte Funktionen und die Verwendung von CREATE TABLE AS SELECT (CTAS)-Abfragen.

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.