此页面链接到定义字段的所有 LookML 参数。
字段有以下几种类型:
- 维度表示表格中的列,或基于某种列操作或组合计算得出的值
- 维度组只能用于基于时间的数据,并可让您一次创建多个基于时间的维度
- 测量与 SQL 中的聚合函数(如
COUNT
、SUM
、AVG
)类似,表示多行信息。 - 过滤器:创建一个仅供过滤器使用的字段,用户可以用来向模板化过滤器或条件联接提供输入
- 参数创建一个仅限过滤器的字段,用户可以使用该字段向液体
{% parameter %}
标记提供输入
用法示例
将鼠标悬停在参数名称上可查看简要说明;点击参数可以跳转到对应的页面。
当参数可以设置为若干特定选项之一时,系统会首先列出默认值。
。
参数定义
D = 维度
DG = 维度组
DG = 维度组
M = 测量
F = 过滤器
F = 过滤器
P = 参数
参数名称 | 有效的字段类型 | 说明 |
---|---|---|
结构参数 | ||
dimension
|
D | 创建维度字段 |
dimension_group
|
DG | 同时创建多个基于时间的维度 |
filter
|
F | 创建仅供过滤条件的字段,以便在模板化过滤条件或条件联接中使用 |
measure
|
百万 | 创建测量字段 |
parameter
|
点球 | 创建一个仅供过滤器使用的字段,用户可以使用该字段向 Liquid {% parameter %} 标记提供输入 |
intervals
|
DG | 定义您想要在 dimension_group 和 type: duration 中使用的一组时长维度 |
timeframes
|
DG | 以 type: time 的形式定义您想要在 dimension_group 中使用的时间范围维度集 |
操作和关联参数 | ||
action
|
D 月 | 针对相应字段创建数据操作,让用户可以直接通过 Looker 在其他工具中执行任务 |
drill_fields
|
D DG M | 声明在细目或维度深入分析时显示的字段列表 |
link
|
D 月 | 创建指向其他 Looker 和外部内容的链接 |
tags
|
D DG M F P | 添加可传递到其他应用以提供字段数据的文本 |
显示参数 | ||
alias
|
D DG M F P | 允许具有旧字段名称的已保存网址在重命名字段后仍然有效 |
alpha_sort
|
D | 使 case 参数按字母顺序对其条件进行排序
|
description
|
D DG M F P | 向用户可在悬停鼠标时查看的字段添加说明 |
group_label
|
D DG M F | 在字段选择器中将视图内的字段归为一组 |
group_item_label
|
D DG M F | 在字段选择器中的组标签下方指定要用于字段的标签 |
hidden
|
D DG M F P | 在“探索”界面中隐藏字段 |
label
|
D DG M F P | 更改字段名称在字段选择器中的显示方式 |
label_from_parameter
|
D 月 | 根据 parameter 的输入,更改可视化图表中的字段名称的显示方式 |
order_by_field
|
D DG M | 按另一个字段的值对字段进行排序 支持维度和维度组 支持测量 |
style
|
D | 针对 type: tier 维度更改层级在 Looker 界面中的显示方式 |
view_label
|
D DG M F P | 更改字段选择器中视图内显示的字段 |
过滤条件参数 | ||
can_filter
|
D DG M | 确定是否可以将维度或衡量用作过滤条件 |
case_sensitive
|
D F | 确定过滤器对于维度是否区分大小写 |
filter
|
F | 创建仅供过滤条件的字段,以便在模板化过滤条件中使用 |
filters
|
百万 | 根据维度限制来限制测量结果的计算 |
skip_drill_filter
|
D | 停止在将细目细目到过滤器时将维度添加到过滤器 |
过滤建议参数 | ||
allowed_value
|
点球 | 指定 parameter 的选项 |
bypass_suggest_restrictions
|
D DG F P | 在使用sql_always_where 时向用户显示建议,但不对建议应用这些限制 |
full_suggestions
|
D DG F P | 在使用sql_always_where 时向用户显示建议,但务必对建议应用这些限制 |
suggest_dimension
|
D DG M F P | 根据不同维度的值根据字段提供建议 |
suggest_explore
|
D DG M F P | 根据不同探索的值来确定字段建议 |
suggest_persist_for
|
FP | 更改 Looker 过滤器建议的缓存设置 |
suggestable
|
D DG M F P | 针对某个字段启用或停用建议功能 |
suggestions
|
FP | 声明将用于字段建议的值列表 |
查询参数 | ||
allow_approximate_optimization |
百万 | 允许对 type: count 或 type: count_distinct 的测量值进行不同的近似估算,以便相应衡量指标可用于提升认知度 |
approximate |
百万 | 对 type: count_distinct 的测量值执行近似计数。如需查看支持此参数的方言列表,请参阅 approximate 文档页面。 |
approximate_threshold
|
百万 | 设置 BigQuery 从确切计数区分为大致计数的计数 |
convert_tz
|
D DG M F P | 为字段停用自动时区转换 |
datatype
|
D DG F M | 指定您向字段提供时间数据的类型 |
fanout_on
|
D DG M | 允许访问 Google BigQuery 重复字段 |
precision
|
百万 | 指定计算 Looker 对称汇总时要使用的小数位数 |
primary_key
|
D | 将维度声明为视图的主键 |
required_access_grants |
D DG F M P | 仅允许用户属性值与访问权限相匹配的用户访问字段 |
required_fields
|
D 月 | 要求在选择字段后向查询添加其他字段 |
sql_distinct_key
|
百万 | 定义要计算 type: sum_distinct 或 type: average_distinct 的计量单位的唯一实体 |
值和格式设置参数 | ||
case
|
D | 创建维度集可通过 SQL 条件确定的一组离散离散值 |
default_value
|
F P | 指定过滤条件字段的默认值 |
direction
|
百万 | 决定使用轴心时计算 type: percent_of_total 或 type: running_total 的测量值的方向 |
end_location_field
|
D | 定义包含 type: distance 字段的结束位置的字段 |
html
|
D DG M | 使用 Liquid 模板修改字段的 HTML 输出 |
list_field
|
百万 | 声明计算 type: list 的测量依据的维度 |
percentile
|
百万 | 为 type: percentile 或 type: percentile_distinct 指定小数值(第 N 百分位) |
sql
|
D DG M F | 确定字段的计算方式 |
sql_end
|
D DG | 为“时长类型”维度组或“时长类型”维度定义时长的结束时间 |
sql_latitude
|
D | 定义 type: location 维度的纬度 |
sql_longitude
|
D | 定义 type: location 维度的经度 |
sql_start
|
D DG | 定义“时长类型维度组”或“时长类型维度”的时长的开始时间。 |
start_location_field
|
D | 定义包含 type: distance 字段的起始位置的字段 |
tiers
|
D | 定义 type: tier 维度的层级 |
type (适用于维度、过滤条件或参数)
|
FP | 指定维度、过滤条件或参数的类型 |
type (适用于维度组)
|
DG | 指定维度组的类型 |
type (用于衡量)
|
百万 | 指定测量类型 |
string_datatype
|
D | 为 SQL Server 或 MySQL 的 type: string 字段指定 Unicode 数据类型 |
units
|
D | 指定要为 type: distance 字段使用的单位 |
value_format
|
D 月 | 使用 Excel 样式选项设置字段输出的格式 |
value_format_name
|
D 月 | 使用内置或自定义格式设置字段输出的格式 |
可视化参数 | ||
allow_fill
|
D DG | 确定某个维度是否允许填充维度 |
map_layer_name
|
D | 指定从数据值到您在内置或自定义地图上定义的地理区域的映射 |
应避免的参数 | ||
decimals
|
D 月 |
已移除 5.4
已替换为 value_format
|
format
|
D 月 |
已移除 3.16
由 value_format 取代 |