LookML 資訊主頁的表格 (舊版) 圖表參數

本頁說明如何使用 dashboard.lkml 檔案中的 LookML 資訊主頁參數，新增及自訂 type: table 的 LookML 資訊主頁元素。

如要瞭解如何透過 Looker 使用者介面建立表格 (舊版) 圖表，請參閱「表格 (舊版) 圖表選項」說明文件頁面。

應用實例

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_table
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
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, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_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

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: 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_column_names: true | false
show_view_names: true | false
series_labels:
  view_name.field_name: desired series label

## FORMATTING PARAMETERS
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 (適用於元素)	定義 tile_size 單位中 layout: tile 和 layout: static 資訊主頁的元素高度
width (適用於元素)	以 tile_size 為單位，定義 layout: tile 和 layout: static 資訊主頁中元素的寬度
top	定義 layout: static 資訊主頁中，元素從上到下的位置 (以 tile_size 為單位)
left	定義 layout: static 資訊主頁中元素從左到右的位置，單位為 tile_size
row	定義 layout: newspaper 資訊主頁中元素的上下位置 (以列為單位)
col	定義 layout: newspaper 資訊主頁中元素的左右位置 (以欄為單位)
refresh (適用於元素)	設定元素自動重新整理的間隔時間
note	啟動某一個 LookML 區塊，定義元素的附註。這個參數有子參數 text、state 和 display。
查詢參數
model	定義要用於元素查詢的模型
explore (適用於元素)	定義要用於元素查詢的探索
dimensions	定義要用於元素查詢的維度
measures	定義要用於元素查詢的指標
sorts	定義元素查詢要使用的排序方式
pivots	定義應樞紐分析的維度，用於元素的查詢
limit	定義元素查詢要使用的資料列限制
filters (適用於元素)	定義元素查詢無法變更的篩選器
listen	定義可變更的元素查詢篩選器 (如果已建立 filters (適用於資訊主頁))
query_timezone	定義查詢執行時應使用的時區
merged_queries	定義「合併結果」查詢
繪圖參數
table_theme	將五種表格顏色選項套用至表格視覺化
total	指定是否顯示表格視覺化的欄總計
row_total	指定是否顯示表格視覺化的列總計
show_row_numbers	設定是否要在每個表格列的開頭顯示列號
hide_totals	設定表格視覺化是否顯示欄總計
hide_row_totals	設定表格視覺化是否顯示列總計
hidden_fields	指定要在查詢中使用，但要在圖表中隱藏的任何欄位
limit_displayed_rows	根據結果中的位置顯示或隱藏資料列
limit_displayed_rows_values	指定要在視覺化中顯示或隱藏哪些列。這個參數包含子參數 show_hide、first_last 和 num_rows。
系列參數
truncate_column_names	以省略號 (...) 縮短欄標題
show_view_names	顯示檢視名稱，以及每個欄標題的欄位名稱
series_labels	為每個資料欄指定自訂標籤
格式化參數
enable_conditional_formatting	設定 true，為表格視覺化定義顏色編碼規則
conditional_formatting_include_totals	指定色彩編碼配置是否包含總計
conditional_formatting_include_nulls	指定是否應將空值表示為零
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 版面配置的資訊主頁

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 參數會以 tile_size 為單位，定義 layout: tile 和 layout: static 資訊主頁中元素的寬度。

舉例來說，下列程式碼會指定 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 參數會以 tile_size 為單位，定義 layout: static 資訊主頁中元素的左右位置。

舉例來說，下列程式碼會指定 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 則會要求使用者將滑鼠游標懸停在元素上，才能看到附註。

查詢參數

定義 LookML 資訊主頁元素時，您必須至少為 model 和 explore 查詢參數指定值，並使用 dimensions 參數或 measures 參數指定至少一個欄位。您也可以使用本節所述的其他查詢參數，控制資料在資訊主頁元素中的顯示方式。

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 的值。使用常數可在一個位置定義 Explore 的名稱，如果您要更新多個資訊主頁元素使用的 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 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 語法，在篩選器應套用的欄位中加入半形冒號和參照。舉例來說，您可以建立名為「日期」的篩選器，要求使用者在 UI 的篩選器欄位中輸入日期。接著，您可以將使用者輸入的值套用至 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

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 欄位中的查詢，建立可傳回公司名稱、公司聯絡電子郵件、首次公開募股年份、股票代號、員工數和職位數的查詢。您可以在 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 的資訊主頁篩選器，您是使用 filters 參數為 LookML 資訊主頁定義該篩選器：

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 資訊主頁篩選器互動時，合併查詢元素中對應的來源查詢就會相應地遭到篩選。

提示： 每個來源查詢都可以監聽一或多個資訊主頁篩選器。這樣一來，無論合併結果元素中有多少來源查詢，您都能為每個來源查詢獨立定義篩選邏輯。如果查詢沒有 listen 參數，就不會受到任何資訊主頁篩選器影響。

繪圖參數

下列參數對應於表格 (舊版) 圖表的視覺化編輯器「繪製」專區中的選項。

table_theme

使用 table_theme 參數，為表格元素套用下列其中一種表格著色選項：

• editable：資料表包含藍色維度、橘色測量指標和綠色資料表計算。
• white：表格標題為白色，資料列則以白色和灰色交替顯示，文字為黑色。
• gray：表格標題為灰色，資料列則交替顯示白色和淺灰色，文字為深灰色。
• transparent：表格標題完全透明，資料列則在完全透明和半透明灰色之間交替，文字顏色會根據顯示的背景顏色，視需要從黑色調整為白色。如果您使用自訂的內嵌資訊主頁，將 table_theme 設為 transparent 很有用，這樣圖塊背景顏色就會顯示在視覺化圖表上。
• unstyled：表格標題和資料列為白色，文字為黑色。

table_theme: editable | white | gray | transparent | unstyled

total

total 參數會設定表格底部是否顯示總計列。詳情請參閱「顯示總計」。

total: true | false

## default value: false

row_total

row_total 參數會設定總計欄顯示在表格的右側或左側。只有在有樞紐時才有效。詳情請參閱「顯示總計」。

row_total: right | left | false

## default value: false

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

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_column_names

truncate_column_names 參數會設定是否要以省略號 (...) 縮短欄標題。

truncate_column_names: true | false

show_view_names

show_view_names 參數會決定是否要在圖表標籤中顯示檢視區塊名稱，例如座標軸名稱和資料欄名稱。

show_view_names: true | false

## default value: true

series_labels

使用 name: label 配對，根據序列名稱設定一或多個序列的標籤。

如果是透視圖表，數列名稱就是透視名稱。

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

如果是含有多項指標的圖表，數列名稱就是指標欄位名稱。

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

設定參數格式

下列參數對應於表格 (舊版) 圖表的視覺化編輯器中「格式」部分的選項。

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 會指定空值是否應以零表示。

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'：規則僅適用於空值。
• not 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、資訊主頁或 Explore)，然後使用 UI 將所需顏色套用至該內容的資料圖表。完成上述步驟後，請按照這些步驟取得資訊主頁 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 ]