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 パラメータで参照されることがあります。また、要素をタイルグループ（type: group）に編成している場合は、子要素の group パラメータで参照されることがあります。

- 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 | button | group

さまざまなタイプの 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 行です。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 パラメータは、要素の上端が配置される行を定義します。group パラメータを使用して要素がタイルグループ内に配置されている場合、row は、グループ コンテナ（row: 0）の上部を基準とした要素の行位置を定義します。

ダッシュボードは、ダッシュボードの上部にある行 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 パラメータは、要素の左端が配置される列を定義します。group パラメータを使用して要素がタイルグループ内に配置されている場合、col は、グループ コンテナ（col: 0）の左端を基準とした要素の列位置を定義します。

ダッシュボードは 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 パラメータは、要素のクエリの並べ替え動作を定義します。最初にメインの並べ替えフィールドをリストし、次にサブの並べ替えフィールドをリストします。view_name.field_name 構文を使用して、並べ替えの基準となるディメンションまたはメジャーを指定します。

sorts パラメータを省略すると、要素は Looker のデフォルトの並べ替え順を使用します。昇順の並べ替えには接尾辞は必要ありませんが、降順の並べ替えには desc 接尾辞が必要です。

次の例では、1 つの並べ替えを定義しています。

- name: orders_by_date
  sorts: order.order_date desc

次の例では、複数の並べ替えを定義しています。

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

ディメンションをピボットする場合は、メジャー名、並べ替え方向、データテーブル内のターゲット列の 0 ベースのインデックス番号を指定して、クエリ結果を並べ替えることができます。たとえば、次の要素は、インデックス 0 を使用して最初のピボット列で並べ替えます。

- name: orders_by_category
  sorts: [orders.count desc 0]

行の合計で並べ替えるには、合計列のインデックスを指定します。たとえば、次の要素は、インデックス 2 を使用して行の合計で並べ替えます。これは、2 つのピボット列を含むクエリの合計列を表します。

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

pivots パラメータは、要素クエリでピボットするディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。クエリに pivots がない場合は、含めないでください。

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

fill_fields

fill_fields パラメータは、ディメンション フィル オプションを使用するディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。

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

subtotals

subtotals パラメータは、小計オプションを使用するディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。

subtotals: [products.department, distribution_centers.name]

total

total パラメータは、テーブルの下部に合計行を表示するかどうかを設定します。詳細については、合計の表示をご覧ください。

total: true | false

## default value: false

row_total

row_total パラメータは、合計列をテーブルの右側と左側のどちらに表示するかを設定します。ピボットが存在する場合にのみ機能します。詳細については、合計の表示をご覧ください。

row_total: right | left | false

## default value: false

limit

limit パラメータは、要素クエリに使用する行制限を定義します。この上限は、ピボットが適用される前の行数に適用されます。

- name: orders_by_date
  limit: 100

column_limit

column_limit パラメータは、要素クエリに使用する列の上限を定義します。この上限は、ピボットが適用された後の列数に適用されます。

- name: orders_by_date
  column_limit: 100

filters

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

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

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

filters パラメータは、要素のクエリに使用する必要がある変更不可能なフィルタを定義します。ユーザーがダッシュボードで変更できるフィルタが必要な場合は、ダッシュボード用の filters を使用してフィルタを設定し、listen を使用して要素に適用する必要があります。

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

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

各フィルタは、Looker のフィルタ式または値定数を受け入れることができます。フィルタ式で _localization または _user_attributes Liquid 変数を使用して、フィルタ値を柔軟に設定することもできます。

filter_expression

filter_expression パラメータは、要素のクエリに対して変更不可能なカスタム フィルタを定義します。ユーザーがダッシュボードで変更できるフィルタが必要な場合は、ダッシュボード用の filters を使用してフィルタを設定し、listen を使用して要素に適用する必要があります。

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Looker のフィルタ式のドキュメント ページに、Looker のフィルタ式が一覧表示されています。

listen

ダッシュボード フィルタを使用すると、ダッシュボードの要素に表示されるデータをインタラクティブに絞り込むことができます。LookML ダッシュボードの filters パラメータを使用して、ダッシュボード フィルタを定義します。次に、listen パラメータを使用して、ダッシュボードの要素をダッシュボード フィルタにリンクします。

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

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

listen パラメータを要素に追加し、フィルタの名前、コロン、フィルタを適用するフィールドへの参照を view_name.field_name 構文を使用して指定します。たとえば、Date というフィルタを作成し、ユーザーが UI のフィルタ フィールドに日付を入力するように設定できます。次のように、ユーザーが入力した値を orders_by_date 要素に適用できます。

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

リッスンされているフィルタが vis_filter: true パラメータで構成されている場合、フィルタ コントロールは、上部のダッシュボード フィルタバーではなく、そのビジュアリゼーション タイルの上部にあるフィルタバーに直接表示されます。

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:
    - 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 は、予測データ値の境界を設定します。これは、パーセンテージの小数表現として入力されます。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 は、Explore クエリの期間ディメンションに基づいて自動的に入力されます。


forecast_interval: day | month # a timeframe with dimension fill

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

ビジュアリゼーションに予測を追加するには、予測 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）から企業に関する情報を結合するマージされたクエリを作成するとします。各 Explore の 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 文字の説明を追加できます。Looker は、ユーザーがフィールド ピッカーのフィールド名の右にある情報アイコンをクリックしたとき、およびユーザーが 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

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 サブパラメータは、セルテキストのフォントの色を示します。色の値には、#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 パラメータには、1 つの数値を指定します。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 ]