LookML 資訊主頁的箱形圖表參數

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

如要瞭解如何透過 Looker UI 建立盒鬚圖,請參閱「盒鬚圖選項」說明文件頁面。

應用實例

N 表示必須提供數值。單引號表示說明文字,不應包含在即時程式碼中。


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

參數定義

參數名稱 說明
基本參數
name (適用於元素) 建立元素
title (適用於元素) 變更元素名稱向使用者顯示的方式
type (適用於元素) 決定要在元素中使用的圖表類型
height (適用於元素) 定義 layout: tilelayout: static 資訊主頁中元素的高度,單位為 tile_size
width (適用於元素) 定義 layout: tilelayout: static 資訊主頁中元素的寬度,單位為 tile_size
top 定義 layout: static 資訊主頁中,元素從上到下的位置 (以 tile_size 為單位)
left 定義 layout: static 資訊主頁中元素的左右位置,單位為 tile_size
row 定義 layout: newspaper 資訊主頁中元素的上下位置 (以列為單位)
col 定義 layout: newspaper 資訊主頁中元素的左右位置 (以欄為單位)
refresh (適用於元素) 設定元素自動重新整理的間隔時間
note 啟動某一個 LookML 區塊,定義元素的附註。這個參數有子參數 textstatedisplay
查詢參數
model 定義要用於元素查詢的模型
explore (適用於元素) 定義要用於元素查詢的探索
fields 定義要用於元素查詢的欄位。這項功能可取代 dimensionsmeasures
dimensions 定義要用於元素查詢的維度
measures 定義要用於元素查詢的指標
sorts 定義元素查詢要使用的排序方式
limit 定義元素查詢要使用的資料列限制
filters (適用於元素) 定義元素查詢無法變更的篩選器
listen 定義可變更的元素查詢篩選器 (如果已建立 filters (適用於資訊主頁))
query_timezone 定義查詢執行時應使用的時區
hidden_fields 指定要在查詢中使用,但要在圖表中隱藏的任何欄位
影集參數
color_application 將顏色集合和調色盤套用至圖表
樣式參數
show_view_names 顯示或隱藏圖表標籤中的檢視名稱
X 軸參數
show_x_axis_label 顯示或隱藏 x 軸標籤
x_axis_label 定義自訂 X 軸標籤
show_x_axis_ticks 顯示 X 軸上的值
x_axis_gridlines 從 X 軸延伸格線
x_axis_reversed 反轉 X 軸方向
x_axis_zoom 指定是否允許沿著 x 軸縮放
Y 軸參數
show_y_axis_labels 顯示或隱藏 Y 軸標籤
y_axis_labels 定義自訂 Y 軸標籤
show_y_axis_ticks 顯示 Y 軸上的值
y_axis_gridlines 從 Y 軸延伸格線
y_axis_min 定義 Y 軸的最小值
y_axis_max 定義 Y 軸的最大值
y_axis_tick_density 啟用使用 y_axis_tick_density_custom 參數設定自訂 Y 軸刻度密度的選項
y_axis_tick_density_custom y_axis_tick_density 設為 custom 時,定義 y 軸刻度的密度
y_axis_reversed 反轉 Y 軸方向
y_axis_value_format 定義 Y 軸值的數字格式
y_axis_zoom 指定是否允許沿著 Y 軸縮放。如果 x_axis_zoom: false,則會停用。
進階視覺化設定參數
advanced_viz_config 接受可覆寫多項視覺化設定的 HighCharts JSON 片段

基本參數

定義 LookML 資訊主頁元素時,您必須至少為基本參數 nametype 指定值。其他基本參數 (例如 titleheightwidth) 會影響資訊主頁上元素的顯示方式和位置。

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 也可做為資訊主頁列的一部分,詳情請參閱「資訊主頁參數」說明文件頁面。

適用於 tilestatic 版面配置的資訊主頁

height 參數會以 tile_size 為單位 (以像素為單位定義),定義 layout: tilelayout: static 資訊主頁的元素高度。

舉例來說,下列程式碼會指定 tile_size: 100height: 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: tilelayout: static 資訊主頁中元素的寬度。

舉例來說,下列程式碼會指定 tile_size: 100width: 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: 100top: 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: 100left: 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 具有子參數 textstatedisplay

text

text 子參數會指定附註中顯示的文字。文字可以本地化

state

如果附註過大,無法在元素寬度內的單列顯示,state 子參數會決定附註是否要collapsedexpanded。如果選擇 collapsed,且附註過長,附註結尾會顯示可點選的刪節號 (...),點選後即可閱讀完整附註。

display

display 子參數會決定附註在元素上的顯示位置。above 會將附註放在元素頂端,below 則會放在元素底部,而 hover 則會要求使用者將滑鼠游標懸停在元素上,才能看到附註。

查詢參數

定義 LookML 資訊主頁元素時,您至少必須為 modelexplore 查詢參數指定值。

type: looker_boxplot 的元素也需要至少一個維度,以及下列其中兩種、三種或五種度量 (必須依下列順序列出):

  • 最小值:代表最小資料值的指標。這可以在 LookML 中定義為 type: min 的測量指標。
  • 第 25 個百分位數:代表第 25 個百分位數或第 1 個四分位數的指標。四分之一的資料值小於或等於這個值。您可以在 LookML 中將此定義為 type: percentile 的測量指標,並將 percentile 的值設為 25
  • 中位數:代表資料集的中位數或中點,也就是第二個四分位數。一半的資料值小於或等於這個值。這可以在 LookML 中定義為 type: median 的測量指標。
  • 第 75 個百分位數:代表第 75 個百分位數或第三四分位數的指標。四分之三的資料值小於或等於這個值。您可以在 LookML 中將此定義為 type: percentile 的測量指標,並將 percentile 的值設為 75
  • 最大值:代表最大值的指標。這可以在 LookML 中定義為 type: max 的測量指標。

您可以使用 fields 參數,或同時使用 dimensionsmeasures 參數,指定箱型圖元素所依據的維度和指標。如要進一步瞭解如何在 Looker UI 中建立盒鬚圖,請參閱「盒鬚圖選項」說明頁面的「建立盒鬚圖」一節。

您可以使用本節所述的其他查詢參數,控管資料在資訊主頁元素中的顯示方式。

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 參數說明文件頁面。

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 參數,就不需要使用 dimensionsmeasures 參數。

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]

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

hidden_fields

hidden_fields 參數會指出查詢中使用的欄位 (如有),但這些欄位會隱藏在圖表中。隱藏的欄位會顯示在「探索」的資料表部分。

hidden_fields: [inventory_items.count, distribution_centers.id]

影集參數

color_application

color_application 參數及其子參數 collection_idpalette_id 可用於將特定顏色集合和調色盤套用至資訊主頁元素。如要瞭解 Looker 的原生顏色集合,請參閱「顏色集合」說明文件頁面。

如果您有要使用的調色盤的集合 ID 和調色盤 ID,可以將這些 ID 輸入 collection_idpalette_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

您也可以使用 UI 尋找所需顏色、集合或調色盤,並產生 LookML 將這些項目新增至資訊主頁。前往使用者定義的內容 (例如 Look、資訊主頁或探索),然後使用 UI 將所需顏色、集合或調色盤套用至該內容的視覺化項目。完成上述步驟後,請按照這些步驟取得資訊主頁 LookML,複製產生的 LookML,然後貼到 color_application 區段。

根據預設,系統會將指定調色盤的第一個顏色套用至整個盒鬚圖元素。選用的子參數 reverse 會將應用程式切換為調色盤中的最後一種顏色。

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

樣式參數

show_view_names

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

show_view_names: true | false

## default value: true

X 軸參數

show_x_axis_label

這項參數可決定是否顯示 X 軸標籤。

show_x_axis_label: true | false

## default value: true

x_axis_label

這個參數會指定 x 軸的標籤。當 show_x_axis_label 設為 true 時,可以使用這項參數。

x_axis_label: Order Date

show_x_axis_ticks

這個參數會決定 X 軸上是否顯示值標籤。

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

這個參數可決定格線是否從 x 軸延伸。

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

這個參數會設定 x 軸的方向。當 x_axis_reversed 設為 false 時,值會從左到右遞增。設為 true 時,值會從左到右遞減。


x_axis_reversed: true | false

x_axis_zoom

這個參數會指定使用者是否可以放大視覺化效果的 x 軸。當 x_axis_zoom 設為 true 時,即可縮放畫面。如果 x_axis_zoom 設為 false,就無法縮放。

如果 x_axis_zoom 設為 falsey_axis_zoom 會停用。

x_axis_zoom: true | false

# default value: true

Y 軸參數

show_y_axis_labels

這項參數會決定是否要在 Y 軸上顯示標籤。

show_y_axis_labels: true | false

## default value: true

y_axis_labels

這個參數會指定 y 軸的標籤。當 show_y_axis_labels 設為 true 時,可以使用這項參數。

y_axis_labels: ['label']

show_y_axis_ticks

這個參數會決定是否在 Y 軸上顯示值。

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

這項參數可決定格線是否從 Y 軸延伸。

y_axis_gridlines: true | false

## default value: true

y_axis_min

這個參數會定義 Y 軸的最小值。

y_axis_min: ['10']

## default value: true

y_axis_max

這個參數會定義 y 軸的最大值。

y_axis_max: ['100']

## default value: true

y_axis_tick_density

這個參數可啟用設定 Y 軸刻度密度的選項。將 y_axis_tick_density 設為 custom 即可啟用這項功能,然後使用 y_axis_tick_density_custom 參數設定密度。

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

如果 y_axis_tick_density 設為 custom,您可以使用這個參數設定 y 軸刻度密度。這個屬性接受整數,代表要顯示的刻度數。

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

這個參數會設定 y 軸的方向。如果 y_axis_reversed 設為 false,值會沿著軸向上遞增。如果設為 true,值會沿著軸向下遞減。


## y_axis_reversed: true | false

# default value: false

y_axis_value_format

這個參數會指定 Y 軸值的數字格式,與基礎維度或指標無關。這個參數接受 Excel 樣式的格式。如未指定格式,系統會以基礎維度或指標的格式顯示值。

y_axis_value_format 參數指定的值必須以雙引號括住:


y_axis_value_format: "*00#.00"

如需指定這些格式的完整指南,請參閱 Excel 說明文件。不過,Looker 目前不支援日期和顏色格式設定。

以下列舉一些最常見的格式設定選項:

值的格式 意義
# 整數 (123)
*00# 整數,並以零填補至 3 位數 (001)
0.## 最多到小數點後 2 位 (1. 或 1.2 或 1.23)
0.00 到小數點後 2 位 (1.23)
*00#.00 數字補零至 3 位數,且小數點後正好有 2 位數 (01.23)
#,### 千位數之間以半形逗號分隔的數字 (1,234)
#,##0.00 千位數之間以半形逗號分隔,並保留小數點後 2 位 (1,234.00)
0.000,," M" 以百萬為單位,並顯示到小數點後 3 位 (1.234 M)。系統會自動除以 100 萬。
$# 美元 (小數點後 0 位) ($123)
$0.00 美元 (到小數點後 2 位,$123.00)
$#,##0.00 美元,千位數之間以半形逗號分隔,並保留 2 位小數 ($1,234.00)
#% 百分比,小數點後 0 位 (1%)。系統會自動將值乘以 100。
0.00% 百分比,小數點後 2 位 (1.00%)。系統會自動將值乘以 100。
0.00\% 百分比,小數點後 2 位 (1.00%)。系統不會自動將值乘以 100。

y_axis_zoom

這個參數會指定使用者是否可以放大視覺化圖表的 Y 軸。y_axis_zoom 設為 true 時,即可縮放畫面。

如果將 y_axis_zoom 設為 false,使用者就無法縮放 Y 軸的較小部分。不過,如果 x_axis_zoom 參數設為 true,使用者可能仍可縮放 X 軸的較小部分。

如果 x_axis_zoom 設為 false,系統會停用 y_axis_zoom

y_axis_zoom: true | false

# default value: true

進階視覺化設定

本節所述的參數對應於選用的圖表設定覆寫,您可以點選視覺化編輯器的「繪製」部分中的「編輯圖表設定」按鈕,將這些參數套用至圖表。

advanced_vis_config

這項參數接受 HighCharts JSON 片段,可覆寫多項視覺化設定,並開啟新功能。如需使用 HighCharts JSON 達成常見用途的範例,請參閱「使用圖表設定編輯器自訂視覺化效果」說明文件頁面。


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null