Abfragepläne

Sie können die Ausführung von Abfragen automatisieren, indem Sie Abfragepläne erstellen. Geplante Abfragen werden in einer benutzerdefinierten Platzierung ausgeführt, um Ihre Daten basierend auf Häufigkeit, Datum und Uhrzeit zu verwalten. Sie können bei Bedarf auch einen Ausgabedatensatz für Ihre Ergebnisse auswählen. Abfragen, die als Vorlage gespeichert wurden, können im Abfrage-Editor geplant werden.

IMPORTANT
Sie können einen Zeitplan nur zu einer bereits erstellten und gespeicherten Abfrage hinzufügen.

Alle geplanten Abfragen werden der Liste im Geplante Abfragen Registerkarte. Von diesem Arbeitsbereich aus können Sie den Status aller geplanten Abfrageaufträge über die Benutzeroberfläche überwachen. Im Geplante Abfragen finden Sie wichtige Informationen zu Ihren Abfrageausführungen und abonnieren Warnungen. Zu den verfügbaren Informationen gehören Status, Planungsdetails und Fehlermeldungen/Codes für den Fall, dass eine Ausführung fehlschlägt. Siehe Dokument zur Überwachung geplanter Abfragen für weitere Informationen.

Dieser Workflow behandelt den Planungsprozess in der Benutzeroberfläche von Query Service. Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie im Handbuch zu Endpunkten für geplante Abfragen.

Erstellen eines Abfragezeitplans create-schedule

Um eine Abfrage zu planen, wählen Sie eine Abfragevorlage aus dem Vorlagen oder Vorlage Spalte Geplante Abfragen Registerkarte. Durch Auswahl des Vorlagennamen gelangen Sie zum Abfrage-Editor.

Wenn Sie über den Abfrage-Editor auf eine gespeicherte Abfrage zugreifen, können Sie einen Zeitplan für die Abfrage erstellen oder den Zeitplan der Abfrage im Detailbereich anzeigen.

TIP
Auswählen Zeitplan anzeigen um zum Arbeitsbereich "Zeitpläne"zu navigieren und geplante Abfragen auf einen Blick anzuzeigen.

Der Abfrage-Editor mit Zeitplan anzeigen und Zeitplan hinzufügen hervorgehoben.

Auswählen Zeitplan hinzufügen , um zur Seite mit Zeitplandetails.

Alternativ können Sie die Zeitpläne unter dem Namen der Abfrage klicken.

Der Abfrage-Editor mit der hervorgehobenen Registerkarte „Zeitpläne“.

Der Arbeitsbereich für Zeitpläne wird angezeigt. Die Benutzeroberfläche zeigt eine Liste aller geplanten Ausführungen an, mit denen die Vorlage verknüpft ist. Wählen Sie Zeitplan hinzufügen aus, um einen Zeitplan zu erstellen.

Der Arbeitsbereich „Zeitplan“ des Abfrage-Editors mit hervorgehobener Option „Zeitplan hinzufügen“.

Hinzufügen von Planungsdetails schedule-details

Die Seite mit den Zeitplandetails wird angezeigt. Auf dieser Seite können Sie verschiedene Details für die geplante Abfrage bearbeiten. Zu den Details gehören: Häufigkeit und Wochentag der geplanten Abfrage Ausführen, Start- und Enddatum, Datensatz, in den die Ergebnisse exportiert werden sollen, und Warnungen zum Abfragestatus.

Das hervorgehobene Bedienfeld „Zeitplandetails“.

Geplante Abfragefrequenz scheduled-query-frequency

Für Häufigkeit können Sie die folgenden Optionen auswählen:

  • Stündlich: Die geplante Abfrage wird im ausgewählten Datumsbereich stündlich ausgeführt.
  • Täglich: Die geplante Abfrage wird alle X Tage zum ausgewählten Zeitpunkt und im ausgewählten Zeitraum ausgeführt. Beachten Sie, dass die ausgewählte Zeit in UTC angegeben ist, nicht in Ihrer lokalen Zeitzone.
  • Wöchentlich: Die ausgewählte Abfrage wird an den ausgewählten Wochentagen, zur ausgewählten Uhrzeit und im ausgewählten Datumsbereich ausgeführt. Beachten Sie, dass die ausgewählte Zeit in UTC angegeben ist, nicht in Ihrer lokalen Zeitzone.
  • Monatlich: Die ausgewählte Abfrage wird jeden Monat am ausgewählten Tag, zur ausgewählten Uhrzeit und im ausgewählten Datumsbereich ausgeführt. Beachten Sie, dass die ausgewählte Zeit in UTC angegeben ist, nicht in Ihrer lokalen Zeitzone.
  • Jährlich: Die ausgewählte Abfrage wird jedes Jahr am ausgewählten Tag, im ausgewählten Monat, zur ausgewählten Uhrzeit und im ausgewählten Datumsbereich ausgeführt. Beachten Sie, dass die ausgewählte Zeit in UTC angegeben ist, nicht in Ihrer lokalen Zeitzone.

Bereitstellen von Datensatzdetails dataset-details

Verwalten Sie die Abfrageergebnisse, indem Sie entweder die Daten an einen vorhandenen Datensatz anhängen oder einen neuen Datensatz erstellen und die Daten daran anhängen.

Auswählen Erstellen und Anhängen an einen neuen Datensatz , um einen Datensatz zu erstellen, wenn Sie eine Abfrage zum ersten Mal ausführen. Nachfolgende Ausführungen fügen weiterhin Daten in diesen Datensatz ein. Geben Sie abschließend einen Namen und eine Beschreibung für den Datensatz an.

IMPORTANT
Da Sie entweder einen vorhandenen Datensatz verwenden oder einen neuen Datensatz erstellen, müssen Sie weder INSERT INTO noch CREATE TABLE AS SELECT als Teil die Abfrage einbeziehen, da die Datensätze bereits festgelegt sind. Das Einbeziehen von INSERT INTO oder CREATE TABLE AS SELECT als Teil Ihrer geplanten Abfragen führt zu einem Fehler.

Das Bedienfeld Zeitplandetailsmit Datensatzdetails und dem Erstellen und Anhängen an einen neuen Datensatz hervorgehobene Optionen.

Wählen Sie alternativ An vorhandenen Datensatz anhängen gefolgt vom Datensatzsymbol ( Das Datensatzsymbol. ).

Das Bedienfeld Zeitplandetails mit Datensatzdetails und In vorhandenen Datensatz anhängen wurde hervorgehoben.

Die Ausgabedatensatz auswählen angezeigt.

Navigieren Sie anschließend entweder zu den vorhandenen Datensätzen oder verwenden Sie das Suchfeld, um die Optionen zu filtern. Wählen Sie die Zeile des Datensatzes aus, die Sie verwenden möchten. Die Datensatzdetails werden im Bereich auf der rechten Seite angezeigt. Auswählen Fertig um Ihre Wahl zu bestätigen.

Das Dialogfeld Ausgabedatensatz auswählen mit dem Suchfeld, einer Datensatzzeile und hervorgehoben Fertig .

Abfragen in Quarantäne stellen, wenn sie ständig fehlschlagen quarantine

Bei der Erstellung eines Zeitplans können Sie Ihre Abfrage in der Quarantänefunktion registrieren, um Systemressourcen zu schützen und potenzielle Unterbrechungen zu vermeiden. Die Quarantänefunktion identifiziert und isoliert Abfragen, die wiederholt fehlschlagen, automatisch, indem sie sie in einer In Quarantäne state. Durch Quarantäne von Abfragen nach zehn aufeinander folgenden Fehlern können Sie Probleme eingreifen, überprüfen und beheben, bevor Sie weitere Ausführungen zulassen. Dies hilft Ihnen bei der Aufrechterhaltung Ihrer betrieblichen Effizienz und Datenintegrität.

Der Arbeitsbereich Zeitpläne für Abfragenmit Abfrage-Quarantäne markiert und Ja ausgewählt ist.

Nachdem eine Abfrage für die Quarantänefunktion registriert wurde, können Sie Warnhinweise für diese Änderung des Abfragestatus abonnieren. Wenn eine geplante Abfrage nicht unter Quarantäne gestellt wird, wird sie nicht als Option für das Dialogfeld "Warnungen".

Sie können auch eine geplante Abfrage über die Inline-Aktionen der Funktion Geplante Abfragen Registerkarte. Siehe Dokumentation zu Überwachungsabfragen für weitere Details.

Warnhinweise für den Status einer geplanten Abfrage festlegen alerts-for-query-status

Sie können im Rahmen Ihrer geplanten Abfrageeinstellungen auch Abfragewarnungen abonnieren. Sie können Ihre Einstellungen so konfigurieren, dass Benachrichtigungen für eine Vielzahl von Situationen empfangen werden. Warnhinweise können für einen Quarantänestatus, Verzögerungen bei der Abfrageverarbeitung oder eine Statusänderung Ihrer Abfrage festgelegt werden. Zu den verfügbaren Warnungsoptionen für den Abfragestatus gehören Start, Erfolg und Fehler. Warnhinweise können entweder als Popup-Benachrichtigungen oder E-Mails empfangen werden. Aktivieren Sie das Kontrollkästchen, um Warnhinweise für diesen Status der geplanten Abfrage zu abonnieren.

Das Bedienfeld Zeitplandetails mit hervorgehobenen Warnhinweisoptionen.

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. Sobald eine Abfrage Eingeschrieben in die Quarantänefunktion, werden alle geplanten Abfragen, bei denen zehn aufeinander folgende Ausführungen fehlschlagen, automatisch in In Quarantäne state. Eine in Quarantäne befindliche Abfrage erfordert Ihre Intervention, bevor weitere Ausführungen durchgeführt werden können. Hinweis: Für die Quarantänefunktion müssen Abfragen registriert werden, damit Sie Benachrichtigungen unter Quarantäne stellen können.
delay
Dieser Warnhinweis benachrichtigt Sie, wenn ein Verzögerung im Ergebnis einer geplanten Abfrageausführung über einen bestimmten Schwellenwert hinaus. Sie können einen benutzerdefinierten Zeitpunkt festlegen, zu dem die Warnung Trigger wird, wenn die Abfrage für diesen Zeitraum ausgeführt wird, ohne dass ein Abschluss oder ein Fehler auftritt. Das Standardverhalten setzt einen Warnhinweis für 150 Minuten, nachdem die Verarbeitung der Abfrage begonnen hat.
NOTE
Wenn Sie eine Verzögerung bei Abfrage-Ausführung Warnhinweis hinweisen, müssen Sie die gewünschte Verzögerungszeit in Minuten in der Platform-Benutzeroberfläche festlegen. Geben Sie die Dauer in Minuten ein. Die maximale Verzögerung beträgt 24 Stunden (1440 Minuten).

Einen Überblick über Warnhinweise in Adobe Experience Platform, einschließlich der Struktur der Definition von Warnregeln, finden Sie im Abschnitt Warnungen - Übersicht. Eine Anleitung zum Verwalten von Warnhinweisen und Warnregeln in der Adobe Experience Platform-Benutzeroberfläche finden Sie im Abschnitt Handbuch zur Warnhinweis-Benutzeroberfläche.

Festlegen von Parametern für eine geplante parametrisierte Abfrage set-parameters

IMPORTANT
Die Funktion der parametrisierten Abfragebenutzeroberfläche ist derzeit in einer Nur begrenzte Version und ist nicht für alle Kunden verfügbar. Wenn Sie keinen Zugriff auf parametrierte Abfragen haben, fahren Sie mit dem Zeitplan löschen oder deaktivieren Abschnitt.

Wenn Sie eine geplante Abfrage für eine parametrisierte Abfrage erstellen, müssen Sie jetzt die Parameterwerte für diese Abfrageausführungen festlegen.

Der Abschnitt Planungsdetails des Workflows zur Planerstellung mit dem Abschnitt Abfrageparameter wurde hervorgehoben.

Wählen Sie nach Bestätigung Ihrer Planungsdetails Speichern um einen Zeitplan zu erstellen. Sie werden zum Tab Zeitpläne Ihrer Vorlage zurückgeleitet. In diesem Arbeitsbereich werden Details zum neu erstellten Zeitplan angezeigt, einschließlich der Zeitplan-ID, des Zeitplans selbst und des Ausgabedatensatzes des Zeitplans.

Geplante Abfrageausführungen anzeigen scheduled-query-runs

Aus der Vorlage Zeitpläne wählen Sie die Zeitplan-ID aus, um zur Liste der Abfrageausführungen für Ihre neu geplante Abfrage zu navigieren.

Der Arbeitsbereich für Zeitpläne mit dem hervorgehobenen neu erstellten Zeitplan.

Sie haben auch die Möglichkeit, eine Liste der geplanten Ausführungen einer Abfragevorlage anzuzeigen, indem Sie zur Geplante Abfragen und wählen Sie einen Vorlagennamen aus der verfügbaren Liste aus.

Die Registerkarte Geplante Abfragen mit einer benannten Vorlage wurde hervorgehoben.

Die Liste der ausgeführten Abfragen für diese geplante Abfrage wird angezeigt.

Der Detailabschnitt des Arbeitsbereichs Geplante Abfragen mit einer Liste von Abfragen wird für eine geplante Abfrage hervorgehoben.

Siehe Handbuch zur Überwachung geplanter Abfragen für vollständige Informationen zur Überwachung des Status aller Abfrageaufträge über die Benutzeroberfläche.

Wählen Sie eine Kennung der Abfrageausführung aus der Liste, um zur Übersicht über die Abfrageausführung zu navigieren. Für eine vollständige Aufschlüsselung der verfügbaren Informationen über Abfragenlaufübersichtfinden Sie Informationen in der Dokumentation zur Überwachung geplanter Abfragen .

Informationen zum Überwachen geplanter Abfragen mithilfe der Query Service-API finden Sie in der Handbuch zu geplanten Abfrage-Run-Endpunkten.

Zeitplan aktivieren, deaktivieren oder löschen delete-schedule

Sie können einen Zeitplan im Arbeitsbereich Zeitpläne einer bestimmten Abfrage oder im Geplante Abfragen Arbeitsbereich, der alle geplanten Abfragen auflistet.

So greifen Sie auf die Zeitpläne im Tab der von Ihnen ausgewählten Abfrage den Namen einer Abfragevorlage aus dem Vorlagen oder Geplante Abfragen Registerkarte. Dadurch wird zum Abfrage-Editor für diese Abfrage navigiert. Wählen Sie im Abfrage-Editor Zeitpläne , um auf den Arbeitsbereich Zeitpläne zuzugreifen.

Wählen Sie einen Zeitplan aus den Zeilen der verfügbaren Zeitpläne aus, um den Detailbereich zu füllen. Verwenden Sie den Umschalter, um die geplante Abfrage zu deaktivieren (oder zu aktivieren).

Löschen deaktivierter Abfragen

IMPORTANT
Sie müssen einen Zeitplan deaktivieren, bevor Sie ihn für eine Abfrage löschen können.

Die Liste der Zeitpläne einer Vorlage mit hervorgehobenem Detailbereich.

Ein Bestätigungsdialogfeld wird angezeigt. Auswählen Deaktivieren , um die Aktion zu bestätigen.

Das Dialogfeld Planungsbestätigung deaktivieren .

Wählen Sie Zeitplan löschen aus, um den deaktivierten Zeitplan zu löschen.

Der Arbeitsbereich Zeitplänemit hervorgehobenem Löschplan.

Alternativ kann die Variable Geplante Abfragen bietet eine Sammlung von Inline-Aktionen für jede geplante Abfrage. Zu den verfügbaren Inline-Aktionen gehören Zeitplan deaktivieren oder Zeitplan aktivieren, Zeitplan löschen, und Abonnieren auf Warnhinweise für die geplante Abfrage. Vollständige Anweisungen zum Löschen oder Deaktivieren einer geplanten Abfrage über die Registerkarte "Geplante Abfragen"finden Sie in der Handbuch zur Überwachung geplanter Abfragen.

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