參數化查詢 parameterized-queries
查詢服務支援在查詢編輯器中使用引數化查詢。 透過引數化查詢,您現在可以使用引數的預留位置,並在執行時新增引數值。 預留位置可讓您使用動態資料,但您不知道在執行陳述式前將會有哪些值。 您也可以提前準備查詢,並重複使用它們以達到類似的目的。 重複使用查詢可節省大量時間,因為您可以避免為每個使用案例建立不同的SQL查詢。
先決條件
繼續本指南之前,請先閱讀查詢編輯器UI指南。 查詢編輯器指南提供關於如何在Experience Platform使用者介面中撰寫、驗證和執行客戶體驗資料查詢的詳細資訊。
引數化查詢語法 syntax
引數化的查詢使用格式'$YOUR_PARAMETER_NAME'
,而且可以使用點標籤法串連。 使用引數化查詢的範例SQL陳述式如下所示。
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;
建立引數化查詢 create
若要在UI中建立引數化查詢,請導覽至「查詢編輯器」。 如需更多指示,請參閱存取查詢編輯器一節。
使用 '$'
前置詞,在文本編輯器中將查詢參數輸入到查詢中。接著,選取主控台旁的 查詢引數 索引標籤,為索引鍵新增缺少的值。 如果您忽略將值新增到任何必要的索引鍵,則無法執行查詢。 警示圖示(
)出現在任何空白值輸入欄位旁的查詢引數區段。
使用查詢記錄檔詳細資料檢查引數值 check-parameter-values
您無法儲存範本中的引數,因為所使用的值不是永久性的。 不過,您可以檢查查詢記錄詳細資料頁面,以尋找查詢執行中使用的引數值。 在此情況下,記錄檔不會指出查詢是引數化查詢。 請參閱查詢記錄檔案,以取得如何尋找使用值的指示。
排程引數化查詢 schedule
當您排定引數化查詢時,會儲存引數值。 若要排程引數化查詢,請依照指南中所述的典型程式來建立排程的查詢,以建立查詢排程,然後輸入要用於查詢執行的引數值。 此UI區段只會針對引數化查詢顯示。 如需特定指示,請參閱中有關為排程引數化查詢設定引數的章節。
後續步驟
閱讀本檔案後,您已瞭解如何在Adobe Experience Platform UI中引數化查詢,並在排程的查詢執行中使用它們。 本檔案也重點說明如何檢查日誌中用於查詢執行的引數值。
接下來,建議您閱讀監視排定的查詢的指南,以透過Platform UI更好地瞭解所有查詢工作的狀態。