Handbuch für die Query Service-Benutzeroberfläche

Der Query Service von Adobe Experience Platform bietet eine Benutzeroberfläche, die zum Schreiben und Ausführen von Abfragen, zum Anzeigen zuvor ausgeführter Abfragen und zum Zugriff auf Abfragen verwendet werden kann, die von Benutzenden in Ihrer IMS-Organisation gespeichert wurden. Um auf die Benutzeroberfläche in Adobe Experience Platform zuzugreifen, wählen Sie in der linken Navigationsleiste Abfragen aus.

Query Editor

Der Query Editor ermöglicht Ihnen, Abfragen ohne Verwendung eines externen Clients zu schreiben und auszuführen. Wählen Sie Abfrage erstellen aus, um den Query Editor zu öffnen und eine neue Abfrage zu erstellen. Sie können auf den Query Editor auch zugreifen, indem Sie auf der Registerkarte Protokoll oder Vorlagen eine Abfrage auswählen. Wenn Sie eine zuvor ausgeführte oder gespeicherte Abfrage auswählen, wird der Query Editor geöffnet und der SQL-Code für die ausgewählte Abfrage angezeigt.

Das Abfrage-Dashboard mit hervorgehobener Option „Abfrage erstellen“.

Query Editor bietet einen Bearbeitungsbereich, in dem Sie mit der Eingabe einer Abfrage beginnen können. Während der Eingabe vervollständigt der Editor automatisch reservierte SQL-Wörter, Tabellen und Feldnamen in Tabellen. Wenn Sie die Abfrage fertig geschrieben haben, klicken Sie auf die Schaltfläche Play, um die Abfrage auszuführen. Die Registerkarte Konsole unter dem Editor zeigt, was Query Service derzeit ausführt und gibt an, wann eine Abfrage zurückgegeben wurde. Auf der Registerkarte Ergebnis neben der Konsole werden die Abfrageergebnisse angezeigt. Im Handbuch zum Abfrage-Editor finden Sie weitere Informationen zur Verwendung von Query Editor.

Eine vergrößerte Ansicht von Query Editor.

Geplante Abfragen

Abfragen, die bereits als Vorlage gespeichert wurden, können so geplant werden, dass sie regelmäßig ausgeführt werden. Bei der Planung einer Abfrage können Sie die Ausführungsfrequenz, das Start- und Enddatum, den Wochentag, an dem die geplante Abfrage ausgeführt wird, sowie den Datensatz auswählen, in den die Abfrage exportiert werden soll. Abfragezeitpläne werden mit dem Abfrage-Editor festgelegt.

Informationen zum Planen einer Abfrage über die Benutzeroberfläche finden Sie unter Handbuch zu geplanten Abfragen. Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie im Handbuch zu Endpunkten für geplante Abfragen.

Sobald eine Abfrage geplant wurde, wird sie in der Liste der geplanten Abfragen auf der Geplante Abfragen Registerkarte. Umfassende Informationen zu Abfrage, Ausführungen, Ersteller und Timings finden Sie durch Auswahl einer geplanten Abfrage aus der Liste.

Der Arbeitsbereich Abfragen mit der Registerkarte Geplante Abfragen wurde hervorgehoben und zeigt Zeilen der Abfragezeitpläne an.

Spalte	Beschreibung
Name	Das Namensfeld enthält entweder den Namen der Vorlage oder die ersten Zeichen Ihrer SQL-Abfrage. Jede Abfrage, die über die Benutzeroberfläche mit dem Abfrage-Editor erstellt wurde, wird zu Beginn benannt. Wenn die Abfrage über die API erstellt wurde, ist der Name der Abfrage ein Ausschnitt des ursprünglichen SQL-Codes, der zum Erstellen der Abfrage verwendet wurde.
Vorlage	Der Name der Abfragevorlage. Klicken Sie auf einen Vorlagennamen, um zum Abfrage-Editor zu navigieren. Die Abfragevorlage wird aus praktischen Gründen im Abfrage-Editor angezeigt. Wenn kein Vorlagenname vorhanden ist, wird die Zeile mit einem Bindestrich markiert und es ist nicht möglich, zum Abfrage-Editor umzuleiten, um die Abfrage anzuzeigen.
SQL	Ein Ausschnitt der SQL-Abfrage.
Ausführungshäufigkeit	Dies ist die Kadenz, in der Ihre Abfrage ausgeführt werden soll. Die unterstützten Werte sind `Run once` und `Scheduled`. Abfragen können entsprechend ihrer Ausführungshäufigkeit gefiltert werden.
Erstellt von	Der Name der Person, die die Abfrage erstellt hat.
Erstellt	Der Zeitstempel der Erstellung der Abfrage im UTC-Format.
Zeitstempel der letzten Ausführung	Der Zeitstempel der letzten Ausführung der Abfrage. Diese Spalte zeigt, ob eine Abfrage gemäß ihrem aktuellen Zeitplan ausgeführt wurde.
Status der letzten Ausführung	Der Status der letzten Abfrageausführung. Die drei Statuswerte sind `successful`, `failed` oder `in progress`.

Weitere Informationen zum Abfragen über die Query Service-Benutzeroberfläche überwachen.

Vorlagen

Die Registerkarte Vorlagen enthält Abfragen, die von Benutzenden in Ihrer Organisation gespeichert wurden. Es ist nützlich, sie als Abfrageprojekte zu betrachten, da die hier gespeicherten Abfragen noch im Aufbau begriffen sein können. Abfragen, die auf der Registerkarte Vorlagen angezeigt werden, werden auch auf der Registerkarte Protokoll als ausgeführte Abfragen aufgeführt, wenn sie zuvor von Query Service ausgeführt wurden.

Eine vergrößerte Ansicht der Registerkarte „Vorlagen“ im Abfragen-Dashboard, auf der mehrere gespeicherte Abfragen angezeigt werden.

Spalte	Beschreibung
Name	Das Namensfeld enthält entweder den vom Benutzer erstellten Abfragenamen oder die ersten Zeichen Ihrer SQL-Abfrage. Jede Abfrage, die über die Benutzeroberfläche mit dem Abfrage-Editor erstellt wurde, wird zu Beginn benannt. Wenn die Abfrage über die API erstellt wurde, ist der Name der Abfrage ein Ausschnitt des ursprünglichen SQL-Codes, der zum Erstellen der Abfrage verwendet wurde. Sie können den Namen der Abfrage auswählen, um die Abfrage im Query Editor zu öffnen. Sie können auch die Suchleiste verwenden, um nach dem Namen einer Abfrage zu suchen. Bei Suchen wird zwischen Groß- und Kleinschreibung unterschieden.
SQL	Die ersten Zeichen der SQL-Abfrage. Wenn Sie den Mauszeiger über den Code bewegen, wird die vollständige Abfrage angezeigt.
Geändert von	Der letzte Benutzer, der die Abfrage geändert hat. Jeder Benutzer in Ihrer Organisation, der Zugriff auf Query Service hat, kann Abfragen ändern.
Zuletzt geändert	Datum und Uhrzeit der letzten Änderung der Abfrage in der Zeitzone des Browsers.

Siehe Abfragevorlagen Dokumentation finden Sie weitere Informationen zu Vorlagen in der Platform-Benutzeroberfläche.

Protokoll

Die Registerkarte Protokoll enthält eine Liste der Abfragen, die bereits ausgeführt wurden. Standardmäßig werden die Abfragen im Protokoll in umgekehrter chronologischer Reihenfolge aufgelistet.

Vergrößerte Ansicht der Registerkarte „Protokoll“ im Abfragen-Dashboard mit einer Liste von Abfragen in umgekehrter chronologischer Reihenfolge.

Spalte	Beschreibung
Name	Der Abfragename, der aus den ersten Zeichen der SQL-Abfrage besteht. Wählen Sie den Vorlagennamen aus, um den Details zum Abfrage-Protokoll anzeigen. Sie können die Suchleiste verwenden, um nach dem Namen einer Abfrage zu suchen. Bei Suchen wird zwischen Groß- und Kleinschreibung unterschieden.
Startzeit	Der Zeitpunkt, zu dem die Abfrage ausgeführt wurde.
Abschlusszeit	Die Zeit, zu der die Abfrage ausgeführt wurde.
Status	Der aktuelle Status der Abfrage.
Datensatz	Der von der Abfrage verwendete Eingabedatensatz. Wählen Sie den Datensatz aus, um zum Bildschirm mit den Details des Eingabedatensatzes zu gelangen.
Client	Der für die Abfrage verwendete Client.
Erstellt von	Der Name der Person, die die Abfrage erstellt hat.

!![Note]
Wählen Sie das Stiftsymbol () aus einer beliebigen Zeile des Abfrageprotokolls, um zur Query Editor. Die Abfrage wird vorab ausgefüllt, um die Bearbeitung zu erleichtern.

Siehe Dokumentation zu Abfrageprotokollen für weitere Informationen zu den Protokolldateien, die automatisch von einem Abfrageereignis generiert werden.

Anmeldeinformationen

Die Registerkarte Anmeldeinformationen zeigt sowohl Ihre ablaufenden als auch Ihre nicht ablaufenden Anmeldeinformationen an. Weitere Informationen zur Verwendung dieser Anmeldeinformationen für die Verbindung mit externen Clients finden Sie im Handbuch zu Anmeldeinformationen.

Das Dashboard „Abfragen“ mit hervorgehobener Registerkarte „Anmeldeinformationen“.

Nächste Schritte

Da Sie nun mit der Benutzeroberfläche des Query Service in Platform vertraut sind, können Sie auf Query Editor zugreifen, um Ihre eigenen Abfrageprojekte zu erstellen und diese für andere Benutzende in Ihrer Organisation freizugeben. Weitere Informationen zum Erstellen und Ausführen von Abfragen in Query Editor finden Sie im Query Editor Benutzerhandbuch.