使用參數,可以在每次執行時提示輸入要與查詢的篩選條件或計算一起使用的值。透過在執行階段設定這些值,您可以在每次執行時在不同的內容(如帳戶、區域或時段期間)中使用查詢。
您可以為特定查詢建立自訂參數,或者您的工作區擁有者可以為多個查詢建立全域參數。
建立查詢的自訂參數
您可以在建立器或 SQL 編輯器中設定查詢的參數。建立參數時,可以將其與查詢中的多個篩選條件和計算一起使用。
步驟 1:建立參數
- 從參數面板上,按一下新增,然後選擇建立新參數。
- 為了識別參數,請輸入不重複的名稱,名稱中只能有英數字元,且「不能」出現空格。
- 在「篩選器類型」中,選擇要篩選的資料類型,例如「文字」或「整數」。
步驟 2:設定參數值
查詢執行時,其參數可以根據資料類型,接受自由格式值,也可以提供特定值的清單以供選擇。
- 若要接受任何自由格式的值,請輸入預設值 (如適用),再按一下「建立」。
- 如何提供特定值的列表:
- 啟用 選項清單。
- 若要啟用參數的多個值,請選取 多選 方塊。
- 在「列表選項」中,輸入要選擇的值,每輸入一個值就按一次 Enter。
注意:若為日期或時間戳記參數,請以
YYYY-MM-dd
格式輸入每個選項。 - 為參數選擇任意預設值,然後按一下 接受。附註: 對於 多選 參數,至少選擇一個預設值。
- 點選 【建立】 【創建】即可完成。
步驟 3:在查詢中使用參數
若要將參數的值套用在查詢上,請在篩選器或計算中使用參數:
- 若要根據「建立器」中的參數來設定篩選器的值,當您在「篩選器屬性」右側面板中定義篩選器時,請選取該參數。
注意:使用多選參數時,請在「篩選條件」 索引標籤上選取「在清單中」或「不在清單中」為篩選運算子。
- 若要以「SQL 編輯器」中的篩選器使用參數,或在計算中參照其值,請在 SQL 陳述式中於半形冒號 (:) 後輸入其名稱,例如 :ReportingPeriod。
在查詢中使用全域參數
工作區擁有者可以為用於多個查詢的通用值配置全域參數。要在查詢中使用全域參數:
- 從參數面板上,按一下新增,然後選擇選擇全局參數。
- 選擇要在查詢中使用的全局參數,然後按一下新增。
- 若要編輯全域參數,請選取它,並根據查詢的需要更新其名稱或值。
注意:為確保分析的一致性,工作區擁有者可能會鎖定全域參數以防止編輯其值。
-
若要將全域參數的值套用於查詢,請在篩選條件或計算中使用參數:
- 若要根據「建立器」中的參數來設定篩選器的值,當您在「篩選器屬性」右側面板中定義篩選器時,請選取該參數。
注意:使用多選參數時,請在「篩選條件」 索引標籤上選取「在清單中」或「不在清單中」為篩選運算子。
- 要在 SQL 編輯器中引用參數,在 SQL 語句中,在冒號後 (:) 輸入其名稱,如 :ReportingPeriod。
- 要在計算的 SQL 語句中引用參數值,請從參數選單中選擇參數。
- 若要根據「建立器」中的參數來設定篩選器的值,當您在「篩選器屬性」右側面板中定義篩選器時,請選取該參數。
編輯查詢參數
調整或管理參數的詳細資訊:
- 在「參數」面板中,選擇要編輯的參數。
- 依需求編輯參數的名稱、資料類型或值。
- 按一下「套用」(Apply)。
移除查詢參數
如果不再需要某個參數,可以將其從查詢中移除。在「參數」面板中,按一下參數的「刪除 」 ,然後按一下「儲存 」。