您正在查看 Looker 26.4 的文档。点击此链接可查看最新文档。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

LookML 信息中心的瀑布图参数

此页面演示了如何在 dashboard.lkml 文件中使用 LookML 信息中心参数添加和自定义 type: looker_waterfall 的 LookML 信息中心元素。

如需了解如何通过 Looker 界面构建瀑布图，请参阅瀑布图选项文档页面。

用法示例

N 表示需要数值。单引号表示描述性文字，不应包含在实际代码中。


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_waterfall
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note_state: collapsed | expanded
note_display: above | below | hover
note_text: 'note text'

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
hidden_fields: [view_name.field_name, view_name.field_name, …]
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## SERIES PARAMETERS
up_color: &#34;hex string&#34; | 'CSS named color string'
down_color: &#34;hex string&#34; | 'CSS named color string'
total_color: &#34;hex string&#34; | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
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`	对于 `layout: static` 信息中心，以 `tile_size` 为单位定义元素的自上而下位置
`left`	定义 `layout: static` 信息中心内元素的从左到右位置，单位为 `tile_size`
`row`	以行为单位定义 `layout: newspaper` 信息中心内元素的自上而下位置
`col`	以列为单位定义 `layout: newspaper` 信息中心内元素的从左到右位置
`refresh`（适用于元素）	设置元素自动刷新的间隔
`note_state`	定义注释是否会折叠或展开（如果注释太大而无法放在元素宽度内的单行中）
`note_display`	定义注释在元素上的显示位置
`note_text`	指定注释中显示的文本
查询参数
`model`	定义要用于元素查询的模型
`explore`（适用于元素）	定义要用于元素查询的探索
`fields`	定义要用于元素查询的字段。此值可代替 `dimensions` 和 `measures` 使用。
`dimensions`	定义要用于元素查询的维度
`measures`	定义要用于元素查询的指标
`sorts`	定义要用于元素查询的排序
`fill_fields`	定义利用维度填充选项的维度
`limit`	定义要用于元素查询的行数限制
`filters`（适用于元素）	定义了元素的查询无法更改的过滤条件
`filter_expression`	定义了无法针对元素查询更改的自定义过滤条件
`listen`	定义了元素的查询可更改的过滤条件（如果已创建 `filters` [针对信息中心]）
`hidden_fields`	指定要在查询中使用但要在图表中隐藏的任何字段
`query_timezone`	定义运行查询时应使用的时区
`merged_queries`	定义合并结果查询
系列参数
`up_color`	设置图表中正值条的颜色
`down_color`	设置图表中负值条的颜色
`total_color`	设置图表中总价值条的颜色
`color_application`	将颜色集合和调色板应用于图表
值参数
`show_value_labels`	显示每个数据条的标签
`label_color`	为标签指定颜色值
X 轴参数
`x_axis_scale`	指定如何计算 x 轴比例
`show_x_axis_label`	显示或隐藏 x 轴标签
`show_x_axis_ticks`	显示 x 轴上的值
`x_axis_zoom`	指定是否允许沿 x 轴缩放
Y 轴参数
`show_y_axis_labels`	显示或隐藏 y 轴标签
`show_y_axis_ticks`	显示 y 轴上的值
`y_axis_gridlines`	从 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 参数中引用名称。

- 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` 布局的信息中心

对于 layout: tile 和 layout: static 信息中心，height 参数用于定义元素的高度，单位为 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` 布局的信息中心

对于 layout: newspaper 信息中心，height 参数用于定义元素的高度（以行为单位）。

采用报纸布局的信息中心默认将元素高度设为 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 还可以用作信息中心的一部分，如信息中心参数文档页面中所述。

对于 layout: tile 和 layout: static 信息中心，width 参数用于定义元素的宽度（以 tile_size 为单位）。

例如，以下代码指定了 tile_size: 100 和 width: 4，使 orders_by_date 元素的宽度为 400 像素。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

对于 layout: newspaper 信息中心，width 参数用于定义元素的宽度（以列为单位）。

采用报纸布局的信息中心默认宽度为 24 列。

例如，以下代码将元素设置为信息中心宽度的一半：

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

`top`

对于 layout: static 信息中心，top 参数用于定义元素从上到下的位置，单位为 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`

对于 layout: static 信息中心，left 参数用于定义元素的从左到右位置，单位为 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_state`

note_state 参数用于定义当注释过大而无法在元素宽度内显示在一行中时，是折叠还是展开注释。如果您选择 collapsed，但注释过长，则注释将以可点击的省略号 (...) 结尾，您可以使用该省略号来阅读完整注释。如果您选择 expanded，并且记事内容较长，则记事会显示在多行中。

`note_display`

note_display 参数用于定义注释在元素上的显示位置。above 将注释放置在元素的顶部，below 将注释放置在元素的底部，而 hover 则要求用户将鼠标悬停在 ? 图标上才能看到注释。

`note_text`

note_text 参数用于指定元素注释中显示的文本。

查询参数

定义 LookML 信息中心元素时，您必须至少为 model 和 explore 查询参数指定值，并且必须使用 dimensions 参数、measures 参数或 fields 参数指定至少一个字段。您还可以使用其他查询参数来控制数据在信息中心元素中的显示方式。

`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 语法指定维度或衡量指标。如果您想使用 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]

`fill_fields`

fill_fields 参数用于定义使用维度填充选项的维度。使用 view_name.dimension_name 语法指定维度。

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

`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 变量，以实现灵活的过滤条件值。

`filter_expression`

filter_expression 参数用于为元素的查询定义不可更改的自定义过滤条件。如果您希望用户可以在信息中心内更改过滤条件，则应使用信息中心的 filters 设置过滤条件，然后使用 listen 将其应用于元素。

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Looker 过滤表达式文档页面列出了 Looker 过滤表达式。

`listen`

借助信息中心过滤条件，观看者可以互动式地优化信息中心元素中显示的数据。使用 LookML 信息中心的 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

向元素添加 listen 参数，然后提供过滤器的名称，后跟英文冒号和对应用过滤器的字段的引用（使用 view_name.field_name 语法）。例如，您可以创建一个名为 Date 的过滤条件，要求用户在界面中的过滤条件字段中输入日期。然后，您可以将用户输入的值应用于 orders_by_date 元素，如下所示：

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

如需查看有关如何使用 filters 参数和 listen 参数将信息中心过滤条件应用于各个信息中心元素的更多示例，请参阅构建 LookML 信息中心。

`hidden_fields`

hidden_fields 参数用于指明查询中使用了哪些字段（如果有），但这些字段在图表中处于隐藏状态。任何隐藏字段都将显示在探索的数据表部分。

hidden_fields: [inventory_items.count, distribution_centers.id]

`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 子参数指定应如何合并结果。

以下示例 LookML 代码创建了一个合并结果元素（值为 type: looker_grid）。在此示例中，merged_queries 参数用于创建一个信息中心元素，该元素将两个单独查询中的数据合并到一个表格图表中：

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

在此示例中，信息中心元素合并了两个源查询的数据，这两个源查询均基于 ecommerce 模型中的 users 探索。主查询包含 users.state、users.count 和 users.city 字段，并按 users.count 字段对结果进行排序。第二个源查询包含 users.state 和 users.city 字段，并按 users.state 字段对结果进行排序。

join_field 参数会根据 users.state 和 users.city 字段中的匹配值合并源查询。

listen 参数会对两个查询应用 State 过滤条件，从而让信息中心查看者通过选择特定州来优化信息中心图块中显示的查询结果。

示例：合并公司数据

假设您要创建一个合并查询，将来自两个不同探索（company_info 和 companies）的公司信息合并在一起。您希望联接每个探索中的 ipo.stock_symbol、companies.name 和 companies.contact_email 字段，以创建一个查询，该查询可返回公司名称、公司联系电子邮件地址、首次公开募股 (IPO) 年份、股票代码、员工人数和职位数量的结果。您可以在 LookML 中按如下方式定义合并的查询元素：

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-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: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

对合并的查询元素应用过滤条件

合并查询元素的上一个示例演示了如何使用 filters 参数直接在每个源查询中应用硬编码的过滤条件。例如，主查询中的过滤条件 companies.contact_email: "-NULL" 和 ipo.valuation_amount: NOT NULL 将结果限制为具有有效联系电子邮件地址和估值的公司。这些查询级过滤条件会在合并查询之前预先过滤数据，并且无法由用户更改。

您还可以使用每个来源查询定义中的 listen 参数，对合并的查询元素应用信息中心过滤条件。例如，假设您有一个名为 Industry 的信息中心过滤条件，您已使用 LookML 信息中心的 filters 参数在信息中心级定义了该过滤条件：

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

如需将 Industry 过滤条件应用于两个来源查询中的 companies.industry 字段，请按如下所示将 listen 参数添加到每个合并查询的来源查询定义中：

listen:
  Industry: companies.industry

例如，以下示例代码将 Industry 过滤条件添加到上一个示例中合并结果元素中的两个源查询。

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-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: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

添加此功能后，当用户与 Industry 信息中心过滤条件互动时，合并查询元素中的相应源查询将相应地进行过滤。

序列形参

本部分中介绍的参数对应于瀑布图的可视化图表编辑器的序列菜单中的选项。

`up_color`

设置图表中正值条的颜色。颜色值可以采用用引号括起来的十六进制字符串（例如“#2ca6cd”），也可以采用 CSS 命名颜色字符串（例如 mediumblue）。

up_color: blue

up_color 参数会替换 color_application 参数（如果使用）。

`down_color`

设置图表中负值条的颜色。颜色值可以采用用引号括起来的十六进制字符串（例如“#2ca6cd”），也可以采用 CSS 命名颜色字符串（例如 mediumblue）。

down_color: &#34;#ff0000&#34;

down_color 参数会替换 color_application 参数（如果使用）。

`total_color`

设置图表中总值条的颜色。颜色值可以采用用引号括起来的十六进制字符串（例如“#2ca6cd”），也可以采用 CSS 命名颜色字符串（例如 mediumblue）。

total_color: yellow

total_color 参数会替换 color_application 参数（如果使用）。

`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 部分。

`color_application` 以及正值、负值和总值条形图

默认情况下，指定调色板的第一种颜色会应用于瀑布图中的正值条形图，调色板的第二种颜色会应用于瀑布图中的负值条形图，而指定调色板的第三种颜色会应用于瀑布图中的总计条形图。可选的子形参 reverse 会将应用分别更改为最后一种颜色、倒数第二种颜色和倒数第三种颜色。

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

如果同时使用 up_color、down_color 和 total_color 参数以及 color_application 参数，前者会替换后者中指定的任何颜色。

值形参

本部分中介绍的参数对应于瀑布图的可视化图表编辑器的值菜单中的选项。

`show_value_labels`

在数据点旁边显示条形、折线或点的值。

show_value_labels: true | false

## default value: false

`label_color`

label_color 参数接受标签的颜色值。颜色值可以采用十六进制字符串格式（例如 #2ca6cd），也可以采用 CSS 命名颜色字符串格式（例如 mediumblue）。


label_color: [blue]

X 轴参数

本部分中介绍的参数对应于瀑布图的可视化图表编辑器的 X 菜单中的选项。

`x_axis_scale`

此参数用于确定 x 轴比例的计算方式。

auto：系统会根据底层数据推断出比例。这是默认设置。
ordinal：数据将绘制为等间距的离散条目。
time：数据将按时间绘制，并且轴将相应地标记。如果无法将基础数据转换为日期，此函数将无法正常运行。

x_axis_scale: auto | ordinal | time

## default value: auto

`show_x_axis_label`

此参数用于确定是否显示 x 轴标签。

show_x_axis_label: true | false

## default value: true

`show_x_axis_ticks`

此参数用于确定是否在 x 轴上显示值。

show_x_axis_ticks: true | false

## default value: true

`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 轴参数

本部分中介绍的参数对应于瀑布图的可视化图表编辑器中的 Y 菜单中的选项。

`show_y_axis_labels`

此参数用于确定是否显示 Y 轴标签。

show_y_axis_labels: true | false

## default value: true

`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_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

LookML 信息中心的瀑布图参数 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

用法示例

参数定义

基本参数

name

title

type

height

对于采用 tile 或 static 布局的信息中心

对于采用 newspaper 布局的信息中心

width

top

left

row

col

refresh

note_state

note_display

note_text

查询参数

model

explore

fields

dimensions

measures

sorts

fill_fields

limit

filters

filter_expression

listen

hidden_fields

query_timezone

merged_queries