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