正在建设中:我们正在努力为此网页添加更多资源。在此期间,请参阅时间轴图表选项文档页面,了解如何使用可视化选项菜单创建和修改时间轴图表。
本页介绍的参数可与 dashboard.lkml
文件中 type: looker_timeline
的 LookML 信息中心元素一起使用。
如需了解如何通过 Looker 界面构建时间轴图表,请参阅时间轴图表选项文档页面。
基本参数
定义 LookML 信息中心元素时,您必须至少为 name
和 type
基本参数指定值。其他基本参数(如 title
、height
和 width
)会影响元素在信息中心的外观和位置。
name
本部分引用了信息中心元素中的
name
参数。
name
也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
每个 name
声明都会创建一个新的信息中心元素并为其命名。元素名称必须是唯一的。使用 layout: grid
信息中心时,elements
参数有时会引用名称。
- 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
如需简要了解不同类型的 LookML 信息中心元素,请参阅 type
(适用于 LookML 信息中心)文档页面。
height
本部分引用了信息中心元素中的
height
参数。
height
也可以用作信息中心行的一部分,如信息中心参数文档页面中所述。
对于具有 tile
或 static
布局的信息中心
height
参数用于为 layout: tile
和 layout: static
信息中心定义元素的高度,以 tile_size
(以像素为单位定义)为单位。
例如,以下代码会指定 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
信息中心的元素高度(以 row 为单位)。
报纸版式的信息中心的默认元素高度为 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
参数用于定义 layout: static
信息中心元素的元素自上而下的位置(以 tile_size
为单位)。
例如,以下代码会指定 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
参数用于定义元素顶部边缘所在的行。
信息中心从信息中心顶部的第 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
参数定义了元素左侧边缘所在的列。
信息中心分为 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
会要求用户将鼠标悬停在元素上才能看到备注。
查询参数
定义 type: looker_timeline
的 LookML 信息中心元素时,您必须至少为 model
和 explore
查询参数指定值。您的查询还必须包含 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
参数文档页面。
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
指定维度或测量值。如果您想使用 Looker 的默认排序顺序,请勿添加 sorts
。降序排序以 desc
为后缀;升序排序无需添加后缀。
## single sort example
- name: orders_by_date
sorts: order.order_date desc
## multiple sort example
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
pivots
pivots
参数定义了应该为元素查询进行数据透视的维度。使用语法 view_name.dimension_name
指定维度。如果查询没有任何 pivots
,请勿添加。
## single pivot example
- name: orders_by_date
pivots: customer.gender
## multiple pivot example
- name: orders_by_date
pivots: [customer.gender, customer.age_tier]
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
液体变量来设置灵活的过滤条件值。
listen
信息中心可以使用过滤条件来更改信息中心元素背后的数据。这些设置通过使用filters
信息中心参数进行设置。为了使影响某个元素的过滤条件,必须使用 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
例如,您可以创建一个名为 Date 的过滤条件,要求用户在界面中的过滤条件字段中输入日期。然后,您可以将用户输入的值应用到 orders_by_date
元素,如下所示:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
构建 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
merged_queries
merged_queries
参数定义了如何从多个查询中合并结果。您可以在 merged_queries
参数下定义组件查询,并使用 join_fields
子参数来定义合并规则。
merged_queries
的语法为:
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: 'field from the source query using the view_name.field_name syntax'
source_field_name: 'joined field from the primary query using the
view_name.field_name syntax'
# more join_fields definitions as needed
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
# more join_fields definitions as needed
# additional source queries and join_fields definitions as needed
在 merged_results
下定义的第一个查询是主查询,其他查询将合并到该查询中。
例如,通过联接股票代码、公司名称和 Twitter 用户名,您可以合并两个查询,以返回公司名称、公司 Twitter 用户名、IPO 年份、股票代码、员工数量和职位数的结果:
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
filters:
company.twitter_username: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: crunchbase
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.twitter_username: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: company.name
- field_name: companies.twitter_username
source_field_name: company.twitter_username
数据结果的格式如下所示:
然后,您可以应用元素参数,根据需要设置可视化图表的样式。
hidden_fields
hidden_fields
参数用于指明在查询中使用哪些字段(如有),但隐藏在图表中。所有隐藏字段都会显示在“探索”的数据表格部分。
hidden_fields: [inventory_items.count, distribution_centers.id]
选项参数
本部分中介绍的大多数参数都对应于时间轴图表的可视化编辑器的选项部分中的选项。
color_application
color_application
参数及其子参数 collection_id
和 palette_id
可用于将特定的颜色集合和调色板应用于信息中心元素。如需简要了解 Looker 的原生颜色集合,请参阅颜色集合文档页面。
如果您有要使用的调色板的集合 ID 和调色板 ID,可在 collection_id
和 palette_id
子参数中输入这些 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
部分。
groupBars
确定可视化图表是否应在各自的行中显示每个记录栏,或每个标签值的记录栏是否都应在同一行中。如果您将 groupBars
设置为 true
,则具有相同标签值的所有记录在可视化图表中将显示为同一行的单独条形。
groupBars: true | false
labelSize
指定标签的字体大小。例如:
labelSize: 12pt
valueFormat
指定数值的数字格式或日期格式。该参数接受 Excel 样式的格式。如果未指定格式,则该值将以基础维度或测量单位的格式显示。
showLegend
在可视化图表的底部显示或隐藏图例。
showLegend: true | false