LookML ダッシュボードの表グラフ パラメータ

このページでは、dashboard.lkml ファイルに LookML ダッシュボード パラメータを使用して、type: looker_grid の LookML ダッシュボード要素を追加してカスタマイズする方法について説明します。

Looker UI でテーブルグラフを作成する方法については、テーブルグラフ オプションのドキュメントをご覧ください。

注: Looker 管理者が Accessible Data Tables Visualization という Labs 機能を有効にしている場合、行番号列は表グラフの左側に固定されません。また、表のセルをダブルクリックして、テキストを手動で選択することもできません。

使用例

## 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	layout: static ダッシュボードで、要素の上から下への位置を tile_size の単位で定義します。
left	layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します
row	layout: newspaper ダッシュボードの要素の上から下の位置を、行単位で定義します。
col	layout: newspaper ダッシュボードの要素の左から右への位置を列単位で定義します
refresh（要素の場合）	要素が自動的に更新される間隔を設定します
note_state	大きすぎて要素の幅内に収まらない場合にメモを折りたたむか展開するかを定義します
note_display	要素上のメモを表示する場所を定義します
note_text	メモに表示するテキストを指定します
クエリ パラメータ
model	要素のクエリに使用するモデルを定義します。
explore（要素の場合）	要素のクエリに使用する 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 クエリの実行時に実行される予測分析を定義します。 予測 Labs 機能を有効にする必要があります。
merged_queries	マージされた結果クエリを定義
列パラメータ
auto_size_all_columns	表の列幅を、列見出しの幅またはデータ長の大きい方の幅（いずれか大きい方）に自動調整します
column_order	表グラフの列を並べ替えます
pinned_columns	表グラフの左側に固定または固定する列を定義します
プロット パラメータ
table_theme	5 つの表の色オプションのいずれかを表ビジュアリゼーションに適用します
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 レイアウトのダッシュボードの場合

height パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の高さを tile_size（ピクセル単位で定義）単位で定義します。

たとえば、次のコードでは tile_size: 100 と height: 4 を指定して、orders_by_date 要素の高さを 400 ピクセルにしています。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

newspaper レイアウトのダッシュボードの場合

height パラメータは、layout: newspaper ダッシュボードの要素の高さを行単位で定義します。

新聞レイアウトのダッシュボードのデフォルトは、6 行（およそ 300 ピクセル）の要素の高さです。preferred viewer パラメータが dashboards-next に設定されたダッシュボードの最小高さは 1 行です。ダッシュボードの高さの最小値は 2 行で、preferred viewer パラメータを dashboards に設定します。

たとえば、次のコードは、要素の高さを 12 行、またはデフォルトに設定されている他の要素の高さの 2 倍に設定します。

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

このセクションでは、ダッシュボード要素の一部である width パラメータについて説明します。

width はダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。

width パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の幅を tile_size の単位で定義します。

たとえば、次のコードは tile_size: 100 と width: 4 を指定して、orders_by_date 要素の幅を 400 ピクセルにしています。

- dashboard: sales_overview
  tile_size: 100
  ...

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

width パラメータは、layout: newspaper ダッシュボードの要素の幅を列単位で定義します。

新聞レイアウトのダッシュボードのデフォルト幅は 24 列です。

次のコードは、要素をダッシュボードの幅の半分に設定します。

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

top パラメータは、layout: static ダッシュボードの要素の上から下の位置を tile_size の単位で定義します。

たとえば、次のコードでは、tile_size: 100 と top: 4 を指定して、orders_by_date 要素の上端をダッシュボードの上から 400 ピクセルの位置に配置しています。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

left パラメータは、layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します。

たとえば、次のコードは tile_size: 100 と left: 4 を指定し、orders_by_date 要素の左端をダッシュボードの左端から 400 ピクセルの位置に配置します。

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

layout: newspaper ダッシュボードの場合、row パラメータは、要素の上端を配置する行を定義します。

ダッシュボードの先頭は行 0 です。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になっています。つまり、ダッシュボードの上部にあるダッシュボード要素（row: 0）では、デフォルトで 0 ～ 5 の行が使用されます。

各行の高さは 50 ピクセルです。つまり、デフォルトの要素の高さは 6 で、300 ピクセルです。

たとえば次のコードは、要素がデフォルトの高さに設定されていると仮定して、要素を要素の 2 行目に設定します。

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

layout: newspaper ダッシュボードの場合、col パラメータは、要素の左端を配置する列を定義します。

ダッシュボードは 24 列に分かれています。ダッシュボードの左側 0 から始まるダッシュボード。新聞レイアウトのダッシュボードの要素幅は、デフォルトで 8 列になります。つまり、ダッシュボードの左側にある col: 0 要素では列 0 ～ 7 がデフォルトで表示されます。

たとえば、次のコードでは、ダッシュボードの要素の 3 列目に設定する要素を設定します。

- 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 パラメータでは、要素の幅内にある 1 行に収まらないほど大きいメモを折りたたんだり展開したりするかどうかを定義します。collapsed を選択してメモが長すぎる場合は、メモの最後に表示される省略記号（...）が表示されます。これを使用してメモの全文を読むことができます。expanded を選択してメモが長い場合、メモは追加の行に表示されます。

note_display

note_display パラメータは、要素にメモを表示する場所を定義します。above は、メモを要素の上部に配置し、below は、要素の下部にメモを配置します。hover では、ユーザーがメモを表示するには、? アイコンにカーソルを合わせる必要があります。

note_text

note_text パラメータは、要素メモに表示されるテキストを指定します。

クエリ パラメータ

LookML ダッシュボード要素を定義する場合は、少なくとも model および explore クエリ パラメータの値を指定し、dimensions パラメータ、measures パラメータ、または fields パラメータを使用して少なくとも 1 つのフィールドを指定する必要があります。以下で説明するその他のクエリ パラメータを使用して、ダッシュボード要素でのデータの表示方法を制御することもできます。

model

model パラメータは、要素クエリに使用するモデルを定義します。指定しない場合は、デフォルトでダッシュボードが存在するモデルになります。

- name: orders_by_date
  model: ecommerce

model パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を model の値として設定できます。定数を使用すると、1 つのモデル名を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されるモデルの名前を更新する場合に特に便利です。

LookML ダッシュボードで定数の詳細と使用例については、constant パラメータのドキュメント ページをご覧ください。

explore

このセクションでは、ダッシュボード要素の一部である explore パラメータについて説明します。

explore は、モデルの一部として使用することもできます。詳しくは、explore パラメータのドキュメントをご覧ください。

explore はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。

explore パラメータは、要素クエリに使用する Explore を定義します。

- name: orders_by_date
  explore: order

explore パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を explore の値として設定できます。定数を使用すると、1 つの場所で 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 パラメータを使用する場合、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 パラメータは、要素クエリに使用する並べ替えを定義します。1 番目、2 番目、3 と順に表示されます。構文 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

ダッシュボードには、ユーザーがダッシュボード要素の背後にあるデータを変更できるフィルタを含めることができます。これらは、ダッシュボードの 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

たとえば、[日付] というフィルタを作成し、ユーザーが UI のフィルタ フィールドに日付を入力する必要があるとします。その後、ユーザーが入力した値を次のように orders_by_date 要素に適用できます。

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

このコンセプトの詳細については、LookML ダッシュボードの構築のドキュメントをご覧ください。

query_timezone

query_timezone パラメータでは、クエリを実行するタイムゾーンを指定します。タイムゾーン オプションは、timezone の値のドキュメント ページに表示されます。閲覧者のタイムゾーンを使用してクエリを実行する場合は、値を user_timezone として割り当てます。

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

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 は、ビジュアリゼーションに予測を適用する分析タイプです。予測機能を使用すると、アナリストは新規または既存の Explore クエリにデータ予測をすばやく追加し、ユーザーが特定のデータポイントを予測してモニタリングすることが容易になります。

詳細については、可視化における予測のドキュメントをご覧ください。

ビジュアリゼーションに予測を追加するには、予測ラボ機能を有効にする必要があります。

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 は、Explore クエリの期間のディメンションに基づいて自動的に入力されます。

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 サブパラメータを使用してマージルールを定義します。

merged_queries の構文は次のとおりです。

  merged_queries:
  - 'primary query definition'
  - 'next source query definition'
    join_fields:
    - field_name: 'field from the source query using the view_name.field_name syntax'
      source_field_name: 'joined field from the primary query using the
        view_name.field_name syntax'
    # more join_fields definitions as needed
  - 'next source query definition'
    join_fields:
    - field_name: view_name.field_name
      source_field_name: view_name.field_name
    # more join_fields definitions as needed
  # additional source queries and join_fields definitions as needed

merged_results で定義された最初のクエリがプライマリ クエリであり、他のクエリはそのクエリと統合されます。

たとえば、銘柄コード、会社名、Twitter ユーザー名で結合すると、2 つのクエリを統合して、会社名、会社の Twitter ユーザー名、IPO の年、銘柄コード、従業員数、求人数の結果を返すことができます。

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
    filters:
      company.twitter_username: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: crunchbase
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.twitter_username: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: company.name
    - field_name: companies.twitter_username
      source_field_name: company.twitter_username

データの結果は次のようになります。

次に、要素パラメータを適用して、お好みでビジュアリゼーションのスタイルを設定できます。

列パラメータ

以下のパラメータは、表グラフの列を移動して固定することに対応しています。

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

プロット パラメータ

次のパラメータは、表グラフ用のビジュアリゼーション エディタの [Plot] メニューのオプションに対応しています。

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

Explore に列の合計が含まれている場合、hide_totals はビジュアリゼーションに合計を表示するかどうかを指定します。

hide_totals: true | false

hide_row_totals

Explore に行の合計が含まれている場合、hide_row_totals はビジュアリゼーションに行の合計を表示するかどうかを設定します。

hide_row_totals: true | false

transpose

transpose パラメータを使用すると、テーブルの行を列に転置できます。true または false を使用できます。

- name: orders_by_date
  transpose: true

hidden_fields

hidden_fields パラメータは、クエリで使用されているがグラフには表示されていないフィールドを指定します（存在する場合）。非表示になっているフィールドは、Explore のデータテーブル セクションに表示されます。

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 行を表示または非表示にします。

時系列パラメータ

次のパラメータは、表グラフ用のビジュアリゼーション エディタの [シリーズ] メニューのオプションに対応しています。

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 文字の説明を追加できます。Looker では、ユーザーがフィールド ピッカーでフィールド名の右側にある情報アイコンをクリックし、Explore、ダッシュボード、Look で表や表グラフを可視化したときに列名にカーソルを合わせると、説明が表示されます。

expression

表計算を使用している場合、表計算の作成に使用される Looker 式が expression サブパラメータで定義されます。

filter_expression

カスタム フィルタされたメジャーを使用している場合、メジャーのフィルタに使用する Looker 式が filter_expression サブパラメータで定義されます。

value_format

カスタム形式を使用する場合、オプションの value_format サブパラメータで動的フィールドの値の形式を定義します。デフォルトの Looker 形式を使用する場合は、value_format_name を使用します。

value_format_name

オプションの value_format_name サブパラメータは動的フィールドにデフォルトの形式を適用します。カスタム形式を使用する場合は、value_format を使用します。

calculation_type

calculation_type サブパラメータでは、表計算を作成したり、ディメンションのカスタム グループを作成したりするための Shortcut Calculation 関数または Group 関数のタイプを定義します。

カスタム フィールド 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 - 列内のすべての値のうち、1 行の値のランク。クエリ行数制限に達している場合は、この計算にデータテーブルの値のみが含まれます。
• 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 サブパラメータでは、ビジュアリゼーションとその基になる Explore に表計算を表示するかどうかを指定します。指定できる値は true と false です。

series_labels

name: label ペアを使用して、シリーズ名に基づいて 1 つ以上のシリーズのラベルを設定します。

ピボット グラフの場合、シリーズ名はピボット名です。

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

複数のメジャーを含むグラフの場合、シリーズ名はメジャーのフィールド名です。

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

series_column_widths

系列名に基づいて 1 つ以上の列の幅を設定します。auto_size_all_columns パラメータが true に設定されている場合、series_column_widths はオーバーライドされます。

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

series_cell_visualizations

1 つ以上の列で 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 には、バーに使用する 2 ～ 5 個のカスタム色を設定する代替の子パラメータ custom_colors があります。

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 サブパラメータは、セルテキストのフォントの色を示します。color 値は、#2ca6cd などの 16 進文字列や、mediumblue などの CSS 名前付き色文字列を取ることができます。

bg_color

bg_color サブパラメータは、セルの背景色を示します。color 値は、#2ca6cd などの 16 進文字列や、mediumblue などの CSS 名前付き色文字列を取ることができます。

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 がある場合は、collection_id と palette_id のサブパラメータにその ID を入力します。コレクション ID またはパレット ID は、英数字のコードの場合もあれば、カラー コレクションの名前に基づく場合もあります。英数字のコードは Looker のネイティブ コレクションに使用されます。これらはインスタンス固有で、次のようになります。

color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

カスタム カラー コレクションは、カラー コレクションの名前に基づくコレクション ID とパレット ID を使用します。この ID はインスタンス間で移植可能で、次のようになります。

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

また、UI を使って必要な色、コレクション、パレットを見つけて、LookML を生成してダッシュボードに追加することもできます。ユーザー定義コンテンツ（Look、ダッシュボード、Explore など）に移動し、UI を使用してコンテンツのビジュアリゼーションに適用する色、コレクション、パレットを適用します。完了したら、ダッシュボード LookML を取得する手順に従って、生成された LookML をコピーし、color_application セクションに貼り付けます。

header_font_color

header_font_color パラメータは、列見出しにフォントの色を適用します。

color 値は、#2ca6cd などの 16 進文字列や、mediumblue などの CSS 名前付き色文字列を取ることができます。

header_font_color: purple

デフォルトの色は、table_theme パラメータを使用して定義されたテーブルのテーマによって異なります。

header_background_color

header_background_color パラメータは、背景の列ヘッダーに色を適用します。

color 値は、#2ca6cd などの 16 進文字列や、mediumblue などの CSS 名前付き色文字列を取ることができます。

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 に指定した 2 つの数値の間の値に適用されます。
• not between: ルールは、value に指定された 2 つの数値以外の値に適用されます。
• '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 に設定されている場合は 2 つの数のセットを使用します。

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 ダッシュボードに色を追加できます。UI を使って好みの色を見つけ、LookML を生成してダッシュボードに追加することもできます。ユーザー定義コンテンツ（Look、ダッシュボード、Explore など）に移動し、UI を使用してコンテンツのビジュアリゼーションに色を適用します。完了したら、ダッシュボード LookML を取得する手順に従って、生成された LookML をコピーし、color_application セクションに貼り付けます。Looker の事前定義されたカラー コレクションの概要については、カラー コレクションのドキュメントをご覧ください。

options サブパラメータは、type を along a scale... に設定した場合に使用できます。次の子パラメータがあります。

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