Anleitung zur Benutzeroberfläche des Abfrage-Editors

NOTE
Der alte Editor wurde am 24. Mai 2024 eingestellt. Es ist nicht mehr verfügbar. Sie können jetzt den erweiterten Abfrage-Editor verwenden, um Ihre Abfragen zu schreiben, zu validieren und auszuführen

Der Abfrage-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. Der Abfrage-Editor unterstützt die Entwicklung von Abfragen für die Analyse und Datenexploration und ermöglicht Ihnen das Ausführen interaktiver Abfragen zu Entwicklungszwecken sowie nicht-interaktiver Abfragen zum Ausfüllen von Datensätzen in Experience Platform.

Weitere Informationen zu 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

Der Abfrage-Editor bietet eine flexible Ausführung von Abfragen durch Herstellen einer Verbindung zu Query Service. Abfragen werden nur ausgeführt, wenn diese Verbindung aktiv ist.

Aufrufen des Abfrage-Editors accessing-query-editor

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

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

Herstellen einer Verbindung zu 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.

Die Konsolenausgabe des Abfrage-Editors bei der ersten Verbindung.

Ausführen von Abfragen im Abfrage-Editor run-a-query

Im Abfrage-Editor ausgeführte Abfragen werden interaktiv ausgeführt. Das 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.

Abfragebearbeitung mit dem erweiterten Abfrage-Editor query-authoring

NOTE
Der alte Editor wurde am 24. Mai 2024 eingestellt. Es ist nicht mehr verfügbar. Sie können jetzt den erweiterten Abfrage-Editor verwenden, um Ihre Abfragen zu schreiben, zu validieren und auszuführen.

Mit dem Abfrage-Editor können Sie Abfragen für Kundenerlebnisdaten schreiben, ausführen und speichern. Alle Abfragen, die ausgeführt oder im Abfrage-Editor gespeichert werden, stehen allen Benutzern in Ihrer Organisation mit Zugriff auf Query Service zur Verfügung.

Einstellungen settings

Ein Einstellungssymbol über dem Eingabefeld Abfrage-Editor enthält Optionen zum Aktivieren/Deaktivieren des Dunklen Designs oder Deaktivieren/Aktivieren der automatischen Vervollständigung.

TIP
Sie können die automatische Syntaxbeendigung deaktivieren, während Sie eine Abfrage erstellen, ohne den Fortschritt zu verlieren.

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

Der Abfrage-Editor mit dem Einstellungssymbol und der Dropdown-Menüoption Dunkles Design aktivieren hervorgehoben.

Automatische Vervollständigung auto-complete

Der Abfrage-Editor schlägt bei der Erstellung der Abfrage automatisch potenzielle SQL-Schlüsselwörter zusammen mit Tabellen- oder Spaltendetails vor. Die Funktion zur automatischen Vervollständigung ist standardmäßig aktiviert und kann jederzeit über die Einstellungen des Abfrage-Editors deaktiviert oder aktiviert werden.

Die Konfigurationseinstellung für die automatische Vervollständigung erfolgt pro Benutzer und wird für die aufeinander folgenden Anmeldungen für diesen Benutzer 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.

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

Verwenden Sie den erweiterten Abfrage-Editor, um mehr als eine Abfrage zu schreiben und alle Abfragen sequenziell auszufü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. Weitere Informationen finden Sie in der Dokumentation zu Abfrageprotokollen .

NOTE
Wenn nach der ersten Abfrage im Abfrage-Editor eine CTAS-Abfrage ausgeführt wird, wird weiterhin eine Tabelle erstellt, jedoch keine Ausgabe in der Abfrage-Editor-Konsole.

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
Symbol Ausgewählte Abfrage ausführen . Dieses Symbol ist standardmäßig deaktiviert, bis Sie im Editor die Abfragesyntax auswählen.

Der Abfrage-Editor mit dem Symbol Ausgewählte Abfrage ausführen wurde hervorgehoben.

Sitzung des Abfrage-Editors abbrechen cancel-query

Übernehmen Sie die Kontrolle über die Ausführung von Abfragen und verbessern Sie Ihre Produktivität, indem Sie langwierige Abfragen abbrechen. Durch diese Aktion wird der Abfrage-Editor während einer Abfrageausführung gelöscht. Beachten Sie, dass die Abfrage weiterhin im Hintergrund ausgeführt wird. Wenn es sich um eine CTAS-Abfrage handelt, wird weiterhin ein Ausgabedatensatz generiert. Um die Ausführung im Editor abzubrechen und mit dem Erstellen einer SQL-Anweisung fortzufahren, wählen Sie Abfrage abbrechen aus, nachdem Sie eine Abfrage ausgeführt haben.

Der Abfrage-Editor mit der Markierung Abfrage abbrechen.

Ein Bestätigungsdialogfeld wird angezeigt. Wählen Sie Bestätigen aus, um die Ausführung der Abfrage abzubrechen.

Das Dialogfeld Abbrechen der Abfragenbestätigungmit hervorgehobener Bestätigung

Ergebniszähler 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 das Dropdown-Menü Ergebnisanzahl aus und wählen Sie aus den Optionen 50, 100, 150, 300 und 500 aus.

Der Abfrage-Editor mit hervorgehobenem Dropdown-Menü Ergebnisanzahl.

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.

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

Schreibwerkzeuge im Abfrage-Editor writing-tools

  • 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 die automatische Vervollständigung die Felder in dieser Tabelle.

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

Text formatieren format-text

Die Funktion Text formatieren erleichtert die Lesbarkeit Ihrer Abfrage, indem standardisierte Syntaxstile hinzugefügt werden. Wählen Sie Text formatieren aus, um den gesamten Text im Abfrage-Editor zu standardisieren.

NOTE
Die Funktion Text formatieren funktioniert nicht mit anonymen Bausteinen. Informationen zum sequenziellen Verketten einer oder mehrerer SQL-Anweisungen finden Sie in der Dokumentation zu anonymen Bausteinen .

Der Abfrage-Editor mit Text formatieren und die SQL-Anweisungen hervorgehoben.

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.

Der Arbeitsbereich Abfragenmit einer Beispielabfragevorlage mit hervorgehobenem Kopiersymbol.

Details zur Abfrage query-details

Um eine Abfrage im Abfrage-Editor anzuzeigen, wählen Sie eine gespeicherte Vorlage auf der Registerkarte Vorlagen aus. 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.

NOTE
Die Optionen Zeitplan anzeigen, Zeitplan hinzufügen und Abfrage löschen sind erst verfügbar, nachdem die Abfrage als Vorlage gespeichert wurde. Mit der Option Zeitplan hinzufügen gelangen Sie direkt vom Abfrage-Editor zum Zeitplan-Builder. Mit der Option Zeitplan anzeigen gelangen Sie direkt zum Planbestand für diese Abfrage. Informationen zum Erstellen von Abfragezeitplänen in der Benutzeroberfläche von 🔗 finden Sie in der Dokumentation zu den Abfrageplänen .

Der Abfrage-Editor mit hervorgehobenem Bedienfeld mit Abfragedetails.

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. Das Dialogfeld Enter output dataset details wird angezeigt. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie dann Als CTAS ausführen aus. Der neue Datensatz wird auf der Registerkarte Datensätze Durchsuchen angezeigt. Weitere Informationen zu verfügbaren Datensätzen für Ihr Unternehmen finden Sie in der Dokumentation zum Anzeigen von Datensätzen 🔗 .

NOTE
Die Option Als CTAS ausführen ist nur verfügbar, wenn die Abfrage nicht geplant hat.

Das Dialogfeld Ausgabedatensatzdetails eingeben

Nachdem Sie die Aktion Als CTAS ausführen ausgeführt haben, 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. Weitere Informationen zu Abfrageprotokollen finden Sie in der Dokumentation zu Abfrageprotokollen .

Speichern von Abfragen saving-queries

Der Abfrage-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 oben rechts im Abfrage-Editor Speichern aus. Bevor eine Abfrage gespeichert werden kann, muss über das Bedienfeld Details zur Abfrage ein Name für die Abfrage angegeben werden.

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

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. Informationen zum Ausführen von Abfragen für eine benutzerdefinierte Cadence finden Sie in der Dokumentation Planung von Abfragen .

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 und gespeicherten Abfrage nur einen Zeitplan hinzufügen. Dasselbe gilt nicht für die Query Service-API.

NOTE
Geplante Abfragen, die zehn aufeinander folgende Ausführungen fehlschlagen, werden automatisch in den Status In Quarantäne versetzt. Eine Abfrage mit diesem Status erfordert Ihre Intervention, bevor weitere Ausführungen durchgeführt werden können. Weitere Informationen finden Sie in der Dokumentation zu in Quarantäne befindlichen Abfragen .

Informationen zum Erstellen von Abfragezeitplänen in der Benutzeroberfläche von 🔗 finden Sie in der Dokumentation zu den Abfrageplänen . Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie auch im Endpunkthandbuch zu geplanten Abfragen.

Alle geplanten Abfragen werden der Liste auf der Registerkarte Geplante Abfragen hinzugefügt. Von diesem Arbeitsbereich aus können Sie den Status aller geplanten Abfrageaufträge über die Benutzeroberfläche überwachen. Auf der Registerkarte Geplante Abfragen finden Sie wichtige Informationen zu Ihren Abfrageausführungen und abonnieren Warnhinweise. Zu den verfügbaren Informationen gehören Status, Planungsdetails und Fehlermeldungen/Codes, falls eine Ausführung fehlgeschlagen ist. Weitere Informationen finden Sie im Dokument Terminierte Abfragen überwachen .

Auffinden früherer Abfragen previous-queries

Alle vom Abfrage-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 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.

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

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

Um eine Abfrage im Abfrage-Editor auszuführen, können Sie SQL im Editor eingeben oder eine frühere Abfrage über die Registerkarte Protokoll oder Vorlagen 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 console

Die Konsole bietet Informationen zum Status und zum Betrieb von Query Service. Die Konsole zeigt den Verbindungsstatus zu Query Service, die ausgeführten Abfragen und alle Fehlermeldungen an, die sich aus diesen Abfragen ergeben.

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

NOTE
Die Konsole zeigt nur Fehler an, die bei der Ausführung einer Abfrage aufgetreten sind. Es werden keine Fehler bei der Abfrage-Validierung angezeigt, die vor der Ausführung einer Abfrage auftreten.

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ählter Ergebnisanzahl zwischen 50 und 500 Zeilen der Ergebnisse anzeigt. 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 Abfrage-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.

Beispiele examples

Query Service bietet Lösungen für eine Vielzahl von Anwendungsfällen in verschiedenen Branchen und Geschäftsszenarien. Diese Beispiele belegen die Flexibilität und die Wirkung des Dienstes bei der Bewältigung verschiedener Bedürfnisse. Um zu erfahren, wie Query Service Ihren spezifischen Geschäftsanforderungen einen Mehrwert bringen 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 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.

NOTE
Die im Video dargestellte Benutzeroberfläche ist veraltet, die im Workflow verwendete Logik bleibt jedoch unverändert.

Nächste Schritte

Nachdem Sie nun wissen, welche Funktionen im Abfrage-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 Datensätze im Data Lake finden Sie im Handbuch zum Ausführen von Abfragen.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb