Überwachen von geplanten Abfragen

Adobe Experience Platform bietet über die Benutzeroberfläche eine verbesserte Sichtbarkeit für den Status aller Abfrageaufträge. Aus dem Geplante Abfragen -Registerkarte finden Sie jetzt wichtige Informationen zu Ihren Abfrageausführungen, die den Status, die Planungsdetails und Fehlermeldungen/Codes für den Fall eines Fehlschlagens enthalten. Sie können über die Benutzeroberfläche auf der Registerkarte Geplante Abfragen für jede dieser Abfragen auch Benachrichtigungen für Abfragen basierend auf ihrem Status abonnieren.

Geplante Abfragen

Die Geplante Abfragen bietet einen Überblick über alle geplanten CTAS- und ITAS-Abfragen. Ausführungsdetails finden Sie für alle geplanten Abfragen sowie Fehlercodes und Meldungen für fehlgeschlagene Abfragen.

Um zur Registerkarte Geplante Abfragen zu navigieren, wählen Sie Abfragen in der linken Navigationsleiste und anschließend Geplante Abfragen

Auf der Registerkarte Geplante Abfragen im Arbeitsbereich Abfragen wurde die Option Geplante Abfragen und Abfragen hervorgehoben.

In der folgenden Tabelle werden die einzelnen verfügbaren Spalten beschrieben.

NOTE
Das Symbol für Abonnements von Warnhinweisen befindet sich in jeder Zeile in einer unbenannten Spalte. Weitere Informationen finden Sie im Abschnitt Abonnements von Warnhinweisen.
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, wird ihr Name zu einem Snippet der ursprünglichen SQL, die zur Erstellung der Abfrage verwendet wurde. Um eine Liste aller mit der Abfrage verknüpften Ausführungen anzuzeigen, wählen Sie ein Element aus der Name Spalte. Weitere Informationen finden Sie unter Abfragenausführungen Planungsdetails Abschnitt.
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ührungsfrequenz
Die Häufigkeit, mit 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.
Letzter Ausführungsstatus
Der Status der letzten Abfrageausführung. Die Statuswerte sind: Success, Failed, In progress, und No runs.
Planstatus

Der aktuelle Status der geplanten Abfrage. Es gibt fünf potenzielle Werte. Registrieren, Aktiv, Inaaktiv, Gelöschtund einen Bindestrich.

  • Der Bindestrich zeigt an, dass es sich bei der geplanten Abfrage um eine einmalige, nicht wiederkehrende Abfrage handelt.
  • Die Registrieren Der Status gibt an, dass das System die Erstellung des neuen Zeitplans für die Abfrage noch verarbeitet. Beachten Sie, dass Sie eine geplante Abfrage während der Registrierung nicht deaktivieren oder löschen können.
  • Die Aktiv Der Status zeigt an, dass die geplante Abfrage noch nicht bestanden Datum und Uhrzeit der Fertigstellung.
  • Die Inaaktiv Der Status zeigt an, dass die geplante Abfrage sent Datum und Uhrzeit der Fertigstellung.
  • Die Gelöscht status gibt an, dass der Abfrageplan gelöscht wurde.
TIP
Wenn Sie zum Abfrage-Editor navigieren, können Sie Abfragen auswählen, um zur Registerkarte Vorlagen zurückzukehren.

Anpassen von Tabelleneinstellungen für geplante Abfragen customize-table

Sie können die Spalten auf der Registerkarte Geplante Abfragen gemäß Ihren Anforderungen anpassen. So öffnen Sie die Tabelle anpassen Dialogfeld "Einstellungen"öffnen und verfügbare Spalten bearbeiten, das Einstellungssymbol ( Ein Einstellungssymbol. ) oben rechts im Bildschirm.

NOTE
Die Erstellt -Spalte, die sich auf das Datum der Erstellung des Zeitplans bezieht, ist standardmäßig ausgeblendet.

Auf der Registerkarte Geplante Abfragen wurde das Symbol Tabelleneinstellungen anpassen hervorgehoben.

Aktivieren bzw. deaktivieren Sie die entsprechenden Kontrollkästchen, um eine Tabellenspalte zu entfernen oder hinzuzufügen. Klicken Sie dann auf Übernehmen, um Ihre Auswahl zu bestätigen.

NOTE
Jede Abfrage, die über die Benutzeroberfläche erstellt wurde, wird als Teil des Erstellungsprozesses zu einer benannten Vorlage. Der Vorlagenname wird in der Vorlagenspalte angezeigt. Wenn die Abfrage über die API erstellt wurde, ist die Vorlagenspalte leer.

Der Dialog „Tabelleneinstellungen anpassen“.

Geplante Abfragen mit Inline-Aktionen verwalten inline-actions

Die Geplante Abfragen -Ansicht bietet verschiedene Inline-Aktionen zur Verwaltung aller Ihrer geplanten Abfragen von einem Ort aus. Inline-Aktionen werden in jeder Zeile mit Auslassungspunkten angezeigt. Wählen Sie die Auslassungspunkte einer geplanten Abfrage aus, die Sie verwalten möchten, um die verfügbaren Optionen in einem Popup-Menü anzuzeigen. Zu den verfügbaren Optionen gehören Zeitplan deaktivieren oder Zeitplan aktivieren, Zeitplan löschen, und Abonnieren , um Warnhinweise abzufragen.

Die Registerkarte Geplante Abfragen mit den Auslassungszeichen für die Inline-Aktion und dem Popup-Menü sind hervorgehoben.

Geplante Abfrage deaktivieren oder aktivieren disable

Um eine geplante Abfrage zu deaktivieren, wählen Sie die Auslassungspunkte einer geplanten Abfrage aus, die Sie verwalten möchten, und wählen Sie dann Zeitplan deaktivieren aus den Optionen im Popup-Menü. Es wird ein Dialogfeld angezeigt, in dem Sie Ihre Aktion bestätigen können. Auswählen Deaktivieren , um Ihre Einstellung zu bestätigen.

Nachdem eine geplante Abfrage deaktiviert wurde, können Sie den Zeitplan über denselben Prozess aktivieren. Wählen Sie die Auslassungspunkte aus und wählen Sie Zeitplan aktivieren aus den verfügbaren Optionen.

Geplante Abfrage löschen delete

Um eine geplante Abfrage zu löschen, wählen Sie die Auslassungspunkte einer geplanten Abfrage aus, die Sie verwalten möchten, und klicken Sie dann auf Zeitplan löschen aus den Optionen im Popup-Menü. Es wird ein Dialogfeld angezeigt, in dem Sie Ihre Aktion bestätigen können. Auswählen Löschen , um Ihre Einstellung zu bestätigen.

Nachdem eine geplante Abfrage gelöscht wurde, wird sie not aus der Liste der geplanten Abfragen entfernt. Die von den Ellipsen bereitgestellten Inline-Aktionen werden entfernt und durch das grau ausgeblendete Symbol Warnhinweis hinzufügen ersetzt. Sie können keine Warnungen für den gelöschten Zeitplan abonnieren. Die Zeile verbleibt in der Benutzeroberfläche, um Informationen über die im Rahmen der geplanten Abfrage durchgeführten Ausführungen bereitzustellen.

Die Registerkarte Geplante Abfragen mit einer gelöschten geplanten Abfrage und einem ausgegrauten Warnsymbol wurden hervorgehoben.

Wenn Sie die Ausführung dieser Abfragevorlage planen möchten, wählen Sie den Vorlagennamen aus der entsprechenden Zeile aus, um zum Abfrage-Editor zu navigieren, und folgen Sie dann dem Anweisungen zum Hinzufügen eines Zeitplans zu einer Abfrage wie in der Dokumentation beschrieben.

Warnhinweise abonnieren alert-subscription

Um Warnhinweise für geplante Abfrageausführungen zu abonnieren, wählen Sie die Auslassungspunkte einer geplanten Abfrage aus, die Sie verwalten möchten, und wählen Sie dann Abonnieren aus den Optionen im Popup-Menü.

Die Warnhinweise wird geöffnet. Die Warnhinweise -Dialogfeld abonniert sowohl Benachrichtigungen über die Benutzeroberfläche als auch E-Mail-Warnungen. Warnhinweise basieren auf dem Status der Abfrage. Dabei stehen drei Optionen zur Verfügung: start, success und failure. Markieren Sie die entsprechenden Kontrollkästchen und wählen Sie Speichern abonnieren. Sie können Warnhinweise abonnieren, solange sie keine Zeitstempel der letzten Ausführung -Wert.

Der Dialog zu Warnhinweis-Abonnements.

Siehe Dokumentation zur API für Warnhinweise für weitere Informationen.

Anzeigen der Abfragedetails query-details

Wählen Sie das Informationssymbol ( Ein Informationssymbol. ), um das Detailbedienfeld für die Abfrage anzuzeigen. Das Bedienfeld "Details"enthält alle relevanten Informationen über die Abfrage, die über die in der Tabelle der geplanten Abfragen enthaltenen Informationen hinausgehen. Zu den zusätzlichen Informationen gehören die Abfrage-ID, das Datum der letzten Änderung, die SQL der Abfrage, die Zeitplan-ID und der aktuelle Zeitplan.

Registerkarte Geplante Abfragen mit dem Informationssymbol und dem Detailbereich hervorgehoben.

Filtern von Abfragen filter

Sie können Abfragen nach der Ausführungsfrequenz filtern. Wählen Sie dazu über die Registerkarte Geplante Abfragen das Filtersymbol ( Filtersymbol ) aus, um die Filter-Seitenleiste zu öffnen.

Die Registerkarte „Geplante Abfragen“ mit hervorgehobenem Filtersymbol.

Um die Liste der Abfragen nach ihrer Ausführungsfrequenz zu filtern, wählen Sie entweder die Geplant oder Einmal ausführen Filter-Kontrollkästchen.

NOTE
Jede Abfrage, die ausgeführt, aber nicht geplant wurde, gilt als Einmal ausgeführt.

Die Registerkarte „Geplante Abfragen“ mit hervorgehobener Filter-Seitenleiste.

Nachdem Sie Ihre Filterkriterien aktiviert haben, wählen Sie Filter ausblenden aus, um den Filterbereich zu schließen.

Zeitplandetails für Abfragen query-runs

Um die Seite mit den Zeitplandetails zu öffnen, wählen Sie einen Abfragenamen aus dem Geplante Abfragen Registerkarte. Diese Ansicht enthält eine Liste aller im Rahmen dieser geplanten Abfrage ausgeführten Durchläufe. Die bereitgestellten Informationen umfassen die Anfangs- und Endzeit, den Status und den verwendeten Datensatz.

Die Seite mit den Zeitplandetails.

Diese Informationen werden in einer fünfspaltigen Tabelle bereitgestellt. Jede Zeile bezeichnet die Ausführung einer Abfrage.

Spaltenname
Beschreibung
Kennung der Abfrageausführung
Die Kennung der täglichen Ausführung der Abfrage. Wählen Sie die Kennung der Abfrageausführung , um zur Übersicht über die Ausführung von Abfragen.
Start der Abfrage
Der Zeitstempel, wann die Abfrage ausgeführt wurde. Der Zeitstempel hat das UTC-Format.
Abschluss der Abfrage
Der Zeitstempel, wann die Abfrage abgeschlossen wurde. Der Zeitstempel hat das UTC-Format.
Status
Der Status der letzten Abfrageausführung. Die drei Statuswerte sind successful, failed oder in progress.
Datensatz
Der an der Ausführung beteiligte Datensatz.

Details zur geplanten Abfrage finden Sie im Bedienfeld Eigenschaften. Dieses Bedienfeld enthält die anfängliche Abfrage-ID, den Client-Typ, den Vorlagennamen, die Abfrage-SQL und die Kadenz des Zeitplans.

Die Seite mit den Zeitplandetails mit hervorgehobenem Eigenschaftenbereich.

Wählen Sie eine ID für die Abfrageausführung aus, um zur Seite mit den Ausführungsdetails zu navigieren und Abfrageinformationen anzuzeigen.

Der Bildschirm mit den Zeitplandetails mit einer hervorgehobenen Ausführungs-ID.

Übersicht über die Ausführung von Abfragen query-run-overview

Die Übersicht über die Ausführung von Abfragen enthält Informationen zu einzelnen Ausführungen für diese geplante Abfrage und eine detailliertere Aufschlüsselung des Ausführungsstatus. Auf dieser Seite finden Sie außerdem die Client-Informationen und Details zu Fehlern, die dazu geführt haben, dass die Abfrage fehlschlägt.

Der Bildschirm mit den Ausführungsdetails mit hervorgehobenem Übersichtsabschnitt.

Der Abschnitt „Abfragestatus“ enthält den Fehler-Code und die Fehlermeldung, falls die Abfrage fehlschlägt.

Der Bildschirm mit den Ausführungsdetails mit hervorgehobenem Fehlerabschnitt.

Sie können die Abfrage-SQL aus dieser Ansicht in die Zwischenablage kopieren. Um die Abfrage zu kopieren, wählen Sie das Kopiersymbol oben rechts im SQL-Snippet aus. Eine Popup-Meldung bestätigt, dass der Code kopiert wurde.

Der Bildschirm mit den Ausführungsdetails mit hervorgehobenem Symbol „SQL-Kopie“.

Ausführliche Informationen zu Abfragen mit anonymen Bausteinen anonymous-block-queries

Abfragen, die anonyme Bausteine verwenden, um ihre SQL-Anweisungen zu enthalten, werden in ihre einzelnen Unterabfragen unterteilt. Durch die Trennung in Unterabfragen können Sie die Ausführungsdetails für jeden Abfrageblock einzeln überprüfen.

NOTE
Die Ausführungsdetails eines anonymen Bausteins, der den Befehl DROP verwendet, werden not als separate Unterabfrage gemeldet werden. Separate Ausführungsdetails sind für CTAS-Abfragen, ITAS-Abfragen und COPY-Anweisungen verfügbar, die als anonyme Block-Subabfragen verwendet werden. Ausführungsdetails für den DROP-Befehl werden derzeit nicht unterstützt.

Anonyme Bausteine werden mithilfe eines $$ -Präfix vor der Abfrage. Weitere Informationen zu anonymen Bausteinen im Abfragedienst finden Sie im Abschnitt Anonym-Blockdokument.

Unterabfragen anonymer Bausteine verfügen über Registerkarten links neben dem Ausführungsstatus. Wählen Sie eine Registerkarte aus, um die Ausführungsdetails anzuzeigen.

Die Übersicht über die Ausführung von Abfragen mit einer anonymen Blockabfrage. Die Tabs für mehrere Abfragen sind hervorgehoben.

Wenn eine anonyme Blockabfrage fehlschlägt, können Sie über diese Benutzeroberfläche den Fehlercode für diesen Baustein finden.

Die Übersicht über die Abfrage-Ausführung zeigt eine anonyme Blockabfrage an, wobei der Fehlercode für einen einzelnen Block hervorgehoben ist.

Wählen Sie Abfrage aus, um zum Bildschirm mit den Zeitplandetails zurückzukehren, oder wählen Sie Geplante Abfragen aus, um zur Registerkarte Geplante Abfragen zurückzukehren.

Der Bildschirm mit den Ausführungsdetails mit hervorgehobener Abfrage.

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