Parametrierte Abfragen parameterized-queries
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.
Parametrisierte Abfragesyntax syntax
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 create
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 (
Verwenden Sie Details der Abfrageprotokolle, um Parameterwerte zu überprüfen check-parameter-values
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 .
Planen einer parametrisierten Abfrage schedule
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.
Nächste Schritte
Durch das Lesen dieses Dokuments haben Sie gelernt, wie Sie Abfragen in der Adobe Experience Platform-Benutzeroberfläche parametrisieren und in geplanten Abfrageausführungen 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 wird empfohlen, das Handbuch unter Überwachen geplanter Abfragen zu lesen, um über die Experience Platform-Benutzeroberfläche einen besseren Überblick über den Status aller Abfrageaufträge zu erhalten.