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 名の前にプラス記号（+）を追加して、既存の Explore に絞り込みを追加します。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
final	現在のリファインメントが、Explore で許可されている最終リファインメントであることを示します。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
避けるべきパラメーター
access_filter_fields	6.0 で削除 access_filter に置き換え