Parametrierte Abfragen

Letzte Aktualisierung: 4. April 2025

Erstellt für:

  • Benutzende
  • Entwickler

Query Service unterstützt die Verwendung parametrisierter Abfragen im Abfrage-Editor. Bei parametrisierten Abfragen können Sie jetzt Platzhalter für Parameter verwenden und die Parameterwerte zur Ausführungszeit hinzufügen. Platzhalter ermöglichen es Ihnen, mit dynamischen Daten zu arbeiten, bei denen Sie die Werte erst dann kennen, wenn die Anweisung ausgeführt wird. Sie können Ihre Abfragen auch vorab vorbereiten und für ähnliche Zwecke wiederverwenden. Die Wiederverwendung von Abfragen spart viel Aufwand, da Sie für jeden Anwendungsfall keine separaten SQL-Abfragen erstellen müssen.

Voraussetzungen

Bevor Sie mit diesem Handbuch fortfahren, lesen Sie das Handbuch zur Benutzeroberfläche des Abfrage-Editors. Das Handbuch zum Abfrage-Editor enthält detaillierte Informationen zum Schreiben, Validieren und Ausführen von Abfragen für Kundenerlebnisdaten in der Benutzeroberfläche von Experience Platform.

NOTE
In der Adobe Experience Platform-Benutzeroberfläche werden parametrisierte Abfragen nur auf der übergeordneten Ebene von Inline-Vorlagen unterstützt. Dies bedeutet, dass parametrisierte Abfragen nur bei Verwendung in der ursprünglichen Vorlage funktionieren. Untergeordnete Vorlagen müssen eine statische Vorlage sein und dürfen keine dynamischen Parameter enthalten. Weitere Informationen finden in der DokumentationInline-Vorlagen .

Parametrisierte Abfragesyntax

Parametrisierte Abfragen verwenden das Format '$YOUR_PARAMETER_NAME' und können mit der Punktnotation verkettet werden. Nachfolgend finden Sie eine Beispiel-SQL-Anweisung, die parametrisierte Abfragen verwendet.

INSERT INTO
   $Database_Name.Schema_Name.adwh_lkup_process_delta_log
   (process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
   '$Table_Process_Name' process_name,
   hash('$Merge_PolicyID') merge_policy_id,
   '$process_status' process_status,
   to_date('$date_key') process_date,
   CURRENT_TIMESTAMP create_ts,
   CURRENT_TIMESTAMP change_ts;

Erstellen einer parametrisierten Abfrage

Um Ihre parametrisierte Abfrage in der Benutzeroberfläche zu erstellen, navigieren Sie zum Abfrage-Editor. Weitere Anweisungen finden Sie im Abschnitt Zugriff auf den AbfrageEditor).

Verwenden Sie den '$'-Vorspann, um einen Abfrageparameter in Ihre Abfrage im Texteditor einzugeben. Wählen Sie anschließend die Registerkarte Abfrageparameter neben der Konsole und fügen Sie den fehlenden Wert für den Schlüssel hinzu. Die Abfrage kann nicht ausgeführt werden, wenn Sie versäumen, einem der erforderlichen Schlüssel einen Wert hinzuzufügen. Ein Warnhinweissymbol ( Warnhinweissymbol. ) im Abschnitt Abfrageparameter neben leeren Eingabefeldern Wert angezeigt.

NOTE
Wenn Ihre Abfrage keine Parameter akzeptiert, können Sie im Abfrage-Editor dennoch unnötige Parameter eingeben. Der Abfrage-Editor ignoriert alle unnötigen Schlüssel-Wert-Paare und sie haben keine Auswirkungen auf die Ausführung oder das Ergebnis der Abfrage.

Der Abfrage-Editor mit einer parametrisierten Abfrage und dem hervorgehobenen Abschnitt „Abfrageparameter“.

TIP
Ändern Sie die Registerkarten von Abfrageparameter in Konsole, um die Konsolenausgabe der Abfrage anzuzeigen.

Verwenden Sie Details der Abfrageprotokolle, um Parameterwerte zu überprüfen

Sie können keine Parameter in Vorlagen speichern, da die verwendeten Werte nicht persistent sind. Sie können jedoch die Seite Details zum Abfrageprotokoll überprüfen, um die in einer Abfrageausführung verwendeten Parameterwerte zu finden. In diesem Fall geben die Protokolle nicht an, dass die Abfrage eine parametrisierte Abfrage war. Anweisungen Ermitteln der verwendeten Werte finden Sieder Dokumentation zu Abfrageprotokollen .

Die Ansicht mit den Abfrageprotokollen, wobei der SQL-Code einer parametrisierten Abfrage im Detailabschnitt hervorgehoben ist.

Planen einer parametrisierten Abfrage

Parameterwerte werden gespeichert, wenn Sie eine parametrisierte Abfrage planen. Um eine parametrisierte Abfrage zu planen, folgen Sie dem typischen Prozess zum Erstellen einer geplanten Abfrage, wie in der Anleitung zum Erstellen eines Abfrageplans beschrieben, und geben Sie dann die Parameterwerte ein, die bei der Abfrageausführung verwendet werden sollen. Dieser Abschnitt der Benutzeroberfläche wird nur für parametrisierte Abfragen angezeigt. Spezifische Anweisungen finden Sie Abschnitt zum Festlegen von Parametern für eine geplante parametrisierte.

TIP
Der Abfrage-Service unterstützt vorbereitete Anweisungen durch die Verwendung parametrisierter Abfragen. Weitere Informationen verwendeten SQL-Syntax finden SieHandbuch zur Syntax von vorbereiteten Anweisungen .