Überwachen von geplanten Abfragen
Adobe Experience Platform bietet über die Benutzeroberfläche eine verbesserte Sichtbarkeit für den Status aller Abfrageaufträge. Auf der Registerkarte Geplante Abfragen finden Sie jetzt wichtige Informationen zu Ihren Abfrageausführungen, die Status, Planungsdetails und Fehlermeldungen/-codes enthalten, falls sie fehlschlagen. 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 Registerkarte 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
In der folgenden Tabelle werden die einzelnen verfügbaren Spalten beschrieben.
Run once
und Scheduled
.Success
, Failed
, In progress
und No runs
.Der aktuelle Status der geplanten Abfrage. Es gibt sechs potenzielle Werte: Registering, Active, Inaktiv, Gelöscht, einen Bindestrich und In Quarantäne.
- Der Status Registering 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.
- Der Status Aktiv zeigt an, dass die geplante Abfrage ihr Abschlussdatum und ihre Endzeit noch nicht überschritten hat.
- Der Status Inaktiv zeigt an, dass die geplante Abfrage ihr Abschlussdatum und ihre Endzeit überschritten hat oder von einem Benutzer als inaktiv markiert wurde.
- Der Status Gelöscht zeigt an, dass der Abfragezeitplan gelöscht wurde.
- Der Bindestrich zeigt an, dass es sich bei der geplanten Abfrage um eine einmalige, nicht wiederkehrende Abfrage handelt.
- Der Status In Quarantäne zeigt an, dass die Abfrage zehn aufeinander folgende Ausführungen fehlgeschlagen ist, und erfordert Ihre Intervention, bevor weitere Ausführungen durchgeführt werden können.
Anpassen von Tabelleneinstellungen für geplante Abfragen customize-table
Sie können die Spalten auf der Registerkarte Geplante Abfragen gemäß Ihren Anforderungen anpassen. Um das Dialogfeld Tabellen-Einstellungen anpassen zu öffnen und verfügbare Spalten zu bearbeiten, wählen Sie das Einstellungssymbol ( ) oben rechts auf dem Bildschirm.
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.
Geplante Abfragen mit Inline-Aktionen verwalten inline-actions
Die Ansicht Geplante Abfragen bietet verschiedene Inline-Aktionen, um alle Ihre geplanten Abfragen von einem Ort aus zu verwalten. 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 für Abfragen von Warnhinweisen und Aktivieren oder Quarantäne deaktivieren.
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 wählen Sie dann Zeitplan deaktivieren aus den Optionen im Popup-Menü aus. Es wird ein Dialogfeld angezeigt, in dem Sie Ihre Aktion bestätigen können. Wählen Sie Deaktivieren aus, 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 Auslassungszeichen aus und wählen Sie dann Zeitplan aktivieren aus den verfügbaren Optionen aus.
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 wählen Sie dann Zeitplan löschen aus den Optionen im Popup-Menü aus. Es wird ein Dialogfeld angezeigt, in dem Sie Ihre Aktion bestätigen können. Wählen Sie Löschen aus, um Ihre Einstellung zu bestätigen.
Nachdem eine geplante Abfrage gelöscht wurde, wird sie nicht 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.
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 befolgen Sie dann die 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 das Symbol "...
"(mit Auslassungszeichen) oder das Abonnementsymbol für Warnhinweise (
) 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 aus.
Das Dialogfeld Warnhinweise wird geöffnet. Das Dialogfeld Warnungen meldet Sie sowohl für Benutzeroberflächenbenachrichtigungen als auch für E-Mail-Warnungen. Es stehen mehrere Optionen für die Warnung-Anmeldung zur Verfügung: start
, success
, failure
, quarantine
und delay
. Aktivieren Sie die entsprechenden Kontrollkästchen und klicken Sie auf Speichern, um zu abonnieren.
In der folgenden Tabelle werden die unterstützten Abfragewarnungstypen erläutert:
start
success
failed
quarantine
delay
Weitere Informationen finden Sie in der Dokumentation zur API für Warnhinweise🔗 .
Anzeigen der Abfragedetails query-details
Wählen Sie das 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.
Quarantäne-Abfragen quarantined-queries
Bei der Registrierung für die Quarantänefunktion wird jede geplante Abfrage, die zehn aufeinander folgende Ausführungen fehlschlägt, automatisch in den Status In Quarantäne gestellt versetzt. 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ü aus.
Abfragen können während der Erstellung eines Zeitplans auch in die Quarantänefunktion aufgenommen werden. Weitere Informationen finden Sie in der Dokumentation zu Abfrageplänen .
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 den Warnhinweis "Abfragelaufverzögerung", um benachrichtigt zu werden, wenn eine Abfrage nach einem bestimmten Zeitraum weiter verarbeitet wird, ohne abgeschlossen zu sein.
Wenn Sie Warnhinweise abonnieren für geplante Abfrageausführungen, ist einer der verfügbaren Warnhinweise die Verzögerung bei der Abfrageausfü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.
Im Abschnitt Warnhinweise abonnieren erfahren Sie, wie Sie Warnhinweise abonnierenVerzögerung bei der Abfrageausführung}.
Filtern von Abfragen filter
Sie können Abfragen nach der Ausführungsfrequenz filtern. Wählen Sie dazu über die Registerkarte Geplante Abfragen das Filtersymbol ( ) aus, um die Filter-Seitenleiste zu öffnen.
Um die Liste der Abfragen nach ihrer Ausführungsfrequenz zu filtern, aktivieren Sie entweder die Kontrollkästchen Geplant oder Einmal ausführen .
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 auf der Registerkarte Geplante Abfragen einen Abfragenamen aus. 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.
Diese Informationen werden in einer fünfspaltigen Tabelle bereitgestellt. Jede Zeile bezeichnet die Ausführung einer Abfrage.
Success
, Failed
, In progress
oder Quarantined
.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.
Wählen Sie eine ID für die Abfrageausführung aus, um zur Seite mit den Ausführungsdetails zu navigieren und Abfrageinformationen anzuzeigen.
Übersicht der Abfrageausführung query-run-overview
Die Übersicht über die Abfrage-Ausführung enthält Informationen zu den 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 Abschnitt „Abfragestatus“ enthält den Fehler-Code und die Fehlermeldung, falls die Abfrage fehlschlägt.
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.
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.
Anonyme Bausteine werden durch das Präfix "$$
" vor der Abfrage gekennzeichnet. Weitere Informationen zu anonymen Bausteinen im Abfragedienst finden Sie im Dokument Anonymer Baustein .
Unterabfragen anonymer Bausteine verfügen über Registerkarten links neben dem Ausführungsstatus. Wählen Sie eine Registerkarte aus, um die Ausführungsdetails anzuzeigen.
Wenn eine anonyme Blockabfrage fehlschlägt, können Sie über diese Benutzeroberfläche den Fehlercode für diesen Baustein finden.
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.