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"}

使用 BigQuery 的 JSON_VALUE 函式，透過 NATIVE_DIMENSION 函式從 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")