NATIVE_DIMENSION

傳回由基礎資料集評估的 BigQuery SQL 運算式結果。

NATIVE_DIMENSION 函式可讓您直接在 Looker Studio 欄位中編寫 SQL。如果資料庫支援的函式未列在函式清單中，這項功能就非常實用。

啟用原生函式

原生函式預設為停用，且是在資料來源層級進行管理。

如果您是 BigQuery 資料來源的擁有者，可以按照下列步驟為資料來源啟用原生函式：

  1. 在 Looker Studio 中編輯資料來源。
  2. 在資料來源編輯器的右上角，按一下「原生函式」。
  3. 在「原生函式」對話方塊中，選取「開啟」。
  4. 按一下 [儲存]。

如果停用原生函式，所有使用者都無法使用原生函式建立欄位。如果現有圖表參照使用原生函式的欄位，就會顯示錯誤。

用法示範

NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}','$.name')","STRING")

語法

NATIVE_DIMENSION( expression, type )

參數

expression - 要由基礎資料集評估的運算式。可以是任何有效的 BigQuery SQL，可填入 SELECT 陳述式單一資料欄。運算式不得包含任何匯總。

type - 資料類型常值。如需這個函式支援的類型，請參閱下節。

NATIVE_DIMENSION 類型

你可以選取下列任一類型：

類型 預期資料 報表範例
STRING 零個以上的英文字母、數字、字元或符號。

A1B2C3

BOOL

邏輯值。

true

false

DOUBLE 浮點數。 1,234.56
INT64 整數。 1,234
DATE 日曆日期。

2020-09-21

DATETIME 包含時間的日曆日期， 2020-09-21 12:35 PM
GEOGRAPHY

與 BigQuery 地理位置資料類型 對應的點和多邊形集合。

系統僅支援 BigQuery 函式 POINT 和 POLYGON 。

 POINT(32 210)

POLYGON((0 0, 2 2, 2 0, 0 0), (2 2, 3 4, 2 4, 2 2))

如果運算式傳回時間戳記資料型別 (例如 BigQuery 的 TIMESTAMP 型別)，請使用 CAST 函式將其轉換為 DATETIME 型別。例如：

NATIVE_DIMENSION("CAST({ expression } AS DATETIME)", "DATETIME")

NATIVE_DIMENSION 範例

SQL 中的 JSON 函式

假設您的資料包含 users_ages_json 欄位，且值格式為 JSON 酬載。這個欄位的資料列值範例如下：

{"name": "Jakob", "age": "26"}

使用 NATIVE_DIMENSION 函式，透過 BigQuery 的 JSON_VALUE 函式從 users_ages_json 擷取年齡：

NATIVE_DIMENSION("JSON_VALUE(user_ages_json, '$.age')","INT64")

以這個範例列值來說，NATIVE_DIMENSION 函式會以整數形式傳回年齡 26。

NATIVE_DIMENSION 的限制

誰可以使用原生函式

啟用原生函式後，資料來源擁有者和編輯者就能在資料來源中建立含有原生函式的欄位。

資料來源檢視者可以在圖表中使用含有原生函式的欄位。不過，檢視者無法使用原生函式建立新欄位，也無法使用原生函式編輯任何欄位。

匯總欄位

您無法在 expression 參數中加入任何匯總欄位。

窗型函式

expression 參數不得包含任何窗型函式。

混合

您無法在混合資料來源上使用 NATIVE_DIMENSION 函式建立欄位。

不過，您可以在混合前使用此函式建立欄位，然後在混合中使用該欄位。

TIMESTAMP 資料類型

如果運算式傳回時間戳記資料型別 (例如 BigQuery 的 TIMESTAMP 型別)，請使用 CAST 函式將其轉換為 DATETIME 型別。例如：

NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")