パラメータを表示

ビューは、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, ...]

  # 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 を追加 増分 PDT の increment_key パラメータと組み合わせて使用されます。increment_offset は、遅れて受信したデータを考慮して再構築する、以前の期間（インクリメント キーの粒度）の数を指定します。
interval_trigger	21.20 を追加しました interval_trigger は、永続的な派生テーブルの再構築スケジュールを "N (seconds | minutes | hours)" 形式で指定します。
materialized_view	21.10 で追加 ステートメント materialized_view: yes は、データベース上に派生テーブルのマテリアライズド ビューを作成します。
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 に置き換え