字段参数

此页面链接到定义字段的所有 LookML 参数。

字段有以下几种类型:

  • 维度表示表格中的列,或基于某种列操作或组合计算得出的值
  • 维度组只能用于基于时间的数据,并可让您一次创建多个基于时间的维度
  • 测量与 SQL 中的聚合函数(如 COUNTSUMAVG)类似,表示多行信息。
  • 过滤器:创建一个仅供过滤器使用的字段,用户可以用来向模板化过滤器条件联接提供输入
  • 参数创建一个仅限过滤器的字段,用户可以使用该字段向液体 {% parameter %} 标记提供输入

用法示例

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

参数定义

D = 维度
DG = 维度组
M = 测量
F = 过滤器
P = 参数

参数名称 有效的字段类型 说明
结构参数
dimension D 创建维度字段
dimension_group DG 同时创建多个基于时间的维度
filter F 创建仅供过滤条件的字段,以便在模板化过滤条件或条件联接中使用
measure 百万 创建测量字段
parameter 点球 创建一个仅供过滤器使用的字段,用户可以使用该字段向 Liquid {% parameter %} 标记提供输入
intervals DG 定义您想要在 dimension_grouptype: 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: counttype: 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_distincttype: average_distinct 的计量单位的唯一实体
值和格式设置参数
case D 创建维度集可通过 SQL 条件确定的一组离散离散值
default_value F P 指定过滤条件字段的默认值
direction 百万 决定使用轴心时计算 type: percent_of_totaltype: running_total 的测量值的方向
end_location_field D 定义包含 type: distance 字段的结束位置的字段
html D DG M 使用 Liquid 模板修改字段的 HTML 输出
list_field 百万 声明计算 type: list 的测量依据的维度
percentile 百万 type: percentiletype: 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 取代