Abfragepläne
Sie können die Ausführung von Abfragen automatisieren, indem Sie Abfragezeitpläne erstellen. Geplante Abfragen werden mit einer benutzerdefinierten Kadenz ausgeführt, um Ihre Daten basierend auf Häufigkeit, Datum und Uhrzeit zu verwalten. Bei Bedarf können Sie auch einen Ausgabedatensatz für Ihre Ergebnisse auswählen. Abfragen, die als Vorlage gespeichert wurden, können über den Abfrage-Editor geplant werden.
Kontoanforderungen für geplante Abfragen technical-account-user-requirements
Damit geplante Abfragen zuverlässig ausgeführt werden können, empfiehlt Adobe, dass Admins ein technisches Konto (mit OAuth-Server-zu-Server-Anmeldeinformationen) zum Erstellen geplanter Abfragen bereitstellen. Geplante Abfragen können auch mit einem persönlichen Benutzerkonto erstellt werden. Auf diese Weise erstellte Abfragen werden jedoch nicht mehr ausgeführt, wenn der Zugriff dieses Benutzers entfernt oder deaktiviert wird.
Weitere Informationen zum Einrichten technischer Konten und zum Zuweisen der erforderlichen Berechtigungen finden Sie unter Voraussetzungen für das Anmeldeinformationshandbuch und API-Authentifizierung.
Weitere Anleitungen zum Erstellen und Konfigurieren eines technischen Kontos finden Sie unter:
- Developer Console-Setup: Schrittweise Anweisungen zum Konfigurieren der Adobe Developer Console und zum Abrufen von OAuth-Anmeldeinformationen.
- Einrichtung eines technischen Endkontos Eine umfassende Anleitung zum Erstellen und Konfigurieren eines technischen Kontos in Adobe Experience Platform.
Wenn Sie nur die Benutzeroberfläche des Abfrage-Service verwenden, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen, oder stimmen Sie sich mit einem Administrator ab, der technische Konten verwaltet. Alle geplanten Abfragen werden der Liste auf der Registerkarte Scheduled queries hinzugefügt, wo Sie den Status, Zeitplandetails und Fehlermeldungen für alle geplanten Abfrageaufträge überwachen sowie Warnhinweise abonnieren können. Weitere Informationen zur Überwachung und Verwaltung Ihrer Abfragen finden Sie im Dokument Überwachen geplanter Abfragen.
Dieser Workflow behandelt den Zeitplanungsprozess in der Benutzeroberfläche des Abfrage-Service. Informationen zum Hinzufügen von Zeitplänen mithilfe der API finden Sie Handbuch zu Endpunkten für geplante Abfragen.
Abfragezeitplan erstellen create-schedule
Um eine Abfrage zu planen, wählen Sie eine Abfragevorlage auf der Registerkarte Templates oder der Spalte Template der Registerkarte Scheduled Queries aus. Wenn Sie den Vorlagennamen auswählen, 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 Add schedule aus, um zur Seite Zeitplandetails“ .
Alternativ können Sie die Registerkarte Schedules 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 Add Schedule aus, um einen Zeitplan zu erstellen.
Zeitplandetails hinzufügen schedule-details
Die Seite mit den Zeitplandetails wird angezeigt. Auf dieser Seite können Sie eine Vielzahl von Details für die geplante Abfrage bearbeiten. Zu den Details gehören Häufigkeit und Wochentag der geplanten Abfrage Ausführung, das Start- und Enddatum, der Datensatz, in den die Ergebnisse exportiert werden sollen, und Abfragestatus-Warnhinweise.
Geplante Abfragefrequenz scheduled-query-frequency
Sie können die folgenden Optionen für Frequency auswählen:
- Hourly: Die geplante Abfrage wird im ausgewählten Datumsbereich stündlich ausgeführt.
- Daily: Die geplante Abfrage wird alle X Tage zum ausgewählten Zeitpunkt und im ausgewählten Datumsbereich ausgeführt. Beachten Sie, dass die ausgewählte Zeit in UTC angegeben ist, nicht in Ihrer lokalen Zeitzone.
- Weekly: 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.
- Monthly: 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.
- Yearly: 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.
Angeben 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 an ihn anhängen.
Wählen Sie Create and append into new dataset aus, um einen Datensatz zu erstellen, wenn Sie eine Abfrage zum ersten Mal ausführen. Bei nachfolgenden Ausführungen werden weiterhin Daten in diesen Datensatz eingefügt. 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 Append into existing dataset und dann das Datensatzsymbol (
Das Dialogfeld Select output dataset wird angezeigt.
Durchsuchen Sie als Nächstes entweder die vorhandenen Datensätze oder verwenden Sie das Suchfeld, um die Optionen zu filtern. Wählen Sie die Zeile des Datensatzes aus, den Sie verwenden möchten. Die Datensatzdetails werden im Bedienfeld auf der rechten Seite angezeigt. Wählen Sie Done aus, um Ihre Auswahl zu bestätigen.
Abfragen in Quarantäne verschieben, wenn sie kontinuierlich 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 in einen Quarantined Status versetzt wird. Indem Sie Abfragen nach zehn aufeinander folgenden Fehlern unter Quarantäne stellen, können Sie eingreifen, Probleme überprüfen und korrigieren, bevor Sie weitere Ausführungen zulassen. Dies hilft, Ihre betriebliche Effizienz und Datenintegrität zu erhalten.
Sobald eine Abfrage für die Quarantänefunktion registriert ist, 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“ .
Sie können eine geplante Abfrage auch über die Inline-Aktionen auf der Registerkarte Scheduled Queries für die Quarantänefunktion registrieren. Weitere Informationen finden in der zum Überwachen von Abfragen .
Festlegen von Warnhinweisen für den Status geplanter Abfragen alerts-for-query-status
Sie können im Rahmen Ihrer Einstellungen für geplante Abfragen auch Abfrage-Warnhinweise abonnieren. Sie können Ihre Einstellungen so konfigurieren, dass Benachrichtigungen für verschiedene Situationen empfangen werden. Warnhinweise können für einen Quarantänestatus, Verzögerungen bei der Abfrageverarbeitung oder eine Änderung des Status Ihrer Abfrage festgelegt werden. Zu den verfügbaren Warnoptionen für den Abfragestatus gehören „Start“, „Erfolg“ und „Fehler“. Warnhinweise können entweder in Form von eingeblendeten Benachrichtigungen oder per E-Mail 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 Warnhinweistypen für Abfragen erläutert:
startsuccessfailedquarantinedelayEinen Überblick über Warnhinweise in Adobe Experience Platform, einschließlich der Struktur der Definition von Warnhinweisregeln, finden Sie unter Warnhinweise - Übersicht. Anleitungen zum Verwalten von Warnhinweisen und Warnhinweisregeln 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 Zeitplandetails bestätigt haben, wählen Sie Save aus, um einen Zeitplan zu erstellen. Sie kehren zur Registerkarte Zeitpläne Ihrer Vorlage zurück. Dieser Arbeitsbereich zeigt Details zum neu erstellten Zeitplan an, 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 Schedules 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 Scheduled queries navigieren und einen Vorlagennamen aus der verfügbaren Liste auswählen.
Die Liste der Abfrageausführungen für diese geplante Abfrage wird angezeigt.
Stunden auf Auftragsebene berechnen compute-hours
Verfolgen Sie die auf der Abfrageausführungsebene verbrauchten Rechenstunden für Ihre CTAS/ITAS-Batch-Abfragen. Diese Funktion bietet Einblicke in die Computernutzung und hilft Ihnen, die Ressourcenzuweisung zu optimieren und die Abfrageleistung zu verbessern.
Die folgende Tabelle enthält Beschreibungen der einzelnen Spalten, die im Detailabschnitt verfügbar sind und geplante Abfrageausführungen auflisten.
Completed, Running, oder Failed,, um das Ergebnis schnell zu bewerten.Vollständige Informationen Überwachen des Status aller Abfrageaufträge über die Benutzeroberfläche finden im Handbuch zur Überwachung geplanter Abfragen .
Wählen Sie ein Query run ID aus der Liste aus, um zur Übersicht über die Abfrageausführung zu navigieren. Eine vollständige Aufschlüsselung der in der (Übersicht über die ) verfügbaren Informationen Sie in der Dokumentation Überwachen geplanter Abfragen .
Informationen zum Überwachen geplanter Abfragen mithilfe der Abfrage-Service-API finden Sie Handbuch zu Endpunkten für die Ausführung geplanter Abfragen.
Zeitplan aktivieren, deaktivieren oder löschen delete-schedule
Sie können einen Zeitplan im Arbeitsbereich für Zeitpläne einer bestimmten Abfrage oder im Arbeitsbereich Scheduled Queries , in dem alle geplanten Abfragen aufgelistet sind, aktivieren, deaktivieren oder löschen.
Um auf die Registerkarte Schedules der ausgewählten Abfrage zuzugreifen, müssen Sie den Namen einer Abfragevorlage auf der Registerkarte Templates oder der Registerkarte Scheduled Queries auswählen. Dadurch wird zum Abfrage-Editor für diese Abfrage navigiert. Wählen Sie im Abfrage-Editor die Option Schedules aus, um auf den Arbeitsbereich für Zeitpläne zuzugreifen.
Wählen Sie einen Zeitplan aus den Zeilen der verfügbaren Zeitpläne aus, um den Detailbereich auszufüllen. Verwenden Sie den Umschalter, um die geplante Abfrage zu deaktivieren (oder zu aktivieren).
Deaktivierte Abfragen löschen
Ein Bestätigungsdialogfeld wird angezeigt. Wählen Sie Disable aus, um die Aktion zu bestätigen.
Wählen Sie Delete a schedule aus, um den deaktivierten Zeitplan zu löschen.
Alternativ dazu bietet die Registerkarte Scheduled Queries eine Sammlung von Inline-Aktionen für jede geplante Abfrage. Zu den verfügbaren Inline-Aktionen gehören Disable schedule oder Enable schedule, Delete schedule und Subscribe zu Warnhinweisen für die geplante Abfrage. Vollständige Anweisungen zum Löschen oder Deaktivieren einer geplanten Abfrage über die Registerkarte Geplante Abfragen finden Sie im Handbuch zu geplanten Abfragen überwachen.