查看参数

在 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 与 increment_key 参数结合使用，用于 增量 PDT。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 （适用于 derived_table）	设置 PDT 在重新生成之前的最长使用时间
publish_as_db_view	语句 publish_as_db_view: yes 会为 PDT 创建稳定的数据库视图，以便在 Looker 外部查询表
sortkeys	设置在 Redshift 中构建的 PDT 的排序键
sql （适用于 derived_table）	声明派生表的 SQL 查询
sql_create	定义 SQL CREATE 语句，以便在需要自定义 DDL 命令的数据库方言上创建 PDT
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