LookML ダッシュボードのテーブル（以前の）グラフ パラメータ

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

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

使用例


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_column_names: true | false
show_view_names: true | false
series_labels:
  view_name.field_name: desired series label

## FORMATTING PARAMETERS
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

パラメータの定義

パラメータ名 説明
基本パラメータ
name（要素の場合） 要素を作成します。
title（要素の場合） ユーザーに表示される要素名の表示方法を変更します。
type（要素の場合） 要素で使用する可視化のタイプを決定します。
height（要素の場合） 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 要素のメモを定義するために、LookML セクションを開始します。このパラメータには、サブパラメータ text、state、display があります。
クエリ パラメータ
model 要素のクエリに使用するモデルを定義します。
explore（要素の場合） 要素のクエリに使用する Explore を定義します。
dimensions 要素のクエリに使用するディメンションを定義します
measures 要素のクエリに使用するメジャーを定義します。
sorts 要素のクエリに使用する並べ替えを定義します。
pivots 要素のクエリに使用するためにピボットする必要があるディメンションを定義します。
limit 要素のクエリに使用する行制限を定義します
filters（要素の場合） 要素のクエリで変更できないフィルタを定義します。
listen filters（ダッシュボード用）が作成されている場合に、要素のクエリに対して変更できるフィルタを定義します。
query_timezone クエリの実行時に使用するタイムゾーンを定義します。
merged_queries 統合された結果のクエリを定義します。
プロット パラメータ
table_theme 5 つの表の色分けオプションのいずれかを表のビジュアリゼーションに適用します。
total テーブル ビジュアリゼーションに列の合計を表示するかどうかを指定します。
row_total テーブル ビジュアリゼーションで行の合計を表示するかどうかを指定します。
show_row_numbers 各テーブル行の先頭に行番号を表示するかどうかを設定します。
hide_totals テーブル ビジュアリゼーションに列の合計を表示するかどうかを設定します。
hide_row_totals テーブル ビジュアリゼーションで行の合計を表示するかどうかを設定します
hidden_fields クエリで使用するフィールドを指定しますが、グラフでは非表示にします。
limit_displayed_rows 結果の位置に基づいて、ビジュアリゼーションで行を表示または非表示にします。
limit_displayed_rows_values ビジュアリゼーションで表示または非表示にする行を指定します。このパラメータには、サブパラメータ show_hide、first_last、num_rows があります。
シリーズのパラメータ
truncate_column_names 列ヘッダーを省略記号（…）で短縮します。
show_view_names 各列ヘッダーにビュー名とフィールド名を表示します。
series_labels ビジュアリゼーションの各列のカスタムラベルを指定します
パラメータの形式
enable_conditional_formatting true に設定して、テーブル ビジュアリゼーションの色分けルールを定義します。
conditional_formatting_include_totals 合計が色分けスキームに含まれるかどうかを指定します
conditional_formatting_include_nulls 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

次のように、要素に説明用のメモを追加できます。

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note には、サブパラメータ text、state、display があります。

text

text サブパラメータは、メモに表示されるテキストを指定します。テキストはローカライズできます。

state

state サブパラメータは、要素の幅内で 1 行に収まらない場合に、メモを collapsed にするか expanded にするかを決定します。collapsed を選択した場合、メモが長すぎると、メモの末尾にクリック可能な省略記号（...）が表示され、クリックするとメモ全体が表示されます。

display

display サブパラメータは、要素上でメモが表示される場所を決定します。above は要素の上部にメモを配置し、below は要素の下部にメモを配置します。hover では、ユーザーが要素にマウスを合わせるとメモが表示されます。

クエリ パラメータ

LookML ダッシュボードの要素を定義する場合は、少なくとも model クエリ パラメータと explore クエリ パラメータの値を指定する必要があります。また、dimensions パラメータまたは measures パラメータを使用して、少なくとも 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 パラメータのドキュメント ページをご覧ください。

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]

limit

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

- name: orders_by_date
  limit: 100

filters

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

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

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

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

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

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

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

listen

ダッシュボード フィルタを使用すると、ダッシュボードの要素に表示されるデータをインタラクティブに絞り込むことができます。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

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 ダッシュボード フィルタを操作すると、統合クエリ要素内の対応するソースクエリがそれに応じてフィルタされます。

プロット パラメータ

次のパラメータは、テーブル（レガシー）グラフのビジュアリゼーション エディタの [プロット] セクションのオプションに対応しています。

table_theme

table_theme パラメータを使用して、次のいずれかの表の色付けオプションを表要素に適用します。

  • editable: 表には、青色のディメンション、オレンジ色のメジャー、緑色の表計算が表示されます。
  • white: 表のヘッダーは白で、データ行は白と灰色で交互に表示され、テキストは黒です。
  • gray: 表のヘッダーは灰色で、データ行は白と薄い灰色で交互に表示され、テキストは暗い灰色です。
  • transparent: 表のヘッダーは完全に透明で、データ行は完全に透明と半透明の灰色で交互に表示され、テキストの色は、透けて見える背景色に応じて必要に応じて黒から白に自動調整されます。table_theme を transparent に設定すると、カスタマイズした埋め込みダッシュボードを使用する場合に、ビジュアリゼーションを通じてタイルの背景色が表示されるようにすることができます。
  • unstyled: 表のヘッダーとデータ行は白で、テキストは黒です。

table_theme: editable | white | gray | transparent | unstyled

total

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

total: true | false

## default value: false

row_total

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

row_total: right | left | false

## default value: false

show_row_numbers

show_row_numbers パラメータは、各テーブル行の先頭に行番号を表示するかどうかを設定します。


show_row_numbers: true | false

hide_totals

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


hide_totals: true | false

hide_row_totals

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


hide_row_totals: true | false

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_column_names

truncate_column_names パラメータは、列ヘッダーを省略記号（...）で短縮するかどうかを設定します。


truncate_column_names: true | false

show_view_names

show_view_names パラメータは、軸名や列名などのグラフのラベルにビュー名を表示するかどうかを決定します。

show_view_names: true | false

## default value: true

series_labels

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

ピボットされたグラフの場合、系列名はピボット名になります。

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

複数のメジャーを含むグラフの場合、系列名はメジャー フィールド名になります。

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

パラメータの形式

次のパラメータは、テーブル（レガシー）グラフのビジュアリゼーション エディタの [書式設定] セクションのオプションに対応しています。

enable_conditional_formatting

enable_conditional_formatting を true に設定すると、スケールで、または目的の値を指定してテーブル ビジュアリゼーションを色分けするルールを定義できます。


enable_conditional_formatting: true | false

conditional_formatting_include_totals

enable_conditional_formatting が true に設定されている場合、conditional_formatting_include_totals は合計が色分けスキームに含まれるかどうかを指定します。


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

enable_conditional_formatting が true に設定されている場合、conditional_formatting_include_nulls は 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 ]