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.
Alle geplanten Abfragen werden der Liste auf der Registerkarte Geplante Abfragen hinzugefügt. Von diesem Arbeitsbereich aus können Sie den Status aller geplanten Abfrageaufträge über die Benutzeroberfläche überwachen. Auf der Registerkarte 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. Weitere Informationen finden Sie im Dokument Terminierte Abfragen überwachen .
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 entweder auf der Registerkarte Vorlagen oder in der Spalte Vorlage der Registerkarte Geplante Abfragen eine Abfragevorlage aus. 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.
Wählen Sie Zeitplan hinzufügen aus, um zur Seite Details des Zeitplans zu navigieren.
Alternativ können Sie die Registerkarte Zeitpläne unter dem Namen der Abfrage auswählen.
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.
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 die Häufigkeit und der Wochentag der geplanten Abfrage-Ausführung, das Start- und Enddatum, der Datensatz, in den die Ergebnisse exportiert werden sollen, und Warnhinweise zum Abfragestatus.
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.
Wählen Sie Erstellen und an neuen Datensatz anhängen aus, 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.
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.
Wählen Sie alternativ In vorhandenen Datensatz anhängen und danach das Datensatzsymbol (
Das Dialogfeld Ausgabedatensatz auswählen wird 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. Wählen Sie Fertig aus, um Ihre Auswahl zu bestätigen.
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 den Status In Quarantäne versetzt. 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.
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 im Dialogfeld "Warnhinweise"🔗 angezeigt.
Sie können auch eine geplante Abfrage über die Inline-Aktionen auf der Registerkarte Geplante Abfragen in die Quarantänefunktion eintragen. Weitere Informationen finden Sie in der Dokumentation zu Monitorabfragen .
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.
In der folgenden Tabelle werden die unterstützten Abfragewarnungstypen erläutert:
startsuccessfailedquarantinedelayEinen Überblick über Warnhinweise in Adobe Experience Platform, einschließlich der Definition von Warnregeln, finden Sie in der Warnhinweisübersicht. Eine Anleitung zum Verwalten von Warnhinweisen und Warnregeln in der Adobe Experience Platform-Benutzeroberfläche finden Sie im Handbuch zur Benutzeroberfläche von Warnhinweisen.
Festlegen von Parametern für eine geplante parametrisierte Abfrage set-parameters
Wenn Sie eine geplante Abfrage für eine parametrisierte Abfrage erstellen, müssen Sie jetzt die Parameterwerte für diese Abfrageausführungen festlegen.
Nachdem Sie Ihre Planungsdetails bestätigt haben, wählen Sie Speichern aus, 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
Wählen Sie auf der Registerkarte Zeitpläne Ihrer Vorlage die Zeitplan-ID aus, um zur Liste der Abfrageausführungen für Ihre neu geplante Abfrage zu navigieren.
Alternativ können Sie eine Liste der geplanten Ausführungen einer Abfragevorlage anzeigen, indem Sie zur Registerkarte Geplante Abfragen navigieren und einen Vorlagennamen aus der verfügbaren Liste auswählen.
Die Liste der ausgeführten Abfragen für diese geplante Abfrage wird angezeigt.
Vollständige Informationen zum Überwachen des Status aller Abfrageaufträge über die Benutzeroberfläche finden Sie im Leitfaden Geplante abgefragte Abfragen überwachen .
Wählen Sie eine Kennung der Abfrage-Ausführung aus der Liste aus, um zur Übersicht der Abfrageausführung zu navigieren. Eine vollständige Aufschlüsselung der Informationen, die in der Übersicht über die Abfrageausführung verfügbar sind, finden Sie in der Dokumentation zu geplanten Abfragen zur Überwachung .
Informationen zum Überwachen geplanter Abfragen mithilfe der Query Service-API finden Sie im Handbuch geplante Abfrage-Run-Endpunkte .
Zeitplan aktivieren, deaktivieren oder löschen delete-schedule
Sie können einen Zeitplan im Arbeitsbereich Zeitpläne einer bestimmten Abfrage oder im Arbeitsbereich Geplante Abfragen aktivieren, deaktivieren oder löschen, in dem alle geplanten Abfragen aufgelistet werden.
Um auf die Registerkarte Zeitpläne Ihrer ausgewählten Abfrage zuzugreifen, müssen Sie den Namen einer Abfragevorlage auf der Registerkarte Vorlagen oder auf der Registerkarte Geplante Abfragen auswählen. Dadurch wird zum Abfrage-Editor für diese Abfrage navigiert. Wählen Sie im Abfrage-Editor Zeitpläne aus, 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
Ein Bestätigungsdialogfeld wird angezeigt. Wählen Sie Deaktivieren aus, um die Aktion zu bestätigen.
Wählen Sie Zeitplan löschen aus, um den deaktivierten Zeitplan zu löschen.
Alternativ bietet die Registerkarte Geplante Abfragen 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 , um Warnhinweise für die geplante Abfrage anzuzeigen. Vollständige Anweisungen zum Löschen oder Deaktivieren einer geplanten Abfrage über die Registerkarte "Geplante Abfragen"finden Sie im Handbuch Geplante Abfrage überwachen .