探索參數

這個頁面會連結至 explore 參數的所有子項 LookML 參數。

在 Looker 應用程式中，「探索」是查詢的起點，探索會參照檢視區塊，每個探索可包含與其他檢視區塊的彙整。探索通常應在模型檔案中宣告。

應用實例

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

## STRUCTURAL PARAMETERS

explore: explore_name {
  extension: required
  extends: [explore_name,  explore_name, ...]
  fields: [field_or_set, field_or_set, ...]
  tags: ["string1", "string2", ...]

  # DISPLAY PARAMETERS
  description: "Description I want"
  group_label: "Label to use as a heading in the Explore menu"
  hidden: yes | no
  label: "desired label"
  query:  {
      # Desired query parameters (described on the query page)      }
  view_label: "Field picker heading I want for the Explore's fields"

  # FILTER PARAMETERS

  access_filter: {
    field: fully_scoped_field
    user_attribute: user_attribute_name
  }

  # Possibly more access_filter declarations

  always_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
  }
  case_sensitive: yes | no
  conditionally_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
    unless: [field_name, field_name, ...]
  }
  sql_always_having: SQL HAVING condition ;;
  sql_always_where: SQL WHERE condition ;;

  # JOIN PARAMETERS

  always_join: [view_name, view_name, ...]
  join: view_name {
    # Desired join parameters (described on Join Parameters page)
  }
  # Possibly more join declarations

  # QUERY PARAMETERS

  cancel_grouping_fields: [fully_scoped_field, fully_scoped_field, ...]
  from: view_name
  persist_for: "N (seconds | minutes | hours)"
  persist_with: datagroup_name
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;
  sql_preamble: SQL STATEMENT  ;;
  symmetric_aggregates: yes | no
  view_name: view_name

  # AGGREGATE TABLE PARAMETERS

  aggregate_table: table_name {
    query:  {
      # Desired query parameters (described on the aggregate_table page)
    }
    materialization:  {
      # Desired materialization parameters (described on the aggregate_table page)
    }
  }
  # Possibly more aggregate_table declarations
}

## REFINEMENT PARAMETERS

explore: +explore_name {
  final: yes
}

參數定義

參數名稱	說明
結構參數
extends (適用於「探索」)	指定這個探索要擴充的探索
extension (適用於「探索」)	指定探索需要擴充功能，且本身無法向使用者顯示
explore (適用於模型)	在「探索」選單中顯示檢視畫面
fields (適用於「探索」)	限制探索中可用的欄位，包括基本檢視表和探索的彙整
tags (適用於「探索」)	指定可傳遞至其他應用程式的文字
顯示參數
description (適用於「探索」)	為使用者在 UI 中看到的探索新增說明
group_label (適用於「探索」)	建立群組標籤，做為「探索」選單中的標題
hidden (適用於「探索」)	從「探索」選單隱藏探索資料
label (適用於「探索」)	變更「探索」選單中顯示探索的方式
query (適用於「探索」)	建立預先定義的查詢，供使用者在「探索」的「快速入門」選單中選取。
view_label (適用於「探索」)	指定在欄位挑選器中，如何標示「探索」基礎檢視畫面中的一組欄位
篩選參數
access_filter	在「探索」中新增使用者專屬篩選器
always_filter	在探索中新增使用者可變更但無法移除的篩選條件
case_sensitive (適用於「探索」)	指定探索的篩選器是否區分大小寫
conditionally_filter	如果使用者未從特定清單新增自己的篩選器，則會將篩選器新增至探索
sql_always_having	在查詢的 HAVING 子句中插入條件，使用者無法變更或移除此條件以供探索
sql_always_where	在查詢的 WHERE 子句中插入條件，使用者無法變更或移除此條件以供探索
彙整參數
always_join	指定必須一律套用至探索的聯結
join	將其他檢視區塊彙整至探索。如要進一步瞭解彙整及其參數，請參閱「彙整參數」參考頁面。
查詢參數
cancel_grouping_fields	在「探索」中選擇特定欄位時，取消 GROUP BY 子句
from (適用於「探索」)	指定探索所依據的檢視區塊，並依據探索的名稱參照該檢視區塊的欄位
persist_for (適用於「探索」)	變更「探索」的快取設定
persist_with (適用於「探索」)	指定用於「探索」快取政策的資料群組
required_access_grants (適用於「探索」)	限制只有使用者屬性值符合存取權限的使用者才能存取「探索」
sql_table_name (適用於「探索」)	指定探索所依據的資料庫資料表
symmetric_aggregates	指定是否為「探索」啟用對稱匯總
view_name (適用於「探索」)	指定探索功能所依據的檢視區塊，並依據檢視區塊名稱參照該檢視區塊的欄位
匯總資料表參數
aggregate_table	建立匯總資料表，以便在「探索」中查詢時使用匯總感知功能。如要瞭解 aggregate_table 參數，請參閱aggregate_table 參數頁面。如要瞭解匯總感知功能，請參閱「匯總感知」說明文件頁面。
query	定義匯總資料表的查詢。如要瞭解 query 及其子參數，請參閱 aggregate_table 參數頁面。
materialization	定義匯總資料表的持續性策略。如要瞭解 materialization 及其子參數，請參閱 aggregate_table 參數頁面。
修正參數
explore: +explore_name	在現有探索名稱前面加上加號 (+)，即可為現有探索新增修正項目。如要瞭解詳情和使用案例，請參閱「LookML 修飾」說明文件頁面。
final	表示目前是「探索」允許的最後一次調整。如要瞭解詳情和使用案例，請參閱「LookML 修飾」說明文件頁面。
應避免使用的參數
access_filter_fields	已移除 6.0 已替換為 access_filter