Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

納入 SQL 並參照 LookML 物件

如要編寫功能強大的 LookML，您必須能夠參照現有的維度、測量指標、檢視區塊或衍生資料表，即使這些項目不在目前的範圍內也一樣。您也需要參照基礎資料表中的資料欄，並使用資料庫方言的函式呼叫來操控這些值。

替換運算子 ($)

替換運算子 $ 可讓 LookML 程式碼更易於重複使用和模組化，方便您參照其他檢視區塊和衍生資料表、SQL 資料表中的資料欄，或是 LookML 維度和測量指標。這麼做有兩個好處。首先，您可能已經計算出非常複雜的維度或指標，不需要再次編寫所有複雜的內容。其次，如果您變更維度或指標的任何項目，該變更可能會傳播至依附於該維度或指標的所有其他項目。

您可以使用替換運算子執行下列操作：

${TABLE}.column_name 參照的資料表資料欄，必須與您目前使用的檢視區塊相連。例如：

dimension: customer_id {
  type: number
  sql: ${TABLE}.customer_id ;;
}

${field_name} 參照您目前處理的檢視區塊中的維度或指標。例如：

measure: total_population {
  type: sum
  sql: ${population} ;;
}

${view_name.field_name} 參照其他檢視區塊的維度或指標。例如：

dimension: lifetime_orders {
  type: number
  sql: ${user_order_facts.lifetime_orders} ;;
}

${view_name.SQL_TABLE_NAME} 參照另一個檢視區塊或衍生資料表。請注意，這個參照中的 SQL_TABLE_NAME 是字串常值，不需要替換成任何內容。例如：

explore: trips {
  view_label: "Long Trips"
  # This will ensure that we only see trips that are longer than average!
  sql_always_where: ${trips.trip_duration}>=(SELECT tripduration FROM ${average_trip_duration.SQL_TABLE_NAME});;
}

${view_name.SQL_TABLE_NAME} 無法與 datagroups 搭配使用的 sql_trigger 參數搭配使用。

範圍和命名

您可以為探索、檢視區塊、欄位和集合命名。這些 Looker ID 不會加上引號。

LookML 欄位和集合有全名和簡稱：

全名格式為 <view>.<field-name | set-name>。左側會顯示範圍，也就是包含欄位或集合的檢視畫面。右側會指定特定欄位或集合名稱。
簡稱的形式為 <field-name | set-name>，不含分隔句點。Looker 會根據使用範圍，將簡短名稱擴展為完整名稱。

以下範例顯示多種形式的名稱和範圍。這組欄位並不實際，但可做為範例，說明各種可能的範圍運算式。

view: orders {                   # "orders" becomes the containing scope
  measure: count {               # short name, equivalent to orders.count
    type: count
  }
  dimension: customer_id {       # short name, equivalent to orders.customer_id
    type: number
    sql: ${TABLE}.customer_id ;;
  }
  dimension: customer_address {  # short name, equivalent to orders.customer_address
    sql: ${customer.address} ;;  # full name, references a field defined in the "customer" view
  }
  set: drill_fields {            # short name, equivalent to orders.drill_fields
    fields: [
      count,                     # short name, equivalent to orders.count
      customer.id                # full name, references a field defined in the "customer" view
    ]
  }
}

在 dimension: customer_address 宣告中，請注意 SQL 區塊 (customer) 的基礎檢視區塊與封閉檢視區塊範圍 (orders) 不同。當您需要比較兩個不同檢視區塊之間的欄位時，這會很有用。

當檢視畫面 (以下稱為「檢視畫面 A」) 參照在不同檢視畫面 (以下稱為「檢視畫面 B」) 中定義的欄位時，請注意下列事項：

使用 include 參數時，檢視區塊 B 檔案必須與檢視區塊 A 位於同一個模型中。
檢視區塊 B 必須在至少一個「探索」中與檢視區塊 A 彙整。如要瞭解彙整，請參閱「在 LookML 中使用彙整」頁面。

SQL 方言

Looker 支援多種資料庫類型，例如 MySQL、Postgres、Redshift 和 BigQuery。每個資料庫支援的特徵集略有不同，函式名稱也不一樣，這就是所謂的 SQL 方言。

LookML 的設計宗旨是支援所有 SQL 方言，因此不會偏好任何一種方言。不過，您需要在特定 LookML 參數中加入 SQL 程式碼運算式 (稱為 SQL 區塊)。有了這些參數，Looker 會直接將 SQL 運算式傳遞至資料庫，因此您必須使用與資料庫相符的 SQL 方言。舉例來說，如果您使用 SQL 函式，該函式必須是資料庫支援的函式。

SQL 區塊

部分 LookML 參數需要您提供原始 SQL 運算式，Looker 才能瞭解如何從資料庫擷取資料。

以 sql_ 開頭的 LookML 參數會預期某種形式的 SQL 運算式。例如：sql_always_where、sql_on 和 sql_table_name。SQL 區塊最常見的 LookML 參數是 sql，用於維度和測量指標欄位定義，指定定義維度或測量指標的 SQL 運算式。

您在 SQL 區塊中指定的程式碼可以是單一欄位名稱，也可以是相關子查詢等複雜程式碼。內容可能相當複雜，幾乎可滿足您在原始 SQL 中表達自訂查詢邏輯的任何需求。請注意，SQL 區塊中使用的程式碼必須與資料庫使用的 SQL 方言相符。

維度和測量指標的 SQL 區塊範例

以下是維度和測量指標的 SQL 區塊範例。LookML 替代運算子 ($) 可能會讓這些 sql 宣告看起來不像 SQL。不過，完成替代作業後，產生的字串就是純 SQL，Looker 會將其插入查詢的 SELECT 子句。

dimension: id {
  primary_key: yes
  sql: ${TABLE}.id ;;   # Specify the primary key, id
}
measure: average_cost {
  type: average
  value_format: "0.00"
  sql: ${order_items.cost} ;;   # Specify the field that you want to average
}
dimension: name {
  sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
dimension: days_in_inventory {
  type: int
  sql: DATEDIFF(${sold_date}, ${created_date}) ;;
}

如最後兩個維度所示，SQL 區塊可使用基礎資料庫支援的函式 (例如本例中的 MySQL 函式 CONCAT 和 DATEDIFF)。

含有相關子查詢的 SQL 區塊範例

您可以在欄位的 SQL 區塊中放置任何 SQL 陳述式，包括相關的子選取項目。範例如下：

view: customers {
  dimension: id {
    primary_key: yes
    sql: ${TABLE}.id ;;
  }
  dimension: first_order_id {
    sql: (SELECT MIN(id) FROM orders o WHERE o.customer_id=customers.id) ;;
         # correlated subselect to derive the value for "first_order_id"
  }
}

衍生資料表的 SQL 區塊範例

衍生資料表會使用 SQL 區塊指定衍生資料表的查詢。範例如下：

view: user_order_facts {
  derived_table: {
    sql:            # Get the number of orders for each user
      SELECT
        user_id
        , COUNT(*) as lifetime_orders
      FROM orders
      GROUP BY 1 ;;
  }
  # later, dimension declarations reference the derived column(s)

  dimension: lifetime_orders {
    type: number
  }
}

LookML 欄位類型參照

在另一個欄位中參照現有 LookML 欄位時，您可以使用雙冒號 (::) 加上所選類型，指示 Looker 將參照欄位視為特定資料類型。舉例來說，如果您在另一個欄位中參照 orders.created_date 維度，可以使用 ${orders.created_date::date} 語法，確保 created_date 欄位在 Looker 產生的 SQL 中會視為日期欄位，而不是轉換為字串。

您可以在參照中使用的資料類型，取決於所參照原始欄位的資料類型。舉例來說，如果您參照字串欄位，唯一可指定的資料類型是 ::string。以下是每種欄位類型可用的允許欄位類型參照完整清單：

在參照字串欄位時，您可以使用 ::string。
在參照數字欄位時，您可以使用 ::string 和 ::number。
如要參照日期或時間欄位，可以使用 ::string、::date 和 ::datetime。
使用 ::string 和 ::date 的參照會以查詢時區傳回資料，而使用 ::datetime 的參照則會以資料庫時區傳回資料。
在參照 yesno 欄位時，您可以使用 ::string、::number 和 ::boolean。
如果資料庫方言不支援布林資料類型，就無法使用 ::boolean 類型的欄位參照。
在位置欄位的參照中，您可以使用 ::latitude 和 ::longitude。

搭配日期欄位使用 LookML 欄位類型參照

舉例來說，假設您有 enrollment_month 維度和 graduation_month 維度，這兩個維度都是在type: time 的維度群組中建立。在本範例中，enrollment_month 維度是由 type: time 的下列維度群組產生：


dimension_group: enrollment {
  type: time
  timeframes: [time, date, week, month, year, raw]
  sql: ${TABLE}.enrollment_date ;;
}

同樣地，graduation_month 維度是由下列 type: time 維度群組所建立：


dimension_group: graduation {
  type: time
  timeframes: [time, date, week, month, year, raw]
  sql: ${TABLE}.graduation_date ;;
}

使用 enrollment_month 和 graduation_month 維度，您可以建立 type: duration 的維度群組，計算學生從入學到畢業經過的月數或年數。不過，由於 Looker 產生的 SQL 中，部分日期欄位會轉換為字串，因此將 enrollment_month 和 graduation_month 維度設為 sql_start 和 sql_end 的值可能會導致錯誤。

為避免這些時間欄位轉換為字串時發生錯誤，其中一個做法是建立 type: duration 維度群組，並在 sql_start 和 sql_end 參數中參照 enrollment 和 graduation 維度群組的 raw 時間範圍：


dimension_group: enrolled {
  type: duration
  intervals: [month, year]
  sql_start: ${enrollment_raw} ;;
  sql_end: ${graduation_raw} ;;
}

在探索使用者介面中，這會產生名為「註冊時間」的維度群組，其中包含「註冊月數」和「註冊年數」這兩個維度。

如要簡化在 type: duration 的維度群組中使用 raw 時間範圍的做法，可以為 sql_start 和 sql_end 參數參照的欄位指定 ::date 或 ::datetime 參照類型。


dimension_group: enrolled {
  type: duration
  intervals: [month, year]
  sql_start: ${enrollment_month::date} ;;
  sql_end: ${graduation_month::date} ;;
}

這個範例中的 LookML 也會建立「註冊時間長度」維度群組，但使用 ::date 參照可讓 enrollment_month 和 graduation_month 維度使用，不必使用 raw 時間範圍或以 SQL 將這些維度轉換為字串。

如需 LookML 欄位型別參照如何用於建立 type: duration 自訂維度群組的其他範例，請參閱 dimension_group 參數說明文件頁面。

這個語法不適用於 type: list 的指標，因為自 Looker 6.8 起，指標就無法做為參照。

LookML 常數

constant 參數可讓您指定可在整個 LookML 專案中使用的常數。使用 LookML 常數，您只需定義一次值，即可在專案中接受字串的任何部分參照該值，進而減少 LookML 程式碼中的重複內容。

常數必須在專案資訊清單檔案中宣告，且常數值必須是字串。舉例來說，您可以定義值為 "Okayama" 的常數 city，如下所示：

constant: city {
  value: "Okayama"
}

然後，您可以使用 @{city} 語法，在整個專案中參照 city 常數。舉例來說，您可以在 users 探索中使用 city 常數和 label 參數：


explore: users {
  label: "@{city} Users"
}

接著，Looker 會在「探索」選單和探索標題中顯示「岡山使用者」，而非預設的「使用者」。

如要進一步瞭解如何使用 LookML 常數編寫可重複使用的程式碼，請參閱 constant 參數說明文件頁面。

納入 SQL 並參照 LookML 物件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。