Exploreパラメーター

このページには、explore パラメータの子であるすべての LookML パラメータへのリンクが含まれています。

Explore は、Looker アプリケーションにおけるクエリの出発地になります。Explore はビューを参照し、各 Explore には他のビューへの結合を含めることができます。通常、Explore はモデルファイルで宣言する必要があります。

使用例

パラメータ名にカーソルを合わせると簡単な説明が表示されます。クリックするとそのページに移動します。 パラメータをいくつかの特定のオプションのいずれかに設定できる場合は、デフォルト値が最初にリストされます。

## 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 （Explore の場合）	この Explore によって拡張される Explore（複数可）を指定します。
extension （Explore の場合）	この Explore 自体をユーザーに公開できず、Explore に拡張が必要であることを指定します。
explore （モデルの場合）	Explore メニューでビューを公開します。
fields （Explore の場合）	Explore の基本ビューから、および Explore の結合を介して使用可能なフィールドを制限します。
tags （Explore の場合）	他のアプリケーションに渡すことができるテキストを指定します。
表示パラメーター
description （Explore の場合）	UI でユーザーに表示される Explore の説明を追加します。
group_label （Explore の場合）	Explore メニューで見出しとして使用するグループラベルを作成します。
hidden （Explore の場合）	Explore メニューから Explore を非表示にします。
label （Explore の場合）	Explore メニューに Explore が表示される方法を変更します。
query （Explore の場合）	ユーザーが Explore のクイックスタートメニューで選択できる、事前定義されたクエリを作成します。
view_label （Explore の場合）	Explore の基本ビューのフィールドグループが、フィールドピッカーでどのようにラベルを付けられるかを指定します。
フィルタパラメーター
access_filter	ユーザー固有のフィルタを Explore に追加します。
always_filter	ユーザーが変更できるが削除できないフィルタを Explore に追加します。
case_sensitive （Explore の場合）	フィルターが Explore で大文字と小文字を区別するかどうかを指定します。
conditionally_filter	ユーザーが特定のリストから独自のフィルタを追加しない場合に、フィルタを Explore に追加します。
sql_always_having	この Explore でユーザーが変更も削除もできない条件をクエリの HAVING 句に挿入します。
sql_always_where	この Explore でユーザーが変更も削除もできない条件をクエリの WHERE 句に挿入します。
結合パラメーター
always_join	Explore に常に適用される必要のある結合を指定します。
join	Explore に追加のビューを結合します。結合とそのパラメーターの詳細については、結合パラメーターのリファレンスページを参照してください。
クエリ パラメータ
cancel_grouping_fields	特定のフィールドが Explore で選択されたときに、GROUP BY 句をキャンセルします。
from （Explore の場合）	Explore のベースとなるビューを指定し、そのビューのフィールドを Explore の名前で参照します。
persist_for （Explore の場合）	Explore のキャッシュ設定を変更します。
persist_with （Explore の場合）	Explore のキャッシングポリシーに使用するデータグループを指定します。
required_access_grants （Explore の場合）	アクセス権限と一致するユーザー属性値を持つユーザーのみに、Explore へのアクセスを限定します。
sql_table_name （Explore の場合）	Explore のベースとなるデータベーステーブルを指定します。
symmetric_aggregates	Explore で対称集計を有効にするかどうかを指定します。
view_name （Explore の場合）	Explore のベースとなるビューを指定し、そのビューのフィールドをビューの名前で参照します。
集計テーブルパラメーター
aggregate_table	Explore でクエリの集計認識を使用するためにサマリー表を作成します。aggregate_table パラメータの詳細については、aggregate_table パラメータのページをご覧ください。集計認識の概要については、集計テーブルの自動認識のドキュメント ページをご覧ください。
query	サマリー表のクエリを定義します。query とそのサブパラメータの詳細については、aggregate_table パラメータのページをご覧ください。
materialization	集計テーブルの永続性戦略を指定します。materialization とそのサブパラメータの詳細については、aggregate_table パラメータのページをご覧ください。
リファインメントパラメーター
explore: +explore_name	既存のエクスプローラ名の前にプラス記号（+）を追加すると、既存の Explore に絞り込みが追加されます。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
final	現在の絞り込みが、Explore で許可されている最終絞り込みであることを示します。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
避けるべきパラメーター
access_filter_fields	6.0 で削除 access_filterに置き換え