Parametrierte Abfragen parameterized-queries
Query Service unterstützt die Verwendung parametrisierter Abfragen im Abfrage-Editor. Bei parametrierten Abfragen können Sie jetzt Platzhalter für Parameter verwenden und die Parameterwerte zur Ausführungszeit hinzufügen. Mit Platzhaltern können Sie mit dynamischen Daten arbeiten, bei denen Sie nicht wissen, welche Werte verwendet werden, bis die Anweisung ausgeführt wird. Sie können Ihre Abfragen auch vorzeitig vorbereiten und für ähnliche Zwecke wiederverwenden. Die Wiederverwendung von Abfragen erspart Ihnen erheblichen Aufwand, da Sie die Erstellung eigener SQL-Abfragen für jeden Anwendungsfall vermeiden.
Voraussetzungen
Lesen Sie vor dem Fortfahren mit diesem Handbuch die Anleitung zur Benutzeroberfläche des Abfrage-Editors. Das Handbuch zum Abfrage-Editor enthält detaillierte Informationen zum Schreiben, Überprüfen und Ausführen von Abfragen für Kundenerlebnisdaten in der Experience Platform-Benutzeroberfläche.
Parametrisierte Abfragesyntax syntax
Parametrisierte Abfragen verwenden das Format '$YOUR_PARAMETER_NAME' und können mit Punktnotation verkettet werden. Nachfolgend finden Sie ein Beispiel für eine 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;
Eine parametrierte Abfrage erstellen create
Um Ihre parametrisierte Abfrage in der Benutzeroberfläche zu erstellen, navigieren Sie zum Abfrage-Editor. Siehe Abschnitt zu Zugriff auf den Abfrage-Editor für weitere Anweisungen.
Verwenden Sie den '$'-Vorspann, um einen Abfrageparameter in Ihre Abfrage im Texteditor einzugeben. Wählen Sie als Nächstes die Abfrageparameter Registerkarte neben dem Konsole den fehlenden Wert für den Schlüssel hinzufügen. Die Abfrage kann nicht ausgeführt werden, wenn Sie keinem der erforderlichen Schlüssel einen Wert hinzufügen. Ein Warnsymbol (
Verwenden Sie die Details der Abfrageprotokolle, um Parameterwerte zu überprüfen. check-parameter-values
Parameter können nicht in Vorlagen gespeichert werden, da die verwendeten Werte nicht persistent sind. Sie können jedoch die Details zum Abfrage-Protokoll -Seite, um die Parameterwerte zu finden, die in einem Abfrageablauf verwendet werden. In diesem Fall zeigen die Protokolle nicht an, dass es sich bei der Abfrage um eine parametrisierte Abfrage handelte. Siehe Dokumentation zu Abfrageprotokollen für Anweisungen zum Auffinden der verwendeten Werte.
Eine parametrisierte Abfrage planen schedule
Die Parameterwerte werden gespeichert, wenn Sie eine parametrisierte Abfrage planen. Um eine parametrisierte Abfrage zu planen, folgen Sie dem typischen Prozess, um eine geplante Abfrage zu erstellen, wie im Handbuch zu Abfragezeitplan erstellenund geben Sie dann die Parameterwerte ein, die im Abfrageablauf verwendet werden sollen. Dieser UI-Abschnitt wird nur für parametrierte Abfragen angezeigt. Siehe Abschnitt zu Festlegen von Parametern für eine geplante parametrisierte Abfrage für spezifische Anweisungen.
Nächste Schritte
Durch Lesen dieses Dokuments haben Sie gelernt, wie Sie Abfragen in der Adobe Experience Platform-Benutzeroberfläche parametrisieren und in geplanten Abfragemöglichkeiten verwenden können. In dem Dokument wurde auch hervorgehoben, wie die Protokolle auf die in Abfrageausführungen verwendeten Parameterwerte überprüft werden können.
Als Nächstes sollten Sie das Handbuch lesen unter Überwachung geplanter Abfragen , um über die Platform-Benutzeroberfläche ein besseres Verständnis des Status aller Abfrageaufträge zu erhalten.