パラメータを表示

ビューは、Looker におけるデータのテーブルを表します。そのテーブルがデータベースにネイティブのものであるか、Looker の派生テーブル機能を使用して作成されたものであるかは問いません。通常、ビューはビューファイルで宣言され、1 つのファイルに 1 つのビューが含まれます。

各ビュー内ではフィールド定義（通常は Looker の基礎テーブルの列（計算）にそれぞれ対応したもの）を扱います。これらのフィールドについては、フィールドリファレンス、ディメンションタイプリファレンス、メジャータイプリファレンスを参照してください。

また、多くのビューレベルの設定があり、このページではそれらについて説明します。

使用例

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

## STRUCTURAL PARAMETERS

include:"filename_or_pattern"
## Possibly more include declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # CUSTOM CALENDAR PARAMETERS

    calendar_definition: {
      Custom calendar mapping parameters ;;
    }

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

パラメータの定義

パラメータ名	説明
構造的パラメーター
drill_fields （ビューの場合）	ビューに定義されたメジャーのドリルダウン時に表示されるフィールドのデフォルトリストを指定します。
extends （ビューの場合）	このビューによって拡張するビュー（複数可）を指定します。
extension （ビューの場合）	ビュー自体ではユーザーに公開できず、ビューに拡張が必要であることを指定します。
include	ビューにファイルを追加します。
test	モデルのロジックを検証するためのデータテストを作成します。プロジェクト設定には、データテストを必要とするオプションが含まれています。プロジェクトでこのオプションが有効になっていると、そのプロジェクトの開発者は変更内容を実動環境にデプロイする前にデータテストを実行する必要があります。このパラメータには、explore_source サブパラメータと assert サブパラメータがあります。
set	他のパラメーターで使用されるディメンションとメジャーのセットを定義します。
view	ビューを作成します。
表示パラメーター
label （ビューの場合）	フィールドピッカーでのビュー名の表示方法を指定します。
fields_hidden_by_default	21.12 で追加 yes に設定すると、ビュー内のすべてのフィールドがデフォルトで非表示になります。フィールドを表示するには、フィールドで hidden: no パラメータを使用します。
フィルタパラメーター
suggestions （ビューの場合）	このビューのすべてのディメンションの提案を有効または無効にします。
クエリ パラメータ
autogenerate_primary_keys （ビューの場合）	主キーの自動生成を有効または無効にします。
required_access_grants （ビューの場合）	アクセス権限と一致するユーザー属性値を持つユーザーのみにビューへのアクセスを限定します。
sql_table_name （ビューの場合）	ビューのベースとなる SQL テーブルを変更します。
派生テーブルパラメーター
cluster_keys	BigQuery の 1 つ以上のフィールドで PDT をクラスタ化することを指定します。 Snowflake での cluster_keys のサポートが追加されました。
create_process	カスタム DDL コマンドを必要とするデータベース ダイアレクトに PDT を作成するためのステップを順序だてて指定します。このパラメータには、サブパラメータ sql_step があります。
datagroup_trigger	PDT 再ビルドポリシーに使用するデータグループを指定します。
derived_table	ビューのベースとして派生テーブルを使用します。
distribution	Redshift または Aster でビルドされる PDT のディストリビューション キーを設定します。
distribution_style	Redshift でビルドされる PDT のディストリビューション スタイルを設定します。
explore_source	Explore をベースとするネイティブ派生テーブルを定義します。
increment_key	21.4 で追加 派生テーブルを 増分 PDT にします。increment_key は、新しいデータをクエリして PDT に追加する時間増分を指定します。
increment_offset	21.4 で追加 increment_key パラメータと組み合わせて、増分 PDT に使用します。increment_offset は、遅れて受信したデータを考慮して再構築する、以前の期間（インクリメント キーの粒度）の数を指定します。
interval_trigger	21.20 で追加 interval_trigger は、永続的な派生テーブルの再構築スケジュールを "N (seconds | minutes | hours)" 形式で指定します。
materialized_view	21.10 で追加 ステートメント materialized_view: yes は、データベース上に派生テーブルの<glossary term ref="materialized view">マテリアライズド ビュー</glossary term>を作成します。
indexes	従来のデータベース（MySQL、Postgres など）でビルドされる PDT、または Redshift のインターリーブ ソートキーの、インデックスを設定します。
partition_keys	Presto の 1 つ以上のフィールド、または BigQuery の 1 つの日時フィールドで、PDT をパーティション化することを指定します。
persist_for （derived_table の場合）	PDT が再生成されるまでの最大期間を設定します。
publish_as_db_view	ステートメント publish_as_db_view: yes により、Looker 外部のテーブルのクエリを可能にする PDT 用の安定したデータベースビューが作成されます。
sortkeys	Redshift でビルドされた PDT のソートキーを設定します。
sql （derived_table の場合）	派生テーブルの SQL クエリを宣言します。
sql_create	カスタム DDL コマンドを必要とするデータベース ダイアレクトに PDT を作成する SQL CREATE ステートメントを定義します。
sql_trigger_value	PDT が再生成される条件を指定します。
table_compression	Amazon Athena の PDT に使用するテーブル圧縮を指定します。
table_format	Amazon Athena の PDT に使用するテーブルの書式設定を指定します。
リファインメントパラメーター
view: +view_name	既存のビューの名前の前にプラス記号（+）を追加すると、既存のビューにリファインメントが追加されます。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
final	現在のリファインメントが、ビューで許可されている最終リファインメントであることを示します。詳細とユースケースについては、LookML の絞り込みのドキュメント ページをご覧ください。
避けるべきパラメーター
distkey	3.26 で削除 distributionに切り替えます。
view_label	4.4 で避けるべき事項 labelに切り替えます。