sql_analytic_model_name (適用於探索)

本頁面是指 探索中的 sql_analytic_model_name 參數。

sql_analytic_model_name 也可做為檢視區塊的一部分，詳情請參閱sql_analytic_model_name (適用於檢視區塊) 參數說明文件頁面。

用量

explore: explore_name {
  sql_analytic_model_name: analytic_model_name ;;
}
階層
explore
sql_analytic_model_name
預設值
無

接受
資料庫內分析模型名稱

特別規則
  • 分析模型僅支援 BigQuery 和 Snowflake 連線。
  • 只有在同一個檢視畫面可以說明資料庫中的多個分析模型時，才應使用探索的 sql_analytic_model_name。
  • sql_analytic_model_name 參照的分析模型必須可透過模型資料庫連線存取。
  • 如果分析模型位於與資料庫連線中定義的預設路徑不同的資料庫、結構定義、專案或資料集中，您必須設定分析模型名稱的範圍。

定義

如果是 BigQuery 和 Snowflake 連線，sql_analytic_model_name 參數會指定現有資料庫內分析模型的名稱 (BigQuery 圖表或 Snowflake 中的語意檢視區塊)，做為 LookML 探索的基礎。

在大多數情況下，您會使用 sql_analytic_model_name (適用於檢視區塊) 參數，在檢視表檔案中指定分析模型。然後，在該檢視表檔案中，根據資料庫中的分析模型定義 LookML 維度和測量指標。不過，如果資料庫有多個可由相同 LookML 欄位定義的分析模型，您可以使用 explore 參數下的 sql_analytic_model_name 參數。

在 explore 參數下指定 sql_analytic_model_name 時，探索會覆寫檢視區塊檔案中指定的分析模型，改為查詢 explore 參數下 sql_analytic_model_name 中指定的分析模型。在這種情況下，探索會使用檢視區塊檔案中定義的 LookML 指標和維度，但會將這些指標和維度套用至 explore 參數的 sql_analytic_model_name 參數中指定的分析模型。

設定分析模型名稱的範圍

如果只使用分析模型名稱參照分析模型，Looker 會使用 Looker 管理員在資料庫連線設定中設定的預設搜尋路徑 (資料庫和結構定義)。

如果需要在其他資料庫和結構定義中參照分析模型，但該模型不在資料庫使用者的預設搜尋路徑中，您可以使用 <database_name>.<schema_name>.<analytic_model_name> 格式來指定分析模型名稱，以指向其他資料庫或結構定義：

  • 如要參照其他結構定義中的分析模型，請使用 <schema_name>.<analytic_model_name>。
  • 如要參照其他資料庫的分析模型，請使用完整 <database_name>.<schema_name>.<analytic_model_name>。

如果是 Google BigQuery 連線，您可以透過 <project_name>.<dataset_name>.<analytic_model_name> 格式設定分析模型名稱的範圍，在不同專案和資料集中參照分析模型。詳情請參閱「Google BigQuery 連線」說明文件頁面。

範例

以下是名為 MyStoreGraphView 的 LookML 檢視區塊範例，該檢視區塊以 BigQuery 資料庫中的 StoreGraph BigQuery Graph 為基礎，包括對應至 Graph 的維度和指標：

view: MyStoreGraphView {
  sql_analytic_model_name: StoreGraph ;;

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

  dimension: population {
    type: number
    sql: Locations_population ;;
  }

  dimension: location_name {
    type: string
    sql: Locations_name ;;
  }

  measure: locations_total_population {
    type: number
    sql: Locations_total_population ;;
  }
}

假設資料庫有另一個名為 ShopDetailsGraph 的圖表，且與 StoreGraph 具有相同元素，以下是會覆寫 MyStoreGraphView 檢視表檔案中 sql_analytic_model_name 值的探索。探索會具有 MyStoreGraphView 中定義的相同 LookML 維度和測量指標，但探索會查詢 ShopDetailsGraph 分析模型：

explore: MyStoreGraphView {
  sql_analytic_model_name: ShopDetailsGraph ;;
}

注意事項

Looker 分析模型注意事項

使用資料庫內分析模型時，請注意下列事項和限制：

  • 資料類型：分析模型僅支援下列維度和指標資料類型：

    • 支援的維度和指標：
      • string
      • number
      • date
      • yesno
    • 僅支援以下維度：
      • time
      • date_time

  • 評估：

    • 必須預先定義基本指標：必須在基礎資料庫分析模型中預先定義基本指標。Looker 無法透過對分析模型中的維度執行匯總 (例如 type: sum 或 type: count)，定義新的基本指標。

    • 支援以其他指標為基礎的指標：您可以使用 LookML 指標的 sql 參數，執行使用分析模型中預先定義基礎指標的非匯總運算。建立以其他指標為依據的指標時，無法將新指標定義為匯總指標類型，例如 sum 或 count。您必須將新指標定義為非匯總指標類型，例如 string、number、date 或 yesno。請參閱以下範例：

      measure: average_order_amount {
  type: number
  sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;;
}

  • 彙整：如果探索的基本檢視畫面是以分析模型為基礎，就無法包含任何彙整。同樣地，以分析模型為基礎的檢視區塊，也無法彙整至具有標準 LookML 基本檢視區塊的「探索」。

  • 隱含聯結：分析模型不支援依賴隱含聯結的功能。依賴隱含聯結的功能示例包括自訂日曆，以及使用 type: location、type: distance 或 type: zipcode 定義的欄位。

  • 分析模型不支援下列功能：

分析模型必須可從目前的連線存取

在 explore 物件中使用 sql_analytic_model_name 參數時，該 explore 物件會納入 model 物件中。(本頁的「階層」會顯示這個關係鏈。) 模型物件會定義資料庫 connection。在 sql_analytic_model_name 參數中參照分析模型時，分析模型必須可在模型檔案中指定的相關聯連線內存取。

預設的資料庫和結構定義 (如果是 Google BigQuery，則是帳單專案和資料集) 是由 Looker 管理員在建立資料庫的 Looker 連線時定義。