Handbuch zur Benutzeroberfläche des Abfrage-Editors

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 das Ausführen interaktiver Abfragen für Entwicklungszwecke sowie nicht interaktiver Abfragen zum Auffü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 mit dem Abfrage-Service. Abfragen werden nur ausgeführt, solange diese Verbindung aktiv ist.

Aufrufen des Abfrage-Editors accessing-query-editor

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

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

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

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

Vom Abfrage-Editor ausgeführte Abfragen werden interaktiv ausgeführt. Das bedeutet, dass die Abfrage abgebrochen wird, wenn Sie den Browser schließen oder die Seite verlassen. Dasselbe gilt für Abfragen, die zum Generieren von Datensätzen aus Abfrageausgaben durchgeführt werden.

Abfrageerstellung mit dem erweiterten Abfrage-Editor query-authoring

Mit dem Abfrage-Editor können Sie Abfragen für Kundenerlebnisdaten schreiben, ausführen und speichern. Alle im Abfrage-Editor ausgeführten oder gespeicherten Abfragen stehen allen Benutzenden in Ihrer Organisation mit Zugriff auf den Abfrage-Service zur Verfügung.

Datenbankauswahl database-selector

Wählen Sie eine abzufragende Datenbank aus dem Dropdown-Menü oben rechts im Abfrage-Editor. Die ausgewählte Datenbank wird in der Dropdown-Liste angezeigt.

Einstellungen settings

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

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

Automatisch vervollständigen auto-complete

Der Abfrage-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 in den 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 dieses Benutzers 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.

Ausführen mehrerer sequenzieller Abfragen execute-multiple-sequential-queries

Verwenden Sie den erweiterten Abfrage-Editor, um mehr als eine Abfrage zu schreiben und alle Abfragen nacheinander auszuführen. Die Ausführung mehrerer Abfragen in einer Sequenz erzeugt jeweils einen Protokolleintrag. In der Abfrage-Editor-Konsole werden jedoch nur die Ergebnisse der ersten Abfrage angezeigt. Überprüfen Sie das Abfrageprotokoll, wenn Sie die ausgeführten Abfragen beheben oder bestätigen müssen. Weitere Informationen finden in derzu Abfrageprotokollen .

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

Abbrechen der Sitzung des Abfrage-Editors cancel-query

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

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

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 Abfrage-Editor-Konsole angezeigt werden. Um die Anzahl der in der Konsole angezeigten Zeilen zu ändern, wählen Sie die Dropdown-Liste Ergebnisanzahl und 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 die Entwicklungszeit zu minimieren, wird empfohlen, die Abfragen mit Beschränkungen für die Anzahl der zurückgegebenen Zeilen zu 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

Verwenden Sie die Schreibwerkzeuge des Abfrage-Editors, um den Prozess zum Erstellen von Abfragen zu verbessern. Zu den Funktionen gehören Optionen zum Formatieren von Text, Kopieren von SQL, Verwalten von Abfragedetails und Speichern oder Planen Ihrer Arbeit während des Fortschritts.

Text formatieren format-text

Die Funktion Text formatieren macht Ihre Abfrage lesbarer, indem sie einen standardisierten Syntaxstil hinzufügt. Wählen Sie 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.

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 mit Abfragedetails enthält weitere Informationen und Tools zum Verwalten der ausgewählten Abfrage. Außerdem werden nützliche Metadaten angezeigt, z. B. wann die Abfrage zuletzt geändert wurde und wer sie gegebenenfalls geändert hat.

Im Bedienfeld Details 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 aus. Das Ausgabedatensatzdetails eingeben 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 zu den für Ihre Organisation verfügbaren Datensätzen findenin der Dokumentation zum Anzeigen von Datensätzen .

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 für Abfrageprotokolle zu navigieren. Weitere Informationen zu Abfrageprotokollen finden inDokumentation 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. 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 einfache Möglichkeit bietet, zum Arbeitsbereich Planung von Abfragen zu navigieren. Weitere Informationen zum Ausführen von mit benutzerdefinierter Kadenz findenin der Dokumentation zum Planen von Abfragen .

Geplante Abfragen scheduled-queries

Abfragen, die als Vorlage gespeichert wurden, können über den Abfrage-Editor geplant werden. Mit der Planung von Abfragen können Sie die Ausführung von Abfragen in einer benutzerdefinierten Kadenz 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 einen Zeitplan nur zu einer Abfrage hinzufügen, die bereits erstellt und gespeichert wurde. Dieselbe Einschränkung gilt nicht für die Abfrage-Service-API.

Weitere Informationen zum Erstellen von Abfragezeitplänen in der Benutzeroberfläche finden in der Dokumentation zu Abfragezeitplänen. Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie alternativ im Handbuch zu Endpunkten für geplante 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 zur Ausführung Ihrer Abfragen und können Warnhinweise abonnieren. Zu den verfügbaren Informationen gehören der Status, Details zum Zeitplan und Fehlermeldungen/-codes, wenn ein Durchlauf fehlgeschlagen ist. Weitere Informationen finden im DokumentAbfragen ü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.

[Eingeschränkte Verfügbarkeit]{class="badge informative"} Objektbrowser object-browser

Verwenden Sie den Objekt-Browser, um Datensätze einfach zu suchen und zu filtern. Der Objekt-Browser reduziert die Zeit, die mit der Suche nach Tabellen und Datensätzen in großen Umgebungen mit zahlreichen Datensätzen verbracht wird. Durch den optimierten Zugriff auf relevante Daten und Metadaten können Sie sich mehr auf die Erstellung von Abfragen konzentrieren und weniger auf die Navigation.

Um in Ihrer Datenbank mit dem Objektbrowser zu navigieren, geben Sie einen Tabellennamen in das Suchfeld ein oder wählen Sie Tabellen, um die Liste der verfügbaren Datensätze und Tabellen zu erweitern. Wenn Sie das Suchfeld verwenden, wird die Liste der verfügbaren Tabellen basierend auf Ihrer Eingabe dynamisch gefiltert.

Jeder Datensatz, der in ausgewählten Datenbank enthalten ist, wird in einer Navigationsleiste links neben dem Abfrage-Editor aufgeführt.

Das im Objekt-Browser angezeigte Schema ist ein beobachtbares Schema. Das bedeutet, dass Sie damit Änderungen und Aktualisierungen in Echtzeit überwachen können, da Änderungen sofort sichtbar sind. Die beobachtbaren Schemata helfen, die Datensynchronisation sicherzustellen, und unterstützen bei Debugging- oder Analyseaufgaben.

Strombegrenzung current-limitation

Das System verarbeitet Abfragen sequenziell, d. h., es kann jeweils nur eine Abfrage ausgeführt werden. Während eine Abfrage ausgeführt wird, können im linken Navigationsbereich keine zusätzlichen Tabellen aufgerufen werden.

Zugriff auf Tabellenmetadaten table-metadata

Zusätzlich zu den Schnellsuchen können Sie jetzt auch einfach auf die Metadaten einer beliebigen Tabelle zugreifen, indem Sie auf das Symbol „i“ neben dem Tabellennamen klicken. Dadurch erhalten Sie detaillierte Informationen zur ausgewählten Tabelle, die Ihnen helfen, beim Schreiben von Abfragen fundierte Entscheidungen zu treffen.

Untergeordnete Tabellen durchsuchen

Um untergeordnete oder verknüpfte Tabellen zu untersuchen, klicken Sie in der Liste auf den Dropdown-Pfeil neben einem Tabellennamen. Dadurch wird die Tabelle erweitert, sodass alle verknüpften untergeordneten Tabellen angezeigt werden. Außerdem erhalten Sie eine klare Übersicht über die Datenstruktur und können komplexere Abfragekonstruktionen erstellen. Das Symbol neben dem Feldnamen gibt den Datentyp der Spalte an, to helfen Ihnen bei der Identifizierung bei komplexen Abfragen.

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.

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 an und zeigt je nach ausgewählter () Ergebnisanzahl zwischen 50 und 500an. 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.

Beispiele examples

Query Service bietet Lösungen für eine Vielzahl von Anwendungsfällen für verschiedene Branchen und Geschäftsszenarien. Diese Beispiele zeigen die Flexibilität und die Wirkung des Service bei der Erfüllung unterschiedlicher Anforderungen. Um zu erfahren, wie Query Service Ihren spezifischen Geschäftsanforderungen einen Mehrwert bieten kann sollten Sie sich die umfassende Sammlung von Anwendungsfalldokumenten ansehen. Erfahren Sie, wie Sie mit Query Service Erkenntnisse und Lösungen für eine verbesserte betriebliche Effizienz und einen Geschäftserfolg bereitstellen können.

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 auch 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 Abfrage-Editor verfügbar sind und wie Sie in der Anwendung navigieren, können Sie damit beginnen, Ihre eigenen Abfragen direkt in 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.