Looker 26.20 のドキュメントを表示しています。最新のドキュメントについては、こちらのリンクをクリックしてください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

LookML ダッシュボードのウォーターフォールグラフのパラメータ

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

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

使用例

N は、数値が必要であることを示します。一重引用符は説明文を示します。実際のコードには含めないでください。


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_waterfall
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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
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
hidden_fields: [view_name.field_name, view_name.field_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

## SERIES PARAMETERS
up_color: &#34;hex string&#34; | 'CSS named color string'
down_color: &#34;hex string&#34; | 'CSS named color string'
total_color: &#34;hex string&#34; | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_zoom: true | false

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

パラメータの定義

パラメータ名	説明
基本パラメータ
`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`	要素のクエリに使用する並べ替えを定義します。
`fill_fields`	ディメンションフィルオプションを使用するディメンションを定義します。
`limit`	要素のクエリに使用する行制限を定義します
`filters`（要素の場合）	要素のクエリで変更できないフィルタを定義します。
`filter_expression`	要素のクエリに対して変更できないカスタムフィルタを定義します。
`listen`	`filters`（ダッシュボード用）が作成されている場合に、要素のクエリに対して変更できるフィルタを定義します。
`hidden_fields`	クエリで使用するものの、グラフには表示しないフィールドを指定します。
`query_timezone`	クエリの実行時に使用するタイムゾーンを定義します。
`merged_queries`	統合された結果のクエリを定義します。
シリーズのパラメータ
`up_color`	グラフ内の正の値を示すバーの色を設定します。
`down_color`	グラフ内の負の値のバーの色を設定します。
`total_color`	グラフの合計値を示す棒の色を設定します。
`color_application`	カラーコレクションとパレットをグラフに適用します。
値パラメータ
`show_value_labels`	各データバーのラベルを表示します
`label_color`	ラベルの色値を指定します。
X 軸パラメータ
`x_axis_scale`	X 軸の目盛りの計算方法を指定します。
`show_x_axis_label`	X 軸ラベルの表示 / 非表示を切り替えます。
`show_x_axis_ticks`	X 軸に値を表示します。
`x_axis_zoom`	X 軸に沿ったズームを許可するかどうかを指定します
Y 軸パラメータ
`show_y_axis_labels`	Y 軸ラベルを表示または非表示にします
`show_y_axis_ticks`	Y 軸に値を表示します。
`y_axis_gridlines`	Y 軸からグリッド線を延長します。
`y_axis_zoom`	Y 軸に沿ったズームを許可するかどうかを指定します。`x_axis_zoom: false` の場合は無効。
高度なビジュアリゼーション構成パラメータ
`advanced_viz_config`	複数の可視化設定をオーバーライドできる HighCharts JSON スニペットを受け入れます。

基本パラメータ

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]

`fill_fields`

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

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

`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 変数を使用して、フィルタ値を柔軟に設定することもできます。

`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 ダッシュボードの作成をご覧ください。

`hidden_fields`

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

hidden_fields: [inventory_items.count, distribution_centers.id]

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

シリーズパラメータ

このセクションで説明するパラメータは、ウォーターフォールグラフのビジュアリゼーションエディタの [シリーズ] メニューのオプションに対応しています。

`up_color`

グラフ内の正の値のバーの色を設定します。色の値には、引用符で囲まれた 16 進数文字列（「#2ca6cd」など）または CSS 指定のカラー文字列（mediumblue など）を使用できます。

up_color: blue

up_color パラメータは、color_application パラメータが使用されている場合、それをオーバーライドします。

`down_color`

グラフ内の負の値のバーの色を設定します。色の値には、引用符で囲まれた 16 進数文字列（「#2ca6cd」など）または CSS 指定のカラー文字列（mediumblue など）を使用できます。

down_color: &#34;#ff0000&#34;

down_color パラメータは、color_application パラメータが使用されている場合、それをオーバーライドします。

`total_color`

グラフの合計値バーの色を設定します。色の値には、引用符で囲まれた 16 進数文字列（「#2ca6cd」など）または CSS 指定のカラー文字列（mediumblue など）を使用できます。

total_color: yellow

total_color パラメータは、color_application パラメータが使用されている場合、それをオーバーライドします。

`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 セクションに貼り付けます。

`color_application` と正、負、合計値のバー

デフォルトでは、指定したパレットの最初の色がウォーターフォールグラフの正の値のバーに適用され、パレットの 2 番目の色がウォーターフォールグラフの負のバーに適用され、指定したパレットの 3 番目の色がウォーターフォールグラフの合計バーに適用されます。オプションのサブパラメータ reverse を使用すると、アプリケーションをそれぞれ最後から 1 番目、2 番目、3 番目の色に変更できます。

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

up_color、down_color、total_color の各パラメータは、両方のタイプの色パラメータが使用されている場合、color_application パラメータで指定された色をオーバーライドします。

value パラメータ

このセクションで説明するパラメータは、ウォーターフォールグラフのビジュアリゼーションエディタの [値] メニューのオプションに対応しています。

`show_value_labels`

データポイントの横に棒、線、または点の値を表示します。

show_value_labels: true | false

## default value: false

`label_color`

label_color パラメータには、ラベルのカラー値を指定します。色の値は、16 進数文字列（#2ca6cd など）または CSS 指定のカラー文字列（mediumblue など）としてフォーマットできます。


label_color: [blue]

X 軸のパラメータ

このセクションで説明するパラメータは、ウォーターフォールグラフのビジュアリゼーションエディタの [X] メニューのオプションに対応しています。

`x_axis_scale`

このパラメータは、X 軸の目盛りの計算方法を決定します。

auto: 目盛りは、基礎となるデータから推定されます。これはデフォルトの設定です。
ordinal: データは等間隔の個別のエントリとしてプロットされます。
time: データは時間としてプロットされ、軸には適切なラベルが付けられます。基となるデータを日付に変換できない場合、この方法は機能しません。

x_axis_scale: auto | ordinal | time

## default value: auto

`show_x_axis_label`

このパラメータは、X 軸ラベルを表示するかどうかを決定します。

show_x_axis_label: true | false

## default value: true

`show_x_axis_ticks`

このパラメータは、X 軸に値を表示するかどうかを決定します。

show_x_axis_ticks: true | false

## default value: true

`x_axis_zoom`

このパラメータは、ユーザーがビジュアリゼーションの X 軸を拡大できるかどうかを指定します。x_axis_zoom が true に設定されている場合、ズームを使用できます。x_axis_zoom が false に設定されている場合、ズームは使用できません。

x_axis_zoom が false に設定されている場合、y_axis_zoom は無効になります。

x_axis_zoom: true | false

# default value: true

Y 軸のパラメータ

このセクションで説明するパラメータは、ウォーターフォールグラフのビジュアリゼーションエディタの [Y] メニューのオプションに対応しています。

`show_y_axis_labels`

このパラメータは、Y 軸ラベルを表示するかどうかを決定します。

show_y_axis_labels: true | false

## default value: true

`show_y_axis_ticks`

このパラメータは、Y 軸に値を表示するかどうかを決定します。

show_y_axis_ticks: true | false

## default value: true

`y_axis_gridlines`

このパラメータは、グリッド線を Y 軸から延長するかどうかを決定します。

y_axis_gridlines: true | false

## default value: true

`y_axis_zoom`

このパラメータは、ユーザーがビジュアリゼーションの Y 軸を拡大できるかどうかを指定します。y_axis_zoom が true に設定されている場合、ズームを使用できます。

y_axis_zoom が false に設定されている場合、ユーザーは Y 軸のより狭い部分をズームできません。ただし、x_axis_zoom パラメータが true に設定されている場合、ユーザーは x 軸をより狭くズームできます。

x_axis_zoom が false に設定されている場合、y_axis_zoom は無効になります。

y_axis_zoom: true | false

# default value: true

高度な可視化構成

このセクションで説明するパラメータは、オプションのグラフ構成のオーバーライドに対応しています。これは、可視化エディタの [プロット] セクションにある [グラフ構成の編集] ボタンをクリックしてグラフに適用できます。

`advanced_vis_config`

このパラメータは、いくつかの可視化設定をオーバーライドして新しい機能を開く HighCharts JSON スニペットを受け入れます。HighCharts JSON を使用して一般的なユースケースを実現する例については、グラフ構成エディタを使用した可視化のカスタマイズのドキュメントページをご覧ください。


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

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

# default value: null

LookML ダッシュボードのウォーターフォール グラフのパラメータ コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

使用例

パラメータの定義

基本パラメータ

name

title

type

height

tile または static レイアウトのダッシュボードの場合

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

width

top

left

row

col

refresh

note_state

note_display

note_text

クエリ パラメータ

model

explore

fields

dimensions

measures

sorts

fill_fields

limit

filters

filter_expression

listen

hidden_fields

query_timezone

merged_queries