在自訂查詢中使用參數

參數可讓您製作更有彈性、可自訂的報表。您可以將資料來源中的參數傳回至基礎查詢。如要在自訂查詢中使用參數，請遵循「執行參數化查詢」一文中所述的相關語法規範。

標準參數

您可以在任何自訂查詢中使用下列參數：

如要使用這些參數，請按照下列步驟操作：

1. 在查詢編輯器下方，開啟要使用的參數。

2. 在查詢中，請務必使用大寫字母輸入參數名稱。

所有參數值都會以字串的形式傳遞。如要將這些值視為日期、數字或其他資料類型，請務必使用適當的轉換函式，例如 PARSE_DATE、PARSE_TIMESTAMP 或 CAST。

使用日期參數將日期範圍傳遞至基礎查詢

如果報表包含日期範圍控制項，觀眾就能使用該控制項，從資料中要求不同的開始和結束日期。

使用電子郵件參數，提供資料的資料列層級存取權

您可以使用電子郵件參數，只顯示與已登入使用者相關聯的報表、資料來源或探索資料。使用者必須登入 Google 帳戶，並同意將電子郵件地址提供給 Looker Studio。如果觀看者不同意，報表中所有以此資料來源為依據的圖表都會顯示授權錯誤。

自訂參數

您可以在自訂查詢中使用 Looker Studio 使用者介面中建立的任何參數。

在連線頁面中建立參數

1. 在自訂查詢編輯器下方，按一下「+ 新增參數」。
2. 設定參數選項。
3. 按一下 [確定]。

隱藏資料來源中的自訂參數

根據預設，您可以在報表中修改自訂參數。如要避免報表編輯者變更參數值，您可以隱藏參數。

1. 按一下參數右側的「更多選項」圖示 。
2. 按一下「隱藏」。

進一步瞭解如何在報表中允許資料來源參數。

在自訂查詢中使用參數

在自訂查詢的內文中，將硬式編碼的值替換為以 @ 字元開頭的 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;

相關資源

• 參數簡介