查看参数

视图表示 Looker 中的数据表，无论该表是数据库原生表，还是使用 Looker 的派生表功能创建的。视图通常在视图文件中声明，每个文件包含一个视图。

每个视图中都有字段定义，每个字段定义通常对应于底层表中的列或 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	指定 PDT 在 BigQuery 中按一个或多个字段进行聚簇 在 Snowflake 上添加了对 cluster_keys 的支持
create_process	指定在需要自定义 DDL 命令的数据库方言上创建 PDT 的有序步骤序列。此参数具有子参数 sql_step。
datagroup_trigger	指定用于 PDT 重建政策的数据组
derived_table	基于派生表创建视图
distribution	设置在 Redshift 或 Aster 中构建的 PDT 的分布键
distribution_style	设置在 Redshift 中构建的 PDT 的分布样式
explore_source	根据“探索”定义原生派生表
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	指定 PDT 按 Presto 中的一个或多个字段或 BigQuery 中的单个日期/时间字段进行分区
persist_for（对于派生表）	设置 PDT 在重新生成之前的最长存在时间
publish_as_db_view	语句 publish_as_db_view: yes 会为 PDT 创建一个稳定的数据库视图，以便在 Looker 外部查询该表
sortkeys	设置在 Redshift 中构建的 PDT 的排序键
sql（对于派生表）	声明派生表的 SQL 查询
sql_create	定义 SQL CREATE 语句，以在需要自定义 DDL 命令的数据库方言上创建 PDT
sql_trigger_value	指定导致重新生成 PDT 的条件
table_compression	指定要在 Amazon Athena 中用于 PDT 的表压缩
table_format	指定要在 Amazon Athena 中用于 PDT 的表格式
细化参数
view: +view_name	在现有视图名称前添加加号 (�3)，以对现有视图进行细化。+如需了解详情和使用情形，请参阅 LookML 细化文档页面。
final	表示当前细化是允许对视图进行的最终细化。如需了解详情和使用情形，请参阅 LookML 细化文档页面。
应避免的参数
distkey	已移除 3.26 已替换为 distribution
view_label	避免使用 4.4 已替换为 label