Dokumentation Experience Platform Handbuch zum Abfragedienst

Abfragepläne

Letzte Aktualisierung: 4. April 2025

Themen:
Abfragen

Erstellt für:

Benutzende
Entwickler

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.

IMPORTANT

Sie können einen Zeitplan nur zu einer Abfrage hinzufügen, die bereits erstellt und gespeichert wurde.

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 zur Ausführung Ihrer Abfragen und können Warnhinweise abonnieren. Zu den verfügbaren Informationen gehören der Status, Zeitplandetails und Fehlermeldungen/-codes, falls eine Ausführung fehlschlägt. Weitere Informationen finden im DokumentAbfragen überwachen .

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

Abfragezeitplan erstellen

Um eine Abfrage zu planen, wählen Sie eine Abfragevorlage auf der Registerkarte Vorlagen oder der Spalte Vorlage der Registerkarte Geplante Abfragen 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.

TIP

Wählen Sie Zeitplan anzeigen aus, um zum Arbeitsbereich für Zeitpläne zu navigieren und geplante Abfrageausführungen auf einen Blick zu sehen.

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

Wählen Sie Zeitplan hinzufügen aus, um zur Seite Zeitplandetails“.

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

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“.

Zeitplandetails hinzufügen

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.

IMPORTANT

Die Benutzeroberfläche der Abfrageplanung unterstützt keine unbegrenzte oder dauerhafte Planung. Ein Enddatum muss angegeben werden. Für das Enddatum gibt es keine Obergrenze.

Das hervorgehobene Bedienfeld „Zeitplandetails“.

Geplante Abfragefrequenz

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.

Angeben von Datensatzdetails

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 Erstellen und an neuen Datensatz anhängen 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.

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 mit den Zeitplandetails mit Datensatzdetails und den hervorgehobenen Erstellen und an neuen Datensatz anhängen-Optionen.

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

Das Bedienfeld „Zeitplandetails“ mit hervorgehobenen Datensatzdetails und „An vorhandenen Datensatz anhängen“.

Das Ausgabedatensatz auswählen 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 Fertig aus, um Ihre Auswahl zu bestätigen.

Das Dialogfeld „Ausgabedatensatz auswählen“ mit Hervorhebung des Suchfelds, einer Datensatzzeile und „Fertig“.

Abfragen in Quarantäne verschieben, wenn sie kontinuierlich fehlschlagen

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 Quarantänestatus 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.

Der Arbeitsbereich „Zeitpläne für Abfragen“ mit hervorgehobenen „Quarantäne für Abfragen“ und der ausgewählten Option „Ja“.

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 Geplante Abfragen“ für Quarantänefunktion registrieren. Weitere Informationen finden in derzum Überwachen von Abfragen .

Festlegen von Warnhinweisen für den Status geplanter Abfragen

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.

Das Bedienfeld „Zeitplandetails“ mit hervorgehobenen Warnoptionen.

In der folgenden Tabelle werden die unterstützten Warnhinweistypen für Abfragen erläutert:

Warnhinweistyp

Beschreibung

start

Dieser Warnhinweis informiert Sie, wenn eine geplante Abfrageausführung initiiert wird oder mit der Verarbeitung beginnt.

success

Dieser Warnhinweis informiert Sie, wenn eine geplante Abfrage erfolgreich ausgeführt wurde, und gibt an, dass die Abfrage fehlerfrei ausgeführt wurde.

failed

Dieser Warnhinweis Trigger, wenn bei der Ausführung einer geplanten Abfrage ein Fehler auftritt oder sie nicht erfolgreich ausgeführt werden kann. So können Sie Probleme schnell identifizieren und beheben.

quarantine

Dieser Warnhinweis wird aktiviert, wenn eine geplante Abfrageausführung in den Quarantänestatus versetzt wird. Sobald eine Abfrage in der Quarantänefunktion registriert), wird jede geplante Abfrage, die zehn aufeinander folgende Ausführungen fehlschlägt, automatisch in einen Quarantänestatus versetzt. Eine unter Quarantäne gestellte Abfrage erfordert dann Ihr Eingreifen, bevor weitere Ausführungen stattfinden können. Hinweis: Abfragen müssen für die Quarantänefunktion registriert sein, damit Sie Quarantänewarnungen abonnieren können.

delay

Dieser Warnhinweis benachrichtigt Sie, wenn das einer geplanten Abfrageausführung einen bestimmten Schwellenwert. 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 entweder der Abschluss erfolgt oder ein Fehler auftritt. Das Standardverhalten legt einen Warnhinweis für 150 Minuten fest, nachdem die Verarbeitung der Abfrage begonnen hat.

NOTE

Wenn Sie einen Warnhinweis Verzögerung bei der Abfrageausführung festlegen, müssen Sie Ihre gewünschte Verzögerungszeit in der Experience Platform-Benutzeroberfläche in Minuten 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 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

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 „Zeitplandetails“ des Workflows für die Zeitplanerstellung mit hervorgehobenem Abschnitt „Abfrageparameter“.

Nachdem Sie Ihre Zeitplandetails geprüft haben, klicken Sie auf Speichern, 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

Wählen Sie auf der Registerkarte Zeitpläne der Vorlage 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.

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 Registerkarte „Geplante Abfragen“ mit einer hervorgehobenen benannten Vorlage.

Die Liste der Abfrageausführungen für diese geplante Abfrage wird angezeigt.

Stunden auf Auftragsebene berechnen

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.

AVAILABILITY

Die Funktion „Stunden berechnen“ ist nur für Benutzer verfügbar, die die Data Distiller SKU erworben haben. Weitere Informationen erhalten Sie vom Adobe-Support.

Der Detailabschnitt des Arbeitsbereichs Geplante Abfragen mit einer Liste von Abfrageausführungen, die für eine geplante Abfrage hervorgehoben sind.

Die folgende Tabelle enthält Beschreibungen der einzelnen Spalten, die im Detailabschnitt verfügbar sind und geplante Abfrageausführungen auflisten.

Spaltentitel

Beschreibung

ID der Abfrageausführung

Zeigt für jede ausgeführte Abfrage eine eindeutige Kennung an, mit der Sie einzelne Ausführungen Ihrer geplanten Abfragen verfolgen und referenzieren können.

Start der Abfrageausführung

Gibt das Startdatum und die Uhrzeit der Abfrageausführung an, damit Sie überwachen können, wann jede Ausführung begann.

Abfrageausführung abgeschlossen

Zeigt das Abschlussdatum und die Uhrzeit der Abfrageausführung an, um die Ausführungsdauer und den Status von insight anzugeben.

Status

Zeigt den aktuellen Status der Abfrageausführung an, z. B. Completed, Running, oder Failed,, um das Ergebnis schnell zu bewerten.

Datensätze

Listet die bei der Abfrageausführung verwendeten Datensätze auf, um anzuzeigen, welche Datenquellen an der Ausführung beteiligt waren.

Stunden berechnen

Zeigt die für jede Abfrageausführung verwendete Berechnungszeit in Stunden. Dies hilft bei der Verfolgung der Ressourcennutzung und der Optimierung der Abfrageleistung.

NOTE

Die Daten zur Stundenberechnung sind ab 08/15/2024 verfügbar. Daten vor diesem Datum werden als „Nicht verfügbar“ angezeigt.

Vollständige Informationen Überwachen des Status aller Abfrageaufträge über die Benutzeroberfläche findenim Handbuch zur Überwachung geplanter Abfragen .

Wählen Sie eine ID der Abfrageausführung aus der Liste aus, um zur Übersicht der Abfrageausführung zu navigieren. Eine vollständige Aufschlüsselung der in der (Übersicht über die ) verfügbaren InformationenSie 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

Sie können einen Zeitplan im Arbeitsbereich für Zeitpläne einer bestimmten Abfrage oder im Arbeitsbereich „Geplante Abfragen“, der alle geplanten Abfragen auflistet aktivieren, deaktivieren löschen.

Um auf die Registerkarte Zeitpläne der ausgewählten Abfrage zuzugreifen, müssen Sie den Namen einer Abfragevorlage entweder auf der Registerkarte Vorlagen oder der Registerkarte Geplante Abfragen auswählen. Dadurch wird zum Abfrage-Editor für diese Abfrage navigiert. Wählen Sie im Abfrage-Editor die Option Zeitpläne, 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

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. Klicken Sie Deaktivieren, um die Aktion zu bestätigen.

Der Bestätigungsdialog zum Deaktivieren des Zeitplans.

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

Der Arbeitsbereich für Zeitpläne mit hervorgehobener Option „Zeitplan löschen“.

Alternativ dazu bietet 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 Warnhinweise 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.

recommendation-more-help