本页面演示了如何在 dashboard.lkml 文件中使用 LookML 信息中心参数添加和自定义 type: looker_boxplot 的 LookML 信息中心元素。
如需了解如何通过 Looker 界面构建箱线图,请参阅箱线图选项文档页面。
用法示例
N 表示需要提供数值。单引号表示描述性文字,不应包含在实际代码中。
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
view_name.field_name: 'looker filter expression'
listen:
dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]
## SERIES PARAMETERS
color_application:
collection_id: 'collection ID'
palette_id: 'palette ID'
options:
reverse: true | false
## STYLE PARAMETERS
show_view_names: true | false
## X-AXIS PARAMETERS
show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false
## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false
## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'
参数定义
| 参数名称 | 说明 | |
|---|---|---|
| 基本参数 | ||
name(适用于元素) |
创建元素 | |
title(适用于元素) |
更改元素名称向用户的显示方式 | |
type(适用于元素) |
确定要在元素中使用的可视化图表类型 | |
height(适用于元素) |
定义 layout: tile 和 layout: static 信息中心元素的高度(以 tile_size 为单位) |
|
width(适用于元素) |
定义 layout: tile 和 layout: static 信息中心内元素的宽度,单位为 tile_size |
|
top |
定义元素从上到下的位置,单位为 tile_size,适用于 layout: static 信息中心 |
|
left |
定义元素从左到右的位置,单位为 tile_size,适用于 layout: static 信息中心 |
|
row |
定义元素从上到下的位置(以行为单位),适用于 layout: newspaper 信息中心 |
|
col |
定义 layout: newspaper 信息中心内元素从左到右的位置(以列为单位) |
|
refresh(适用于元素) |
设置元素自动刷新的间隔 | |
note |
开始 LookML 部分,以定义元素的备注。此参数具有子参数 text、state 和 display。 |
|
| 查询参数 | ||
model |
定义要用于元素查询的模型 | |
explore(适用于元素) |
定义要用于元素查询的探索 | |
fields |
定义要用于元素查询的字段。这可以代替 dimensions 和 measures。 |
|
dimensions |
定义要用于元素查询的维度 | |
measures |
定义要用于元素查询的测量 | |
sorts |
定义要用于元素查询的排序 | |
limit |
定义要用于元素查询的行数上限 | |
filters(适用于元素) |
定义无法为元素查询更改的过滤条件 | |
listen |
定义可以为元素的查询更改的过滤条件(如果已创建 filters [针对信息中心]) |
|
query_timezone |
定义运行查询时应使用的时区 | |
hidden_fields |
指定要在查询中使用但在图表中隐藏的所有字段 | |
| 系列参数 | ||
color_application |
将颜色集合和调色板应用于图表 | |
| 样式参数 | ||
show_view_names |
在图表标签中显示或隐藏视图名称 | |
| X 轴参数 | ||
show_x_axis_label |
显示或隐藏 X 轴标签 | |
x_axis_label |
定义自定义 X 轴标签 | |
show_x_axis_ticks |
在 X 轴上显示值 | |
x_axis_gridlines |
从 X 轴延伸网格线 | |
x_axis_reversed |
反转 X 轴的方向 | |
x_axis_zoom |
指定是否允许沿 X 轴缩放 | |
| Y 轴参数 | ||
show_y_axis_labels |
显示或隐藏 Y 轴标签 | |
y_axis_labels |
定义自定义 Y 轴标签 | |
show_y_axis_ticks |
在 Y 轴上显示值 | |
y_axis_gridlines |
从 Y 轴延伸网格线 | |
y_axis_min |
定义 Y 轴的最小值 | |
y_axis_max |
定义 Y 轴的最大值 | |
y_axis_tick_density |
启用使用 y_axis_tick_density_custom 参数设置自定义 Y 轴刻度线密度的选项 |
|
y_axis_tick_density_custom |
当 y_axis_tick_density 设置为 custom 时,定义 Y 轴刻度线的密度 |
|
y_axis_reversed |
反转 Y 轴的方向 | |
y_axis_value_format |
定义 Y 轴值的数字格式 | |
y_axis_zoom |
指定是否允许沿 Y 轴缩放。如果 x_axis_zoom: false,则停用。 |
|
| 高级可视化图表配置参数 | ||
advanced_viz_config |
接受可替换多项可视化设置的 HighCharts JSON 代码段 | |
基本参数
定义 LookML 信息中心元素时,您必须至少为基本参数 name 和 type 指定值。其他基本参数(例如 title、height 和 width)会影响元素在信息中心内的外观和位置。
name
本部分介绍
name参数,该参数是信息中心元素的一部分。
name也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
每个 name 声明都会创建一个新的信息中心元素并为其分配一个名称。
元素名称必须是唯一的。当您使用 layout: grid 信息中心时,有时会在 elements 参数中引用名称;当您将元素整理到图块组 (type: group) 中时,有时会在子元素的 group 参数中引用名称。
- name: orders_by_date
title
本部分介绍
title参数,该参数是信息中心元素的一部分。
title也可以用作信息中心的一部分,如信息中心参数文档页面中所述。
title也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
借助 title 参数,您可以更改元素名称向用户显示的方式。如果未指定,标题默认为元素 name。
请参考下面的示例:
- name: sales_overview
title: '1) Sales Overview'
如果您使用此格式,则该元素不会显示为销售概览,而是显示为1) 销售概览。
type
本部分介绍
type参数,该参数是信息中心元素的一部分。
type也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
type也可以用作联接的一部分,如type(用于联接)参数文档页面中所述。
type也可以用作维度的一部分,如维度、过滤条件和参数类型文档页面中所述。
type也可以用作测量的一部分,如测量类型文档页面中所述。
type 参数用于确定要在元素中使用的可视化图表类型。
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
looker_waterfall | looker_wordcloud | looker_boxplot | button | group
如需简要了解不同类型的 LookML 信息中心元素,请参阅 type(适用于 LookML 信息中心)文档页面。
height
本部分介绍
height参数,该参数是信息中心元素的一部分。
height也可以用作信息中心行的一部分,如信息中心参数文档页面中所述。
对于采用 tile 或 static 布局的信息中心
height 参数用于定义元素的高度,单位为 tile_size(以像素为单位),适用于 layout: tile 和 layout: static 信息中心。
例如,以下代码指定了 tile_size: 100 和 height: 4,使 orders_by_date 元素的高度为 400 像素。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
对于采用 newspaper 布局的信息中心
height 参数以行为单位定义 layout: newspaper 信息中心内元素的高度。
采用报纸布局的信息中心默认元素高度为 6 行,即大约 300 像素。对于 preferred viewer 参数设置为 dashboards-next 的信息中心,最小高度为 1 行。对于 preferred viewer 参数设置为 dashboards 的信息中心,最小高度为 2 行。
例如,以下代码会将一个元素设置为 12 行高,即其他设置为默认值的元素的两倍高:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
本部分介绍
width参数,该参数是信息中心元素的一部分。
width也可以用作信息中心的一部分,如信息中心参数文档页面中所述。
width 参数用于定义 layout: tile 和 layout: static 信息中心内元素的宽度,单位为 tile_size。
例如,以下代码指定了 tile_size: 100 和 width: 4,使 orders_by_date 元素的宽度为 400 像素。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
width 参数用于定义 layout: newspaper 信息中心内元素的宽度(以列为单位)。
采用报纸布局的信息中心默认宽度为 24 列。
例如,以下代码会将元素设置为信息中心宽度的一半:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
top 参数定义元素从上到下的位置,单位为 tile_size,适用于 layout: static 信息中心。
例如,以下代码指定了 tile_size: 100 和 top: 4,将 orders_by_date 元素的上边缘定位在距离信息中心顶部 400 像素的位置。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left 参数用于定义元素在 layout: static 信息中心内从左到右的位置,以 tile_size 为单位。
例如,以下代码指定了 tile_size: 100 和 left: 4,将 orders_by_date 元素的左边缘定位在距离信息中心左侧 400 像素的位置。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
对于 layout: newspaper 信息中心,row 参数定义元素上边缘所在的行。如果使用 group 参数将元素放置在图块组内,则 row 会定义元素相对于组容器 (row: 0) 顶部的行位置。
信息中心从顶部的第 0 行开始。采用报纸布局的信息中心默认元素高度为 6 行,这意味着信息中心顶部的元素 (row: 0) 默认会占用第 0-5 行。
每行高 50 像素,这意味着默认元素高度(6 行)为 300 像素。
例如,以下代码会将一个元素设置为位于信息中心内的第二行元素中(假设元素设置为默认高度):
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
对于 layout: newspaper 信息中心,col 参数定义元素左边缘所在的列。如果使用 group 参数将元素放置在图块组内,则 col 会定义元素相对于组容器 (col: 0) 左边缘的列位置。
信息中心分为 24 列。信息中心从左侧的第 0 列开始。采用报纸布局的信息中心默认元素宽度为 8 列,这意味着信息中心左侧的信息中心元素 (col: 0) 默认会占用第 0-7 列。
例如,以下代码会将一个元素设置为信息中心内第三列元素:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
本部分介绍
refresh参数,该参数是信息中心元素的一部分。
refresh也可以用作信息中心的一部分,如信息中心参数文档页面中所述。
refresh 参数允许元素定期自动重新加载,从而检索最新数据。这在持续显示信息中心的环境中(例如在办公室电视上)通常很有用。请注意,信息中心必须在浏览器窗口中打开,此参数才能生效。此设置不会在后台运行以“预热”信息中心缓存。
刷新频率可以是任意秒数、分钟数、小时数或天数(不含小数)。例如:
- name: orders_by_date
refresh: 2 hours
设置较短的刷新间隔时,请务必谨慎。如果元素背后的查询需要大量资源,某些元素可能会给数据库带来超出预期的压力。
note
您可以向元素添加说明性备注,如下所示:
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note 具有子参数 text、state 和 display。
text
text 子参数用于指定备注中显示的文本。文本可以本地化。
state
state 子参数决定了当备注过大而无法在元素宽度内单行显示时,是collapsed还是expanded。如果您选择 collapsed,并且备注过长,则备注末尾会显示一个可点击的省略号 (...),点击该省略号即可阅读完整备注。
display
display 子参数决定了备注在元素上的显示位置。above 会将备注放在元素顶部,below 会将备注放在元素底部,hover 则需要用户将鼠标悬停在元素上才能看到备注。
查询参数
定义 LookML 信息中心元素时,您必须至少为 model 和 explore 查询参数指定值。
type: looker_boxplot 的元素还需要至少一个维度,以及以下类型中的两项、三项或五项测量(必须按此顺序排列):
- 最小值:表示最小数据值的度量。这可以在 LookML 中定义为
type: min的测量。 - 第 25 百分位数:表示第 25 百分位数或第一四分位数的度量。四分之一的数据值小于或等于此值。这可以在 LookML 中定义为
type: percentile的测量,并将percentile的值设置为25。 - 中位数:表示数据集的中位数或中点值,即第二个四分位数。有一半的数据值小于或等于此值。这可以在 LookML 中定义为
type: median的测量。 - 第 75 百分位数:表示第 75 百分位数或第三四分位数的度量。四分之三的数据值小于或等于此值。这可以在 LookML 中定义为
type: percentile的测量,并将percentile的值设置为75。 - 最大值:表示最大值的度量。这可以在 LookML 中定义为
type: max的测量。
您可以使用 fields 参数,或同时使用 dimensions 和 measures 参数,来指定箱线图元素所基于的维度和测量。如需详细了解如何在 Looker 界面中构建箱线图,请参阅箱线图选项文档页面中的构建箱线图部分。
您可以使用本部分中所述的其他查询参数来控制数据在信息中心元素中的显示方式。
model
model 参数定义要用于元素查询的模型。如果未指定,则默认为信息中心所在的模型。
- name: orders_by_date
model: ecommerce
model 参数接受 LookML 常量。您可以在项目的清单文件中定义一个常量,然后使用语法 "@{constant_name}" 将该常量设置为 model 的值。使用常量可让您在一个位置定义模型名称,如果您要更新多个信息中心元素所使用的模型名称,此功能尤为实用。
如需详细了解如何将常量与 LookML 信息中心搭配使用,并查看相关示例,请参阅 constant 参数文档页面。
explore
本部分介绍
explore参数,该参数是信息中心元素的一部分。
explore也可以用作模型的一部分,如explore参数文档页面中所述。
explore也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
explore 参数定义了要用于元素查询的探索。
- name: orders_by_date
explore: order
explore 参数接受 LookML 常量。您可以在项目的清单文件中定义一个常量,然后使用语法 "@{constant_name}" 将该常量设置为 explore 的值。使用常量可让您在一个位置定义探索的名称,如果您要更新多个信息中心元素使用的探索的名称,这会特别有用。
如需详细了解如何将常量与 LookML 信息中心搭配使用,并查看相关示例,请参阅 constant 参数文档页面。
fields
fields 参数定义要用于元素查询的字段。使用语法 view_name.dimension_name 指定字段。
## single field example
- name: orders_by_date
fields: order.order_date
## multiple fields example
- name: orders_by_date
fields: [order.order_date, order.order_count]
如果您使用 fields 参数,则无需使用 dimensions 和 measures 参数。
dimensions
dimensions 参数定义要用于元素查询的一个或多个维度。使用语法 view_name.dimension_name 指定维度。如果查询没有任何 dimensions,请勿添加。
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
measures 参数定义要用于元素查询的一个或多个测量。使用语法 view_name.measure_name 指定测量。如果查询没有任何 measures,请勿添加。
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
sorts 参数用于定义元素查询的排序行为。先列出主要排序字段,然后列出所有次要排序字段。使用 view_name.field_name 语法指定要作为排序依据的维度或测量。
如果您省略 sorts 参数,该元素将使用 Looker 的默认排序顺序。升序排序不需要后缀,而降序排序需要 desc 后缀。
以下示例定义了单个排序:
- name: orders_by_date
sorts: order.order_date desc
以下示例定义了多个排序:
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
如果您透视维度,则可以通过指定测量名称、排序方向和数据表中目标列的从 0 开始的索引编号来对查询结果进行排序。例如,以下元素使用索引 0 按第一个透视列排序:
- name: orders_by_category
sorts: [orders.count desc 0]
如需按行总计排序,请指定总计列的索引。例如,以下元素使用索引 2 按行总计排序,该索引表示具有两个透视列的查询的总计列:
- name: orders_by_cohort
sorts: [users.count desc 2]
limit
limit 参数定义了元素查询应使用的行数限制。此限制适用于应用任何透视之前的行数。
- name: orders_by_date
limit: 100
filters
本部分介绍
filters参数,该参数是信息中心元素的一部分。
filters也可以用作信息中心的一部分,如信息中心参数文档页面中所述。
filters也可以用作测量的一部分,如filters参数文档页面中所述。
filters 参数定义了应用于元素查询的不可更改的过滤条件。如果您希望用户可以在信息中心内更改过滤条件,则应使用filters(针对信息中心)设置过滤条件,然后使用 listen 将其应用于元素。
filters 的语法为:
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
每个过滤条件都可以接受 Looker 过滤表达式或值常量。您还可以在过滤表达式中使用 _localization 或 _user_attributes Liquid 变量,以实现灵活的过滤值。
listen
借助信息中心过滤条件,查看者可以交互式地优化信息中心元素中显示的数据。使用 filters 参数为 LookML 信息中心定义信息中心过滤条件。然后,使用 listen 参数将信息中心元素关联到信息中心过滤条件。
listen 的语法如下所示:
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
向元素添加 listen 参数,然后使用 view_name.field_name 语法提供过滤条件的名称,后跟英文冒号和对过滤条件应应用到的字段的引用。例如,您可以创建一个名为日期的过滤条件,要求用户在界面的过滤条件字段中输入日期。然后,您可以将用户输入的值应用于 orders_by_date 元素,如下所示:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
如果所监听的过滤条件配置了 vis_filter: true 参数,则过滤条件控件会直接显示在该可视化图表图块顶部的过滤条件栏中,而不是显示在顶部信息中心过滤条件栏中。
如需查看使用 filters 参数和 listen 参数将信息中心过滤条件应用于各个信息中心元素的其他示例,请参阅构建 LookML 信息中心。
query_timezone
query_timezone 参数指定运行查询的时区。时区选项显示在timezone 的值文档页面上。如果您希望查询使用查看者的时区运行,可以将该值指定为 user_timezone。
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
hidden_fields
hidden_fields 参数指示查询中使用了哪些字段(如果有),但在图表中隐藏了这些字段。所有隐藏字段都会显示在“探索”的数据表部分中。
hidden_fields: [inventory_items.count, distribution_centers.id]
系列参数
color_application
color_application 参数及其子参数 collection_id 和 palette_id 可用于将特定颜色集合和调色板应用于信息中心元素。如需简要了解 Looker 的原生颜色集合,请参阅颜色集合文档页面。
如果您知道要使用的调色板的合集 ID 和调色板 ID,可以将这些 ID 输入到 collection_id 和 palette_id 子参数中。集合 ID 或调色板 ID 可以是字母数字代码,也可以基于颜色集合的名称。Looker 的原生集合使用字母数字代码。它们是实例专用的,如下所示:
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
自定义颜色集合使用基于颜色集合名称的集合和调色板 ID,这些 ID 可在实例之间移植,如下所示:
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
您还可以使用界面查找所需的颜色、集合或调色板,并生成 LookML 以将其添加到信息中心。前往某个用户定义的内容(例如 Look、信息中心或探索),然后使用界面将所需的颜色、集合或调色板应用于该内容的可视化图表。完成此操作后,您可以按照获取信息中心 LookML 的步骤操作,复制生成的 LookML,并将其粘贴到 color_application 部分。
默认情况下,指定调色板的第一种颜色会应用于整个箱线图元素。可选子参数 reverse 会将应用切换到调色板中的最后一个颜色。
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
options:
reverse: true
样式参数
show_view_names
show_view_names 参数决定了是否在图表标签(例如轴名称和列名称)中显示视图名称。
show_view_names: true | false
## default value: true
X 轴参数
show_x_axis_label
此参数决定是否显示 X 轴标签。
show_x_axis_label: true | false
## default value: true
x_axis_label
此参数用于指定 X 轴的标签。当 show_x_axis_label 设置为 true 时,您可以使用此参数。
x_axis_label: Order Date
show_x_axis_ticks
此参数决定是否在 X 轴上显示值标签。
show_x_axis_ticks: true | false
## default value: true
x_axis_gridlines
此参数决定了是否从 X 轴延伸网格线。
x_axis_gridlines: true | false
## default value: false
x_axis_reversed
此参数用于设置 X 轴的方向。当 x_axis_reversed 设置为 false 时,值从左到右递增。如果设置为 true,则值会从左到右递减。
x_axis_reversed: true | false
x_axis_zoom
此参数用于指定用户是否可以放大可视化图表的 X 轴。当 x_axis_zoom 设置为 true 时,可以进行缩放。当 x_axis_zoom 设置为 false 时,缩放功能不可用。
如果 x_axis_zoom 设置为 false,则 y_axis_zoom 会停用。
x_axis_zoom: true | false
# default value: true
Y 轴参数
show_y_axis_labels
此参数决定是否在 Y 轴上显示标签。
show_y_axis_labels: true | false
## default value: true
y_axis_labels
此参数用于指定 y 轴的标签。当 show_y_axis_labels 设置为 true 时,您可以使用此参数。
y_axis_labels: ['label']
show_y_axis_ticks
此参数决定是否在 Y 轴上显示值。
show_y_axis_ticks: true | false
## default value: true
y_axis_gridlines
此参数决定了是否从 y 轴延伸网格线。
y_axis_gridlines: true | false
## default value: true
y_axis_min
此参数定义了 Y 轴的最小值。
y_axis_min: ['10']
## default value: true
y_axis_max
此参数定义了 Y 轴的最大值。
y_axis_max: ['100']
## default value: true
y_axis_tick_density
此参数可启用设置 Y 轴刻度线密度的选项。将 y_axis_tick_density 设置为 custom 以启用此功能,然后使用 y_axis_tick_density_custom 参数设置密度。
y_axis_tick_density: default | custom
## default value: default
y_axis_tick_density_custom
如果 y_axis_tick_density 设置为 custom,您可以使用此参数设置 Y 轴刻度的密度。它接受一个整数,表示您希望显示的刻度数。
y_axis_tick_density_custom: 10
## default value: 5
y_axis_reversed
此参数用于设置 y 轴的方向。如果 y_axis_reversed 设置为 false,则值会沿轴向上增加。如果设置为 true,则值会沿轴向下递减。
## y_axis_reversed: true | false
# default value: false
y_axis_value_format
此参数指定 Y 轴值的数字格式,与底层维度或测量无关。该参数接受 Excel 样式格式。如果未指定格式,则值将以底层维度或测量值的格式显示。
您为 y_axis_value_format 参数指定的值必须用英文双引号括起来:
y_axis_value_format: "*00#.00"
您可以在 Excel 的文档中阅读有关如何指定这些格式的完整指南。不过,Looker 目前不支持日期格式和颜色格式。
下面列出了一些最常见的格式设置选项:
| 值格式 | 含义 |
|---|---|
# |
整数 (123) |
*00# |
整数,用零填充至 3 位 (001) |
0.## |
最多 2 位小数的数字(1.、1.2 或 1.23) |
0.00 |
数字(小数点后正好 2 位,例如 1.23) |
*00#.00 |
数字用零填充到 3 位,且恰好有 2 位小数 (01.23) |
#,### |
千位分隔符为英文逗号的数字 (1,234) |
#,##0.00 |
数字,千位分隔符为英文逗号,小数点后 2 位 (1,234.00) |
0.000,," M" |
以百万为单位的数字,保留 3 位小数(1.234 M)。系统会自动除以 100 万。 |
$# |
美元,不带小数位 ($123) |
$0.00 |
美元(小数点后 2 位,例如 $123.00) |
$#,##0.00 |
美元,千位分隔符为英文逗号,保留 2 位小数 ($1,234.00) |
#% |
百分比(小数点后 0 位,1%)。系统会自动乘以 100。 |
0.00% |
百分比(小数点后 2 位,例如 1.00%)。系统会自动乘以 100。 |
0.00\% |
百分比(小数点后 2 位,例如 1.00%)。系统不会自动乘以 100。 |
y_axis_zoom
此参数用于指定用户是否可以放大可视化图表的 Y 轴。当 y_axis_zoom 设置为 true 时,可以进行缩放。
如果 y_axis_zoom 设为 false,用户将无法放大 y 轴的较小部分。不过,如果 x_axis_zoom 参数设置为 true,用户可能仍可以放大 x 轴的较小部分。
如果 x_axis_zoom 设置为 false,则 y_axis_zoom 会停用。
y_axis_zoom: true | false
# default value: true
高级可视化图表配置
本部分中介绍的参数对应于可选的图表配置替换项,您可以通过点击可视化编辑器图表部分中的修改图表配置按钮,将这些替换项应用于图表。
advanced_vis_config
此参数接受 HighCharts JSON 代码段,该代码段会覆盖多项可视化设置并开启新功能。如需查看使用 HighCharts JSON 实现常见用例的示例,请参阅使用图表配置编辑器自定义可视化图表文档页面。
advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"
# This example changes the color to orange for any series value that is greater than or equal to 50.
# default value: null