Ü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
Über das Symbol Abonnements für Warnhinweise ( Ein Symbol für Warnungen-Abonnements. ) ist in jeder Zeile einer unbenannten Spalte enthalten. 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 verfügbaren Werte sind Run once und Scheduled.
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 sechs potenzielle Werte. Registrieren, Aktiv, Inaaktiv, Gelöscht, einen Bindestrich und In Quarantäne.

  • 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 oder wurde von einem Benutzer als inaktiv markiert.
  • Die Gelöscht status gibt an, dass der Abfrageplan gelöscht wurde.
  • Der Bindestrich zeigt an, dass es sich bei der geplanten Abfrage um eine einmalige, nicht wiederkehrende Abfrage handelt.
  • Die In Quarantäne Der Status gibt an, dass die Abfrage zehn aufeinander folgende Ausführungen fehlgeschlagen ist, und erfordert Ihre Intervention, bevor weitere Ausführungen durchgeführt werden können.
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, Abonnieren Warnhinweise abfragen und Aktivieren oder Quarantäne deaktivieren.

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 Auslassungszeichen für die geplante Abfrage aus, die Sie verwalten möchten, und klicken Sie dann auf 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.

NOTE
Wenn eine Abfrage in Quarantäne gestellt wurde, sollten Sie die SQL-Anweisung der Vorlage lesen, bevor Sie deren Planung aktivieren. Dadurch wird verhindert, dass Rechenzeiten verschwendet werden, wenn die Vorlagenabfrage weiterhin Probleme hat.

Geplante Abfrage löschen delete

Um eine geplante Abfrage zu löschen, wählen Sie die Auslassungszeichen für die geplante 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 ausgegraute Symbol Warnhinweis-Abonnement 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 Warnhinweissymbol wurde 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 entweder die ... (Auslassungszeichen) oder Warnhinweissymbol ( Ein Warnungsabonnementsymbol. ) für die geplante Abfrage, die Sie verwalten möchten. Das Dropdown-Menü für Inline-Aktionen wird angezeigt. Wählen Sie als Nächstes Abonnieren aus den verfügbaren Optionen.

Der Arbeitsbereich für geplante Abfragen mit Auslassungspunkten, das Symbol für die Anmeldung und das Dropdown-Menü für Inline-Aktionen werden hervorgehoben.

Die Warnhinweise wird geöffnet. Die Warnhinweise -Dialogfeld abonniert sowohl Benachrichtigungen über die Benutzeroberfläche als auch E-Mail-Warnungen. Es stehen mehrere Optionen für die Anmeldung von Warnhinweisen zur Verfügung: start, success, failure, quarantine, und delay. Aktivieren Sie die entsprechenden Kontrollkästchen und klicken Sie auf Speichern, um zu abonnieren.

Der Dialog zu Warnhinweis-Abonnements.

In der folgenden Tabelle werden die unterstützten Abfragewarnungstypen erläutert:

Warnungstyp
Beschreibung
start
Dieser Warnhinweis benachrichtigt Sie, wenn eine geplante Abfrage gestartet wird oder mit der Verarbeitung beginnt.
success
Dieser Warnhinweis informiert Sie darüber, wenn eine geplante Abfrage erfolgreich ausgeführt wurde, und zeigt an, dass die Abfrage fehlerfrei ausgeführt wurde.
failed
Dieser Warnhinweis wird Trigger, wenn eine geplante Abfrage einen Fehler auftritt oder nicht erfolgreich ausgeführt werden kann. Dies hilft Ihnen, Probleme schnell zu identifizieren und zu beheben.
quarantine
Dieser Warnhinweis wird aktiviert, wenn eine geplante Abfrage unter Quarantäne gestellt wird. Wenn Abfragen in die Quarantänefunktion, werden alle geplanten Abfragen, bei denen zehn aufeinander folgende Ausführungen fehlschlagen, automatisch in In Quarantäne state. Danach müssen Sie eingreifen, bevor weitere Ausführungen erfolgen können.
delay
Dieser Warnhinweis benachrichtigt Sie, wenn ein Verzögerung im Ergebnis einer Abfrageausführung über einen bestimmten Schwellenwert hinaus. Sie können einen benutzerdefinierten Zeitpunkt festlegen, zu dem der Warnhinweis Trigger wird, wenn die Abfrage für diesen Zeitraum ausgeführt wird, ohne dass ein Abschluss oder ein Fehler auftritt.
NOTE
Um darüber informiert zu werden, dass Abfragen unter Quarantäne gestellt werden, müssen Sie zunächst die geplanten Abfragen in der Quarantänefunktion.

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.

Quarantäne-Abfragen quarantined-queries

NOTE
Der Quarantäne-Warnhinweis ist nicht für Ad-hoc-Abfragen zur einmaligen Ausführung verfügbar. Der Quarantäne-Warnhinweis gilt nur für geplante Batch-Abfragen (CTAS und ITAS).

Bei der Registrierung für die Quarantänefunktion wird jede geplante Abfrage, die zehn aufeinander folgende Ausführungen fehlschlägt, automatisch in eine In Quarantäne -Status. Eine Abfrage mit diesem Status wird inaktiv und wird nicht in der geplanten Häufigkeit ausgeführt. Danach müssen Sie eingreifen, bevor weitere Ausführungen erfolgen können. Dadurch werden Systemressourcen geschützt, da Sie die Probleme mit Ihrer SQL vor weiteren Ausführungen überprüfen und korrigieren müssen.

Um eine geplante Abfrage für die Quarantänefunktion zu aktivieren, wählen Sie die Auslassungszeichen (...) gefolgt von Quarantäne aktivieren aus dem angezeigten Dropdown-Menü.

Die Registerkarte für geplante Abfragen mit den Auslassungspunkten und Quarantäne aktivieren , die im Dropdown-Menü für Inline-Aktionen hervorgehoben sind.

Abfragen können während der Erstellung eines Zeitplans auch in die Quarantänefunktion aufgenommen werden. Siehe Dokumentation zu Abfrageplänen für weitere Informationen.

Verzögerung bei Abfrage-Ausführung query-run-delay

Halten Sie die Kontrolle über Ihre Berechnungszeiten, indem Sie Warnhinweise für Abfrageverzögerungen einrichten. Sie können die Abfrageleistung überwachen und Benachrichtigungen empfangen, wenn der Status einer Abfrage nach einem bestimmten Zeitraum unverändert bleibt. Verwenden Sie denVerzögerung bei Abfrage-Ausführung' Warnhinweis, der benachrichtigt wird, wenn eine Abfrage nach einem bestimmten Zeitraum weiter verarbeitet wird, ohne abgeschlossen zu sein.

Wenn Sie Warnhinweise abonnieren Bei geplanten Abfrageausführungen ist einer der verfügbaren Warnhinweise der Verzögerung bei Abfrage-Ausführung. Für diesen Warnhinweis müssen Sie einen Schwellenwert für die auszuführende Zeit festlegen. An diesem Punkt werden Sie über die Verzögerung bei der Verarbeitung informiert.

Um eine Schwellendauer festzulegen, für die die Benachrichtigung Trigger wird, geben Sie entweder eine Zahl in das Texteingabefeld ein oder erhöhen Sie mithilfe der Nach-oben- und Nach-unten-Pfeile um eine Minute. Da der Schwellenwert in Minuten festgelegt wird, beträgt die maximale Dauer für die Beobachtung einer Ausführungsverzögerung einer Abfrage 1440 Minuten (24 Stunden). Der Standardzeitraum für eine Laufzeitverzögerung beträgt 150 Minuten.

NOTE
Eine Abfrage kann nur eine einzige Laufzeitverzögerung aufweisen. Wenn Sie die Verzögerungsschwelle ändern, wird sie für Benutzer, die sich für den Warnhinweis angemeldet haben, und für Ihre gesamte Organisation geändert.

Das Dialogfeld Warnhinweise auf der Registerkarte für geplante Abfragen mit dem Eingabefeld für die Abfrageausführungsverzögerung wurde hervorgehoben.

Weitere Informationen finden Sie im Abschnitt Warnhinweise abonnieren . abonnieren von Verzögerung bei Abfrage-Ausführung Warnungen.

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 Statuswerte sind: Success, Failed, In progressoder Quarantined.
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 der Abfrageausführung 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