參數可讓您製作更具彈性且可自訂的報表。您可以將資料來源中的參數傳回至基礎查詢。如要在自訂查詢中使用參數，請按照「執行參數化查詢」一文中的相關語法指南操作。
標準參數
您可以在任何自訂查詢中使用下列參數：
| 參數 |
目的 |
|---|---|
| @DS_START_DATE |
取得報表日期範圍的開始日期。 |
| @DS_END_DATE |
取得報表日期範圍的結束日期。 |
| @DS_USER_EMAIL |
取得登入使用者的電子郵件地址。 |
如要使用這些參數，請按照下列步驟操作：
在查詢編輯器下方，開啟要使用的參數。
請務必在查詢中使用大寫參數名稱。
所有參數值都會以字串形式傳遞。如要將這些值視為日期、數字或其他資料類型，請務必使用適當的轉換函式，例如 PARSE_DATE、PARSE_TIMESTAMP 或 CAST。
使用日期參數將日期範圍傳遞至基礎查詢
如果報表包含日期範圍控制項，檢視者就能使用該控制項，從資料中要求不同的開始和結束日期。
使用電子郵件參數提供資料列層級的資料存取權
電子郵件參數可讓您只顯示與報表、資料來源或探索中登入使用者相關聯的資料。該使用者必須登入 Google 帳戶，並同意將電子郵件地址提供給 Looker Studio。如果檢視者不同意，報表中所有以這個資料來源為依據的圖表都會顯示授權錯誤。
自訂參數
您可以在自訂查詢中使用 Looker Studio 使用者介面中建立的任何參數。
在連線頁面中建立參數
- 在自訂查詢編輯器下方，按一下「+ 新增參數」。
- 設定參數選項。
- 按一下 [確定]。
隱藏資料來源中的自訂參數
根據預設，您可以在報表中修改自訂參數。如要禁止報表編輯者變更參數值，可以隱藏參數。
- 按一下參數右側的「更多選項」圖示
。 - 按一下「隱藏」。
進一步瞭解如何在報表中允許使用資料來源參數。
在自訂查詢中使用參數
在自訂查詢的主體中，以開頭為 @ 字元的 ID 取代硬式編碼的值。例如：@param_name。
參數範例
自訂參數範例：
SELECT word FROM `TABLE` WHERE corpus = @corpus;
使用含有和數字的字串：
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
使用多選字串參數。請注意，我們使用 UNNEST 將值清單扁平化：
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
日期參數範例 (日期採用標準格式)：
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);
日期參數範例 (日期是以微秒為單位的 Unix 時間戳記)：
SELECT creation_date, age, display_name from user.users as use
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE)
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE)
電子郵件參數範例：
SELECT * FROM Sales WHERE sales-rep-email = @DS_USER_EMAIL;