查看参数

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

每个视图中都包含字段定义,每个定义通常对应底层表中的一列或 Looker 中的计算值。字段参考维度类型参考衡量类型参考中介绍了这些字段。

还有一些数据视图级别的设置,详见本页。

用法示例

将鼠标悬停在参数名称上可查看简要说明;点击参数可以跳转到对应的页面。
当参数可以设置为若干特定选项之一时,系统会首先列出默认值。

参数定义

参数名称 说明
结构参数
drill_fields(用于查看) 指定在展开视图中定义的措施时所显示的默认字段列表
extends(用于查看) 指定要由此视图扩展的视图
extension(用于查看) 指定该视图需要扩展,并且无法向用户显示
include 将文件添加到视图
test 创建数据测试以验证模型的逻辑。项目设置中包含一个要求执行数据测试的选项。为项目启用此功能后,项目中的开发者必须先运行数据测试,然后才能将更改部署到生产环境中。此参数有 explore_sourceassert 子参数。
set 定义一组用于其他参数的维度和衡量方式
view 创建视图
显示参数
label(用于查看) 指定视图名称在字段选择器中的显示方式
fields_hidden_by_default ADDED 21.12 设置为 yes 时,会默认隐藏视图中的所有字段。使用某个字段的 hidden: no 参数可显示该字段。
过滤条件参数
suggestions(用于查看) 针对此视图的所有维度启用或停用建议
查询参数
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 ADDED 21.4 将派生表设为增量 PDTincrement_key 用于指定应查询新数据的时间并将其附加到美国太平洋夏令时。
increment_offset 添加 21.4 increment_key 参数结合使用,以设置增量太平洋夏令时increment_offset 指定重建以考虑延迟到来的数据的先前时间段数量(以递增键的粒度表示)。
interval_trigger 已添加 21.20 interval_trigger 会为持久派生表指定重新构建时间表,格式为 "N (seconds | minutes | hours)"
materialized_view ADDED 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 在现有视图名称前添加一个加号 (+) 可对现有视图添加优化条件。如需了解详情和用例,请参阅 LookML 优化文档页面。
final 表示当前优化是视图所允许的最终优化。如需了解详情和用例,请参阅 LookML 优化文档页面。
应避免的参数
distkey 已移除 3.26 已被 distribution 取代
view_label AVOID 4.4 已替换为 label