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

LookML 信息中心的表格图表参数

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

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

用法示例


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_grid
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, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
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
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

参数定义

参数名称	说明
基本参数
`name`（适用于元素）	创建元素
`title`（适用于元素）	更改元素名称向用户的显示方式
`type`（适用于元素）	确定要在元素中使用的可视化图表类型
`height`（适用于元素）	针对 `layout: tile` 和 `layout: static` 信息中心，以 `tile_size` 为单位定义元素的高度
`width`（适用于元素）	定义 `layout: tile` 和 `layout: static` 信息中心内元素的宽度（以 `tile_size` 为单位）
`top`	以 `tile_size` 为单位定义 `layout: static` 信息中心内元素的自上而下位置
`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`	定义要用于元素查询的排序
`pivots`	定义应透视的维度，以用于元素的查询
`fill_fields`	定义利用维度填充选项的维度
`subtotals`	定义要计算小计的字段
`total`	指定是否为表格可视化图表显示列总计
`row_total`	指定是否显示表格可视化的行总计
`limit`	定义要用于元素查询的行数限制
`column_limit`	定义将用于元素查询的列限制
`filters`（适用于元素）	定义了元素的查询无法更改的过滤条件
`filter_expression`	定义了无法针对元素查询更改的自定义过滤条件
`listen`	定义了元素的查询可以更改的过滤条件（如果已创建 `filters` [针对信息中心]）
`query_timezone`	定义运行查询时应使用的时区
`analysis_config`	添加于 21.14 定义运行查询时应执行的预测分析。需要启用预测实验室功能。
`merged_queries`	定义合并结果查询
列参数
`auto_size_all_columns`	自动调整每个表格列的大小，使其宽度与列标题或最长数据值的宽度相同，以较宽者为准
`column_order`	对表格图表中的列进行排序
`pinned_columns`	定义要在表格图表左侧固定的列
图表参数
`table_theme`	将五种表格着色选项之一应用于表格可视化图表
`show_row_numbers`	设置是否在每个表格行的开头显示行号
`hide_totals`	设置表格可视化图表是否显示列总计
`hide_row_totals`	设置表格可视化图表是否显示行总计
`transpose`	设置是否将表格行转置为列
`hidden_fields`	指定要在查询中使用但要在图表中隐藏的任何字段
`limit_displayed_rows`	根据可视化图表中行在结果中的位置显示或隐藏行
系列参数
`truncate_text`	使用省略号 (…) 缩短列标题和数据单元格内的文本
`show_view_names`	显示视图名称以及每个列标题的字段名称
`size_to_fit`	自动调整所有列的宽度，使表格完美适应显示它的元素的宽度
`dynamic_fields`	表格图表中包含表计算或自定义字段
`series_labels`	为可视化图表中的每个列指定自定义标签
`series_column_widths`	为可视化图表中的列指定特定宽度
`series_cell_visualizations`	用于指定列是否使用单元格可视化图表可视化选项。此参数具有子参数 `is_active`、`palette` 和 `value_display`。
`series_text_format`	为每个列指定单元格文本布局。此参数具有子参数 `fg_color`、`bg_color`、`bold`、`italic` 和 `align`。
`series_collapsed`	指定具有小计的列是否会以收起状态显示
`series_value_format`	使用自定义格式定义列的值格式
设置参数格式
`color_application`	将颜色应用于单元格可视化图表和条件格式
`header_font_color`	为列标题应用字体颜色
`header_background_color`	为列标题的背景应用颜色
`header_text_alignment`	对列标题应用左对齐、右对齐或居中对齐
`header_font_size`	为列标题应用字体大小
`rows_font_size`	为数据单元格内的文字应用字号
`enable_conditional_formatting`	设置为 `true` 可为表格可视化图表定义颜色编码规则
`conditional_formatting_include_totals`	指定颜色编码方案中是否包含总计
`conditional_formatting_include_nulls`	指定是否应将 null 值表示为零
`conditional_formatting`	使用 `conditional_formatting` 及其子参数来定义用于为表格可视化图表添加颜色编码的规则

基本参数

定义 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]

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

`fill_fields`

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

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

`subtotals`

subtotals 参数用于定义使用小计选项的维度。使用 view_name.dimension_name 语法指定维度。

subtotals: [products.department, distribution_centers.name]

`total`

total 参数用于设置是否在表格底部显示总计行。如需了解详情，请参阅显示总计。

total: true | false

## default value: false

`row_total`

row_total 参数用于设置总计列显示在表格的右侧还是左侧。仅当存在透视时才有效。如需了解详情，请参阅显示总计。

row_total: right | left | false

## default value: false

`limit`

limit 参数定义了应针对元素查询使用的行数限制。此限制适用于应用任何透视之前的行数。

- name: orders_by_date
  limit: 100

`column_limit`

column_limit 参数用于定义应针对元素查询使用的列限制。此限制适用于应用任何透视后的列数。

- name: orders_by_date
  column_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 信息中心。

`query_timezone`

query_timezone 参数用于指定运行查询的时区。时区选项显示在timezone 的值文档页面上。如果您希望查询使用查看者的时区运行，可以将该值分配为 user_timezone。

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

`analysis_config`

analysis_config 参数及其子参数用于描述要与可视化图表搭配使用的任何查询分析（从 Looker 21.14 开始）。您必须启用预测实验室功能，才能对可视化图表执行分析。

您可以使用以下子参数来定义分析：

forecasting
confidence_interval
field_name
forecast_n
forecast_interval
seasonality

您可以使用如下语法创建预测：


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

`forecasting`

forecasting 是一种将预测应用于可视化的分析类型。通过预测功能，分析师可以快速将数据预测添加到新的或现有的探索查询中，帮助用户预测和监控特定数据点。

如需了解详情，请参阅可视化图表中的预测文档页面。

如需向可视化图表添加预测，必须启用预测实验室功能。

`confidence_interval`

confidence_interval 设置预测数据值的界限，以百分比的小数表达式形式输入。confidence_interval 是可选的，默认情况下为空。


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

请参阅在可视化图表中进行预测文档页面上的预测区间部分。

如需向可视化图表添加预测，必须启用预测实验室功能。

`field_name`

field_name 指定要纳入预测中的指标名称（最多 5 个）。


field_name: view_name.field_name

`forecast_n`

forecast_n 用于指定预测时长。


forecast_n: N # An integer that represents the length of the forecast

请参阅在可视化图表中进行预测文档页面上的长度部分。

如需向可视化图表添加预测，您必须启用预测实验室功能。

`forecast_interval`

forecast_interval 用于设置预测数据值的时长间隔。系统会根据探索查询中的时间范围维度自动填充 forecast_interval。


forecast_interval: day | month # a timeframe with dimension fill

请参阅长度文档页面。

如需向可视化图表添加预测，您必须启用预测实验室功能。

`seasonality`

seasonality 可让分析师在预测中考虑已知的周期或重复性数据趋势。seasonality 是可选的，默认情况下为空。


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

自动季节性调整设置以空白 seasonality 值表示。

请参阅在可视化图表中进行预测文档页面上的季节性部分。

如需向可视化图表添加预测，您必须启用预测实验室功能。

`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 信息中心过滤条件互动时，合并查询元素中的相应源查询将相应地进行过滤。

列参数

以下参数对应于表格图表中的移动和固定列功能。

`auto_size_all_columns`

auto_size_all_columns 参数可自动调整每个表格列的大小，使其宽度与列标题或最长数据值（以较宽者为准）的宽度相同。如果定义了 series_column_widths 和 size_to_fit 参数，此参数会替换这两个参数。

- name: orders_by_date
  auto_size_all_columns: true

`column_order`

column_order 参数用于定义表格图表中各列的顺序。

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

`pinned_columns`

pinned_columns 参数用于定义固定在表格图表左侧的任何列。

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

绘图参数

以下参数对应于表格图表的可视化图表编辑器的绘图菜单中的选项。

`table_theme`

使用 table_theme 参数可将以下表格着色选项之一应用于表格元素：

editable：该表包含蓝色维度、橙色指标和绿色表计算。
white：表格标题为白色，数据行在白色和灰色之间交替，文本为黑色。
gray：表格标题为灰色，数据行在白色和浅灰色之间交替，文本为深灰色。
transparent：表头完全透明，数据行在完全透明和半透明灰色之间交替，文本颜色会根据透出的背景颜色从黑色调整为白色（如果需要）。如果您使用的是自定义的嵌入式信息中心，将 table_theme 设置为 transparent 会很有用，这样一来，图块背景颜色就会显示在可视化图表中。
unstyled：表格标题和数据行为白色，文字为黑色。


table_theme: editable | white | gray | transparent | unstyled

`show_row_numbers`

show_row_numbers 参数用于设置是否在每个表格行的开头显示行号。


show_row_numbers: true | false

`hide_totals`

如果您的探索包含列总计，则 hide_totals 用于设置可视化图表是否显示总计。


hide_totals: true | false

`hide_row_totals`

如果您的探索包含行总计，hide_row_totals 用于设置行总计是否显示在可视化图表中。


hide_row_totals: true | false

`transpose`

借助 transpose 参数，您可以将表格行转置为列。它接受 true 或 false。

- name: orders_by_date
  transpose: true

`hidden_fields`

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

hidden_fields: [inventory_items.count, distribution_centers.id]

`limit_displayed_rows`

借助 limit_displayed_rows 参数，您可以根据可视化图表中各行在结果中的位置来显示或隐藏这些行。例如，如果您的可视化图表显示的是 7 天滚动平均值，您可能需要隐藏前 6 行。将其设置为 true 后，您可以使用 limit_displays_rows_values 参数及其子参数指定此设置所适用的可视化图表中的值和位置。

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

`limit_displayed_rows_values`

将 limit_displayed_rows_values 参数及其子参数 show_hide、first_last 和 num_rows 与 limit_displayed_rows 搭配使用，以指定要在可视化图表中显示或隐藏哪些行。如需查看使用示例，请参阅 limit_displayed_rows 部分。

`show_hide`

show_hide 子参数用于设置是否从可视化图表中隐藏某些行。将 show_hide 设置为 show 可在可视化图表中仅显示有限数量的行，将 show_hide 设置为 hide 可从可视化图表中排除某些行。

`first_last`

first_last 子形参用于设置要隐藏或显示的行是结果集中的第一行还是最后一行。将 first_last 设置为 first 可显示或隐藏前几行，而将 first_last 设置为 last 可显示或隐藏后几行。

`num_rows`

num_rows 子形参用于设置要隐藏或显示的行数。例如，num_rows: '10' 将在可视化图表中显示或隐藏结果集的前 10 行或后 10 行。

序列形参

以下参数对应于表格图表的可视化图表编辑器中序列菜单中的选项。

`truncate_text`

truncate_text 参数用于设置是否应使用省略号 (…) 缩短列标题和数据单元格内的文本。


truncate_text: true | false

`show_view_names`

show_view_names 参数用于确定是否在图表标签（例如轴名称和列名称）中显示视图名称。

show_view_names: true | false

## default value: true

`size_to_fit`

size_to_fit 参数用于设置是否调整所有列的宽度，使表格完全适合显示它的元素的宽度。如果 auto_size_all_columns 参数设置为 true，则会替换 size_to_fit。


size_to_fit: true | false

`dynamic_fields`

dynamic_fields 参数及其子参数用于描述要与可视化图表搭配使用的任何表格计算或自定义字段。您必须拥有创建自定义字段的权限，才能添加最多包含 255 个字符的 description，或使用 calculation_type 来创建自定义分组或自定义箱线图。您必须拥有创建表格计算的权限，才能向表格计算添加最多 255 个字符的 description，或使用 calculation_type 进行快捷计算。

您可以使用以下子参数来定义动态字段：

table_calculation
measure
dimension
label
based_on
type
expression
filter_expression
value_format
value_format_name
calculation_type
args
_kind_hint
_type_hint
is_disabled
description

您可以使用如下语法创建表计算：

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

您可以使用如下语法为多种计算类型创建快捷计算：

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

您可以使用如下语法创建自定义度量，以便在可视化图表中使用：

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

您可以使用如下语法创建过滤后的自定义度量，以便在可视化图表中使用：

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

您可以使用如下语法创建自定义维度，以便在可视化图表中使用：

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

您可以使用如下语法为维度创建自定义分组，以便在可视化图表中进行使用：

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

您可以使用如下语法为维度创建自定义箱，以用于可视化图表：

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

您可以向元素添加多个动态字段。您无需将表格计算添加到 fields 参数中，即可在可视化图表中显示表格计算，但您需要将其他类型的动态字段添加到 fields 中，才能显示这些字段。

`table_calculation`

如果您要定义表计算，则 table_calculation 子形参会命名该表计算。这是在 LookML 中引用表格计算时要使用的名称。

`measure`

measure 子形参用于定义自定义衡量指标或过滤后的自定义衡量指标的名称。这是您在 LookML 中引用度量的名称。

`dimension`

dimension 子形参用于定义自定义维度的名称。这是在 LookML 中引用相应维度的名称。

`label`

label 子参数用于定义动态字段的标题，该标题将显示在可视化图表中。此名称可能与 table_calculation、measure 或 dimension 子参数中指定的名称相同或不同。

`based_on`

如果您使用的是自定义衡量指标或经过过滤的自定义衡量指标，based_on 子形参会使用 view_name.field_name 语法来标识其所基于的衡量指标。

`type`

如果您使用的是自定义指标，type 子形参用于标识聚合类型。它接受 count_distinct、sum、average、min、max 或 median。

`description`

您可以使用 description 子形参为任何自定义字段或表格计算添加最多 255 个字符的说明。当用户在字段选择器中点击字段名称右侧的信息图标时，以及当用户在探索、信息中心或 Look 中的表格或表格图表可视化图表中将鼠标悬停在列名称上时，Looker 会显示说明。

`expression`

如果您使用的是表计算，expression 子形参用于定义创建表计算时使用的 Looker 表达式。

`filter_expression`

如果您使用的是自定义过滤后的度量，filter_expression 子形参用于定义用于过滤度量的 Looker 表达式。

`value_format`

可选的 value_format 子形参用于在使用自定义格式时定义动态字段的值格式。如果您想使用默认 Looker 格式，请改用 value_format_name。

`value_format_name`

可选的 value_format_name 子形参可为动态字段应用默认格式。如果您想使用自定义格式，请改用 value_format。

`calculation_type`

calculation_type 子参数用于定义要创建表格计算的快捷计算或分组函数类型，或为维度创建自定义分组：

自定义字段 calculation_type 选项：

group_by - 根据指定的自定义条件，将维度值归入自定义的固定标签下。与 SQL 中的 CASE WHEN 或 LookML case 字段参数类似。
bin - 将数值型维度和自定义维度的值分组到自定义箱或层级中。与 LookML tier 维度类型类似。

表计算 calculation_type 选项：

percent_of_column_sum - 行值除以相应列中各值之和。此计算仅包含在达到查询行数上限时数据表中包含的值。
percent_of_previous - 当前行的值除以下一行的值。
percent_difference_from_previous - 当前行的值与下一行的值之差除以下一行的值。
rank_of_column - 行的值在相应列所有值中的排名。此计算仅包含在达到查询行数上限时数据表中包含的值。
running_total - 列中当前行的值与前面所有行的值的累计总和。
percent_of_previous_column - 对于透视字段，当前列的值除以左侧一列的值。
percent_change_from_previous_column - 对于透视字段，当前列的值与左侧一列的值之差除以左侧一列的值。
percent_of_row - 对于透视字段，当前列的值除以该字段所在行的总和所得的百分比。
running_row_total - 对于透视字段，当前列与所在行中前面所有列的累计总和。

`args`（对于自定义群组）

如果您为某个维度使用自定义组，则 args 用于指定将固定标签应用于维度值的实参。args 采用以下格式：

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

您可以根据所需的分组数量，添加任意数量的 label 和 filter 条件。

请参阅上一个示例以供参考。

`args`（针对自定义分箱）

如果您要为数值维度使用自定义箱，则 args 用于指定将固定层级应用于维度值的实参。args 采用以下格式：

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

请参阅上一个示例以供参考。

快捷计算的 `args`

您可以在 args 子参数中指定用于快捷计算的数字字段的名称。实参采用以下格式：

- args:
  - view_name.field_name   ## the field on which the calculation is based

请参阅上一个示例以供参考。

`_kind_hint`

可选的 _kind_hint 子形参用于标识动态字段是返回维度还是指标。它接受的值为 dimension 和 measure。

`_type_hint`

可选的 _type_hint 子形参用于标识动态字段的表达式应生成的数据类型。

`is_disabled`

可选的 is_disabled 子形参用于指定表格计算是否显示在可视化图表及其基础探索中。它接受的值为 true 和 false。

`series_labels`

使用 name: label 对，根据序列名称设置一个或多个序列的标签。

对于透视图，序列名称是透视名称。

series_labels:
  'Yes': iOS Users
  'No': Android Users

对于包含多个指标的图表，序列名称是指标字段名称。

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

`series_column_widths`

根据序列名称设置一列或多列的宽度。如果 auto_size_all_columns 参数设置为 true，则会替换 series_column_widths。

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

`series_cell_visualizations`

使用 view_name.field_name 格式指明序列名称，以指定一个或多个列是否使用单元格可视化图表选项。series_cell_visualizations 具有子参数 is_active、palette 和 value_display。

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

`is_active`

可选的 is_active 子形参接受 true 或 false，用于指明是否为相应序列启用条形图可视化图表。如果未定义 is_active，则默认为 true。

`palette`

palette 子参数是可选的。如果不使用，调色板将默认为实例的默认颜色集合中的发散型调色板。

如果使用 palette，子形参 palette_id 和 collection_id 会将特定调色板中的颜色应用于条形图可视化图表。对于 palette_id，您必须使用顺序或发散调色板的 ID。如需详细了解调色板 ID 和颜色集合 ID，请参阅 color_application 部分。

palette 有一个替代子参数 custom_colors，用于设置 2 到 5 种要用于条形的自定义颜色：

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

`value_display`

可选的 value_display 子形参接受 true 或 false，用于指明是否显示每个数据单元格的值以及单元格可视化图表。如果未定义 value_display，则默认为 true。

`series_text_format`

series_text_format 参数及其子参数用于指定每列的单元格文本布局。要设置格式的序列使用 view_name.field_name 语法表示，子参数用于描述格式。

所有子形参均为可选形参；仅使用您需要的子形参。

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

`fg_color`

fg_color 子形参表示单元格文本的字体颜色。颜色值可以采用十六进制字符串（例如 #2ca6cd）或 CSS 命名颜色字符串（例如 mediumblue）。

`bg_color`

bg_color 子形参表示单元格背景颜色。颜色值可以采用十六进制字符串（例如 #2ca6cd）或 CSS 命名颜色字符串（例如 mediumblue）。

`bold`

bold 子形参用于指示单元格文本是否为粗体，接受 true 或 false。

`italic`

italic 子形参用于指明单元格文本是否为斜体，接受 true 或 false。

`align`

align 子参数用于指示单元格文本的对齐方式，并接受 left、center 或 right。

`series_collapsed`

series_collapsed 参数用于定义是收起还是展开特定序列的小计。使用 view_name.field_name 语法和 true 或 false 标识序列。

series_collapsed:
  users.city: false
  users.state: true

如果列处于收起状态，点击数据单元格左侧的箭头即可显示构成小计的各个元素。

`series_value_format`

series_value_format 参数用于指定要应用于序列的格式，与应用于基础维度或指标的任何格式无关。如果未指定 series_value_format，则以相应维度或指标的格式显示值。

使用 view_name.field_name 语法标识要设置格式的序列。

借助 format_string 子形参，您可以采用 Excel 样式格式定义序列的格式。

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

您还可以按如下方式定义格式：


series_value_format:
  order_items.count: "00#"

format_string 子参数中使用的格式与 value_format LookML 参数中使用的格式相同。如需了解如何指定这些格式，请参阅向数字字段添加自定义格式文档页面。

设置参数格式

以下参数对应于表格图表的可视化图表编辑器的格式菜单中的选项。

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

`header_font_color`

header_font_color 参数可为列标题应用字体颜色。

颜色值可以采用十六进制字符串（例如 #2ca6cd）或 CSS 命名颜色字符串（例如 mediumblue）。


header_font_color: purple

默认颜色取决于使用 table_theme 参数定义的表格主题。

`header_background_color`

header_background_color 参数用于为背景列标题应用颜色。

颜色值可以采用十六进制字符串（例如 #2ca6cd）或 CSS 命名颜色字符串（例如 mediumblue）。


header_background_color: #add8e6

默认颜色取决于使用 table_theme 参数定义的表格主题。

`header_text_alignment`

header_text_alignment 参数可将 left、right 或 center 对齐方式应用于列标题。


header_text_alignment: center

默认对齐方式为 left。

`header_font_size`

header_font_size 参数将 1 到 99 之间的字体大小应用于列标题。


header_font_size: 16

标题和行字体的默认大小为 12。

`rows_font_size`

rows_font_size 参数会将字体大小从 1 应用到 99 数据单元格内的文本，但不会应用到列标题。


rows_font_size: 8

标题和行字体的默认大小为 12。

`enable_conditional_formatting`

将 enable_conditional_formatting 设置为 true 后，您就可以定义规则，以按比例或通过指定感兴趣的值来对表格可视化图表进行颜色编码。


enable_conditional_formatting: true | false

`conditional_formatting_include_totals`

如果 enable_conditional_formatting 设置为 true，conditional_formatting_include_totals 会指定颜色编码方案中是否包含总计。


conditional_formatting_include_totals: true | false

`conditional_formatting_include_nulls`

如果 enable_conditional_formatting 设置为 true，conditional_formatting_include_nulls 用于指定是否应将 null 值表示为零。


conditional_formatting_include_nulls: true | false

`conditional_formatting`

如果 enable_conditional_formatting 设置为 true，请使用 conditional_formatting 参数定义用于对表格可视化图表进行颜色编码的规则。对于每条条件格式规则，您都可以使用以下参数指定设置：

type
value
background_color
font_color
color_application
bold
italic
strikethrough
fields

以下是条件格式规则的示例：


conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

`type`

type 参数用于指定是沿某个比例对值进行颜色编码，还是根据逻辑条件对值进行颜色编码。

如果您要对某个范围内的值进行颜色编码，可以将 type 设置为 along a scale...。

如果您要根据逻辑条件为值设置颜色编码，可以为 type 指定以下值之一，同时为 value 指定一个值：

equal to：规则适用于等于为 value 指定的数字的值。
not equal to：规则适用于不等于为 value 指定的数字的值。
greater than：相应规则适用于大于为 value 指定的数字的值。
less than：相应规则适用于小于 value 所指定数值的值。
between：相应规则适用于介于为 value 指定的两个数字之间的值。
not between：该规则适用于不在为 value 指定的两个数字之间的值。
'null'：相应规则仅适用于 null 值。
not null：该规则仅适用于非 null 值。


type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

`value`

如果您要根据除 'null' 或 not null 以外的逻辑条件对值进行颜色编码，请指定规则所适用的值。value 参数接受单个数字，或者在 type 设置为 between 或 not between 时，接受一组两个数字。


value: N | [N, N]

`background_color`

如果您的颜色编码基于逻辑条件（type 设置为除 along a scale... 以外的任何值），请使用 background_color 参数为应用规则的值指定背景颜色。


background_color: "#49cec1"

`font_color`

如果您的颜色编码基于逻辑条件（type 设置为除 along a scale... 以外的任何值），请使用 font_color 参数为应用规则的值指定字体颜色。


font_color: "#1f3e5a"

`color_application`

color_application 参数及其子参数 collection_id、palette_id 和 options 可用于将特定颜色集合和调色板应用于条件格式规则。

如果您有集合 ID 和调色板 ID，则可以通过它们为 LookML 信息中心添加颜色。您还可以使用界面查找所需的颜色，并生成 LookML 以将其添加到信息中心。前往用户定义的内容（例如 Look、信息中心或探索），然后使用界面将所需的颜色应用到相应内容的可视化图表中。完成上述操作后，您可以按照获取信息中心 LookML 的步骤操作，复制生成的 LookML，然后将其粘贴到 color_application 部分。如需简要了解 Looker 的预定义颜色集合，请参阅颜色集合文档页面。

当您将 type 设置为 along a scale... 时，可以使用 options 子形参。它具有以下子形参：

steps：此参数将所用颜色数量限制为指定值，并将数据分为相应数量的组。如果不使用此参数，系统会根据覆盖整个调色板的渐变来为数据着色。它接受 2 到 100 之间的值。
mirror：如果设置为 true，此参数会对调色板两侧应用相同的颜色偏移，以实现定义中心点两侧的等值。它接受 true 或 false。
constraints：此参数用于设置条件格式所应用到的数据范围，并设置用于调色板应用的中心点。它接受以下语法：constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
reverse：此参数用于确定在应用颜色时是否反转调色板。它接受 true 或 false。

`bold`

根据逻辑条件进行颜色编码时，设置是否将应用规则的值加粗。


bold: true | false

`italic`

根据逻辑条件进行颜色编码时，设置是否将应用规则的值设为斜体。


italic: true | false

`strikethrough`

根据逻辑条件进行颜色编码时，请设置是否为规则的值应用删除线格式。


strikethrough: true | false

`fields`

指定规则应应用于哪些字段。默认情况下，该规则适用于所有数值字段。


fields: [ view_name.field_name ]

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

pivots

fill_fields

subtotals

total

row_total

limit

column_limit

filters

filter_expression

listen

query_timezone

analysis_config

forecasting

confidence_interval

field_name

forecast_n

forecast_interval

seasonality

merged_queries

示例：合并公司数据

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

列参数

auto_size_all_columns

column_order

pinned_columns

绘图参数

table_theme

show_row_numbers

hide_totals

hide_row_totals

transpose

hidden_fields

limit_displayed_rows

limit_displayed_rows_values

show_hide

first_last

num_rows

序列形参

truncate_text

show_view_names

size_to_fit

dynamic_fields

table_calculation

measure

dimension

label

based_on

type

description

expression

filter_expression

value_format

value_format_name

calculation_type

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`

`pivots`

`fill_fields`

`subtotals`

`total`

`row_total`

`limit`

`column_limit`

`filters`

`filter_expression`

`listen`

`query_timezone`

`analysis_config`

`forecasting`

`confidence_interval`

`field_name`

`forecast_n`

`forecast_interval`

`seasonality`

`merged_queries`

`auto_size_all_columns`

`column_order`

`pinned_columns`

`table_theme`

`show_row_numbers`

`hide_totals`

`hide_row_totals`

`transpose`

`hidden_fields`

`limit_displayed_rows`

`limit_displayed_rows_values`

`show_hide`

`first_last`

`num_rows`

`truncate_text`

`show_view_names`

`size_to_fit`

`dynamic_fields`

`table_calculation`

`measure`

`dimension`

`label`

`based_on`

`type`

`description`

`expression`

`filter_expression`

`value_format`

`value_format_name`

`calculation_type`

`args`（对于自定义群组）

`args`（针对自定义分箱）

快捷计算的 `args`

`_kind_hint`

`_type_hint`

`is_disabled`

`series_labels`

`series_column_widths`

`series_cell_visualizations`