LookML ダッシュボードのテーブル チャート パラメータ

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

Looker UI を使用して表グラフを作成する方法については、表グラフのオプションのドキュメント ページをご覧ください。

使用例


## 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 要素の幅内で 1 行に収まらない場合に、メモを折りたたむか展開するかを定義します
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'

この形式を使用した場合、要素は [Sales Overview] ではなく [1) Sales Overview] と表示されます。

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 ダッシュボードの要素の高さを row 単位で定義します。

新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行（約 300 ピクセル）になります。preferred viewer パラメータが dashboards-next に設定されているダッシュボードの最小の高さは 1 行です。最小の高さは、preferred viewer パラメータが dashboards に設定されているダッシュボードの場合、2 行です。

たとえば、次のコードでは、要素を 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 か所で定義できます。これは、複数のダッシュボード要素で使用されているモデルの名前を更新する場合に特に便利です。

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

explore

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

explore は、explore パラメータのドキュメント ページで説明されているように、モデルの一部としても使用できます。

explore は、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。

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

- name: orders_by_date
  explore: order

explore パラメータは LookML 定数を受け取ります。プロジェクトのマニフェスト ファイルで定数を定義し、構文 "@{constant_name}" を使用して、定数を explore の値として設定できます。定数を使用すると、Explore の名前を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されている 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 パラメータは、要素クエリに使用する並べ替えを定義します。最初の並べ替えが最初に表示され、次に 2 番目の並べ替えが表示されます。ディメンションまたは指標を指定するには、構文 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 構文を使用して、フィルタの名前、コロン、フィルタを適用するフィールドへの参照を指定します。たとえば、ユーザーが 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

analysis_config

analysis_config パラメータとそのサブパラメータは、Looker 21.14 以降で可視化に使用するクエリ分析を記述します。ビジュアリゼーションで分析を行うには、予測 Labs 機能を有効にする必要があります。

次のサブパラメータを使用して分析を定義できます。

次のような構文を使用して予測を作成できます。


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

forecasting

forecasting は、予測を可視化に適用する分析タイプです。予測を使用すれば、アナリストは新規または既存の Explore のクエリにデータ予測を迅速に追加して、ユーザーが特定のデータポイントを予測してモニタリングできるようにします。

詳細については、ビジュアリゼーションでの予測のドキュメント ページをご覧ください。

予測を可視化に追加するには、予測 Labs 機能を有効にする必要があります。

confidence_interval

confidence_interval は、予測されたデータ値の範囲を設定します。この範囲は、パーセンテージの 10 進数式として入力されます。confidence_interval は省略可能で、デフォルトでは空白になっています。


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

ビジュアリゼーションでの予測のドキュメント ページの予測区間セクションをご覧ください。

予測を可視化に追加するには、予測 Labs 機能を有効にする必要があります。

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

ビジュアリゼーションでの予測のドキュメント ページの期間セクションをご覧ください。

予測を可視化に追加するには、予測 Labs 機能を有効にする必要があります。

forecast_interval

forecast_interval は、データ値を予測する期間を設定します。forecast_interval は、データ探索クエリの期間ディメンションに基づいて自動的に入力されます。


forecast_interval: day | month # a timeframe with dimension fill

長さのドキュメント ページをご覧ください。

予測を可視化に追加するには、予測 Labs 機能を有効にする必要があります。

seasonality

seasonality を使用すると、アナリストは予測において既知のサイクルや反復的なデータトレンドを考慮できます。seasonality は省略可能で、デフォルトでは空白になっています。


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

自動の季節性設定は、空白の seasonality 値として表されます。

ビジュアリゼーションでの予測のドキュメント ページの季節性セクションをご覧ください。

予測を可視化に追加するには、予測 Labs 機能を有効にする必要があります。

merged_queries

merged_queries パラメータを使用すると、複数のクエリの結果を 1 つのダッシュボード要素に結合できます。要素の merged_queries パラメータ内で各ソースクエリを定義し、join_fields サブパラメータを使用して結果をどのようにマージするかを指定します。

次のサンプル LookML コードは、結合された結果の type: looker_grid 要素を作成します。この例では、merged_queries パラメータを使用して、2 つの別々のクエリのデータを 1 つのテーブルグラフに結合するダッシュボード要素を作成します。

- 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 Explore に基づく 2 つのソースクエリのデータを結合します。プライマリ クエリには users.state、users.count、users.city の各フィールドが含まれており、結果は users.count フィールドで並べ替えられます。2 つ目のソースクエリには users.state フィールドと users.city フィールドが含まれており、結果は users.state フィールドで並べ替えられます。

join_field パラメータは、users.state フィールドと users.city フィールドの一致する値に基づいて、ソースクエリを統合します。

listen パラメータは両方のクエリに State フィルタを適用します。これにより、ダッシュボードの閲覧者は特定の州を選択して、ダッシュボード タイルに表示されるクエリ結果を絞り込むことができます。

例: 会社データの統合

2 つの異なる Explore（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 パラメータを使用することで、統合されたクエリ要素にダッシュボード フィルタを適用することもできます。たとえば、LookML ダッシュボードの filters パラメータを使用してダッシュボード レベルで定義した Industry という名前のダッシュボード フィルタがあるとします。

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

両方のソースクエリの companies.industry フィールドに 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

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 行をビジュアリゼーションで表示または非表示にします。

系列パラメータ

次のパラメータは、テーブル グラフの可視化エディタの [Series] メニューのオプションに対応しています。

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 を使用したりするには、表計算を作成する権限が必要です。

次のサブパラメータを使用して、動的フィールドを定義できます。

次のような構文を使用して表計算を作成できます。

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 文字までの説明を追加できます。ユーザーがフィールド ピッカーのフィールド名の右にある情報アイコンをクリックした場合、または Explore、ダッシュボード、Look のテーブルまたはテーブル チャートのビジュアリゼーションの列名にマウスオーバーした場合、説明が表示されます。

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 サブパラメータは、表計算をビジュアリゼーションとその基盤となる 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

view_name.field_name 形式で系列名を示すことで、1 つ以上の列で セルの可視化オプションを使用するかどうかを指定します。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 サブパラメータは、セルテキストのフォントの色を示します。カラー値には、#2ca6cd などの 16 進数文字列、または mediumblue などの CSS 指定のカラー文字列を指定できます。

bg_color

bg_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 がある場合は、これらの 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

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

header_font_color

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

カラー値には、#2ca6cd などの 16 進数文字列、または mediumblue などの CSS 指定のカラー文字列を指定できます。


header_font_color: purple

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

header_background_color

header_background_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 パラメータを使用して、テーブル ビジュアリゼーションを色分けするルールを定義します。条件付き書式ルールのそれぞれについて、次のパラメータで設定を指定できます。

条件付き書式ルールの例を次に示します。


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... に設定できます。

論理条件に基づいて値を色分けする場合は、value の値とともに、type に次のいずれかの値を指定できます。

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