彙整參數

這個頁面會連結至 join 參數的所有子項 LookML 參數。如要進一步瞭解如何使用聯結,請參閱「在 LookML 中使用聯結」說明文件頁面。

聯結可將多個檢視區塊新增至單一探索,讓使用者同時存取及比較不同檢視區塊的欄位。您可以在模型檔案中宣告探索和任何所需的 join 參數。

應用實例

將游標懸停在參數名稱上,即可查看簡短說明;按一下參數名稱即可跳到該頁面。 如果參數可設為多個特定選項之一,預設值會列在最前面。

## STRUCTURAL PARAMETERS
explore: explore_name {
  # Desired Explore parameters (described on Explore Parameters page)

  join: join_name  {

    # DISPLAY PARAMETERS
    view_label: "desired label for the view"

    # JOIN PARAMETERS
    fields: [field_or_set, field_or_set, ...]
    foreign_key: dimension_name
    from: view_name
    outer_only: no | yes
    relationship: many_to_one | many_to_many | one_to_many | one_to_one 
    required_joins: [view_name, view_name, ...]
    sql_on: SQL ON clause ;;
    sql_table_name: table_name ;;
    type: left_outer | cross | full_outer | inner 

    # QUERY PARAMETERS
    required_access_grants: [access_grant_name, access_grant_name, ...]
    sql_where: SQL WHERE condition ;;
  }
  # Possibly more join declarations
}

參數定義

參數名稱 說明
結構參數
join 將其他檢視區塊彙整至「探索」
顯示參數
view_label (加入) 變更聯結的檢視名稱在欄位選擇器中的顯示方式
彙整參數
fields (加入) 決定要將彙整中的哪些欄位帶入探索
foreign_key 使用已彙整檢視區塊的主鍵,指定探索與彙整之間的關係
from (加入) 指定要以哪個檢視區塊為準進行聯結
outer_only 指定所有查詢是否都必須使用外部聯結
relationship 將聯結宣告為具有一對一、多對一、一對多或多對多關係
required_joins 指定在選擇特定聯結的欄位時,應將哪些聯結套用至探索
sql_on 撰寫 SQL ON 子句,指定「探索」與聯結之間的關係
sql_table_name (加入) 指定要用於聯結的資料庫表格
type (加入) 將聯結宣告為左、完整、內部或交叉類型
查詢參數
required_access_grants (加入) 限制只有使用者屬性值符合存取權授予條件的使用者,才能加入聯結
sql_where 如果查詢中包含這項聯結,系統會在查詢的 WHERE 子句中插入條件,使用者無法變更或移除這項條件。(僅適用於 BigQuery)
應避免使用的參數
sql (加入) 避免使用 3.10 已由 sql_onforeign_keytype 和/或 sql_table_name 的組合取代,詳情請參閱這篇文章
sql_foreign_key 避免 3.16 已替換為 foreign_key