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
Bevor Sie mit diesem Handbuch fortfahren, lesen Sie das UI-Handbuch für den Abfrage-Editor. 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. Weitere Anweisungen finden Sie im Abschnitt Zugreifen auf den Abfrage-Editor .
Verwenden Sie den '$'-Vorspann, um einen Abfrageparameter in Ihre Abfrage im Texteditor einzugeben. Wählen Sie dann die Registerkarte Abfrageparameter neben der Registerkarte Konsole aus, um den fehlenden Wert für den Schlüssel hinzuzufü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 Seite Details des Abfrageprotokolls überprüfen, um die Parameterwerte zu finden, die in einer Abfrageausführung verwendet werden. In diesem Fall zeigen die Protokolle nicht an, dass es sich bei der Abfrage um eine parametrisierte Abfrage handelte. Anweisungen zum Auffinden der verwendeten Werte finden Sie in der Dokumentation zu Abfrageprotokollen .
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 zum Erstellen eines Abfrageplans beschrieben, und geben Sie dann die Parameterwerte ein, die im Abfrageablauf verwendet werden sollen.Dieser UI-Abschnitt wird nur für parametrierte Abfragen angezeigt. Spezifische Anweisungen finden Sie im Abschnitt zum Festlegen von Parametern für eine geplante parametrisierte Abfrage .
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 zum Überwachen geplanter Abfragen lesen, um über die Platform-Benutzeroberfläche ein besseres Verständnis des Status aller Abfrageaufträge zu erhalten.