このページでは、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: "hex string" | 'CSS named color string'
down_color: "hex string" | 'CSS named color string'
total_color: "hex string" | '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
## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
パラメーター定義
| パラメーター名 | 説明 | |
|---|---|---|
| 基本パラメータ | ||
name（要素の場合） |
要素を作成します。 | |
title（要素の場合） |
要素名のユーザーへの表示方法を変更します | |
type（要素の場合） |
要素で使用するビジュアリゼーションのタイプを決定します。 | |
height（要素の場合） |
layout: tile および layout: static ダッシュボードの要素の高さを tile_size の単位で定義します |
|
width（要素の場合） |
layout: tile および layout: static ダッシュボードの要素の幅を tile_size の単位で定義します |
|
top |
layout: static ダッシュボードで、要素の上から下への位置を tile_size の単位で定義します。 |
|
left |
layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します |
|
row |
layout: newspaper ダッシュボードの要素の上から下の位置を、行単位で定義します。 |
|
col |
layout: newspaper ダッシュボードの要素の左から右への位置を列単位で定義します |
|
refresh（要素の場合） |
要素が自動的に更新される間隔を設定します | |
note_state |
大きすぎて要素の幅内に収まらない場合にメモを折りたたむか展開するかを定義します | |
note_display |
要素でメモを表示する場所を定義します | |
note_text |
メモに表示するテキストを指定します | |
| クエリ パラメータ | ||
model |
要素のクエリに使用するモデルを定義します。 | |
explore（要素の場合） |
要素のクエリに使用する Explore を定義します。 | |
fields |
要素のクエリに使用されるフィールドを定義します。これは、dimensions と measures の代わりに使用できます。 |
|
dimensions |
要素のクエリに使用するディメンションを定義します。 | |
measures |
要素のクエリに使用するメジャーを定義します。 | |
sorts |
要素のクエリに使用する並べ替えを定義します | |
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 軸に値が表示されます。 | |
| Y 軸パラメータ | ||
show_y_axis_labels |
Y 軸のラベルを表示または非表示にします | |
show_y_axis_ticks |
Y 軸に値が表示されます。 | |
y_axis_gridlines |
Y 軸からグリッド線を延長します | |
基本パラメータ
LookML ダッシュボード要素を定義する場合は、少なくとも name と type の基本パラメータの値を指定する必要があります。その他の基本パラメータ（title、height、width など）は、ダッシュボードの要素の外観と位置に影響します。
name
このセクションでは、ダッシュボード要素の一部である
nameパラメータについて説明します。
nameはダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
name の宣言ごとに新しいダッシュボード要素が作成され、名前が割り当てられます。要素名は一意である必要があります。layout: grid ダッシュボードを使用している場合、名前が elements パラメータで参照されることがあります。
- name: orders_by_date
title
このセクションでは、ダッシュボード要素の一部である
titleパラメータについて説明します。
titleはダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
titleはダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
title パラメータを使用すると、要素名のユーザーへの表示方法を変更できます。指定しない場合、タイトルはデフォルトで要素 name に設定されます。
次の例を考えてみましょう。
- name: sales_overview
title: '1) Sales Overview'
この形式を使用すると、要素は [販売の概要] ではなく [1）販売の概要] と表示されます。
type
このセクションでは、ダッシュボード要素の一部である
typeパラメータについて説明します。
typeはダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。また、
type（結合用）パラメータのドキュメント ページに記載されているように、typeを結合の一部として使用することもできます。
typeは、ディメンションの一部として使用することもできます。詳しくは、ディメンション、フィルタ、パラメータの種類に関するドキュメント ページをご覧ください。
typeは、メジャーの一部として使用することもできます。詳しくは、メジャーのタイプに関するドキュメント ページをご覧ください。
type パラメータは、要素で使用するビジュアリゼーションのタイプを決定します。
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot
さまざまなタイプの LookML ダッシュボード要素の概要については、type（LookML ダッシュボード用）のドキュメントをご覧ください。
height
このセクションでは、ダッシュボード要素の一部である
heightパラメータについて説明します。
heightは、ダッシュボードの行の一部として使用することもできます。詳しくは、ダッシュボード パラメータのドキュメントをご覧ください。
tile または static レイアウトのダッシュボードの場合
height パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の高さを tile_size（ピクセル単位で定義）単位で定義します。
たとえば、次のコードでは tile_size: 100 と height: 4 を指定して、orders_by_date 要素の高さを 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
newspaper レイアウトのダッシュボードの場合
height パラメータは、layout: newspaper ダッシュボードの要素の高さを行単位で定義します。
新聞レイアウトのダッシュボードのデフォルトは、6 行（およそ 300 ピクセル）の要素の高さです。preferred viewer パラメータが dashboards-next に設定されたダッシュボードの最小高さは 1 行です。ダッシュボードの高さの最小値は 2 行で、preferred viewer パラメータを dashboards に設定します。
たとえば、次のコードは、要素の高さを 12 行、またはデフォルトに設定されている他の要素の高さの 2 倍に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
このセクションでは、ダッシュボード要素の一部である
widthパラメータについて説明します。
widthはダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
width パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の幅を tile_size の単位で定義します。
たとえば、次のコードは tile_size: 100 と width: 4 を指定して、orders_by_date 要素の幅を 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
width パラメータは、layout: newspaper ダッシュボードの要素の幅を列単位で定義します。
新聞レイアウトのダッシュボードのデフォルト幅は 24 列です。
次のコードは、要素をダッシュボードの幅の半分に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
top パラメータは、layout: static ダッシュボードの要素の上から下の位置を tile_size の単位で定義します。
たとえば、次のコードでは、tile_size: 100 と top: 4 を指定して、orders_by_date 要素の上端をダッシュボードの上から 400 ピクセルの位置に配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left パラメータは、layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します。
たとえば、次のコードは tile_size: 100 と left: 4 を指定し、orders_by_date 要素の左端をダッシュボードの左端から 400 ピクセルの位置に配置します。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
layout: newspaper ダッシュボードの場合、row パラメータは、要素の上端を配置する行を定義します。
ダッシュボードの先頭は行 0 です。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になっています。つまり、ダッシュボードの上部にあるダッシュボード要素（row: 0）では、デフォルトで 0 ～ 5 の行が使用されます。
各行の高さは 50 ピクセルです。つまり、デフォルトの要素の高さは 6 で、300 ピクセルです。
たとえば次のコードは、要素がデフォルトの高さに設定されていると仮定して、要素を要素の 2 行目に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
layout: newspaper ダッシュボードの場合、col パラメータは、要素の左端を配置する列を定義します。
ダッシュボードは 24 列に分かれています。ダッシュボードの左側 0 から始まるダッシュボード。新聞レイアウトのダッシュボードの要素幅は、デフォルトで 8 列になります。つまり、ダッシュボードの左側にある col: 0 要素では列 0 ～ 7 がデフォルトで表示されます。
たとえば、次のコードでは、ダッシュボードの要素の 3 列目に設定する要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
このセクションでは、ダッシュボード要素の一部である
refreshパラメータについて説明します。
refreshはダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
refresh パラメータを使用すると、要素を定期的に再読み込みすることで、最新のデータを取得できます。これは、オフィスのテレビなど、常にダッシュボードが表示される設定で役立ちます。このパラメータを有効にするには、ダッシュボードをブラウザ ウィンドウで開く必要があります。この設定は、ダッシュボードのキャッシュを「ウォームアップ」するためにバックグラウンドで実行されることはありません。
リフレッシュ レートは、秒、分、時間、日の任意の数値（小数点なし）にできます。例:
- name: orders_by_date
refresh: 2 hours
更新間隔を短く設定する場合は注意が必要です。この要素の背後にあるクエリがリソースを大量に消費する場合、特定の要素が原因でデータベースに過大な負荷がかかる可能性があります。
note_state
note_state パラメータでは、要素の幅内にある 1 行に収まらないほど大きいメモを折りたたんだり展開したりするかどうかを定義します。collapsed を選択してメモが長すぎる場合は、メモの最後に表示される省略記号（...）が表示されます。これを使用してメモの全文を読むことができます。expanded を選択してメモが長い場合、メモは追加の行に表示されます。
note_display
note_display パラメータは、要素にメモを表示する場所を定義します。above は、メモを要素の上部に配置し、below は、要素の下部にメモを配置します。hover では、ユーザーがメモを表示するには、? アイコンにカーソルを合わせる必要があります。
note_text
note_text パラメータは、要素メモに表示されるテキストを指定します。
クエリ パラメータ
LookML ダッシュボード要素を定義する場合は、少なくとも model および explore クエリ パラメータの値を指定し、dimensions パラメータ、measures パラメータ、または fields パラメータを使用して少なくとも 1 つのフィールドを指定する必要があります。以下で説明するその他のクエリ パラメータを使用して、ダッシュボード要素でのデータの表示方法を制御することもできます。
model
model パラメータは、要素クエリに使用するモデルを定義します。指定しない場合は、デフォルトでダッシュボードが存在するモデルになります。
- name: orders_by_date
model: ecommerce
model パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を model の値として設定できます。定数を使用すると、1 つのモデル名を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されるモデルの名前を更新する場合に特に便利です。
LookML ダッシュボードで定数の詳細と使用例については、constant パラメータのドキュメント ページをご覧ください。
explore
このセクションでは、ダッシュボード要素の一部である
exploreパラメータについて説明します。
exploreは、モデルの一部として使用することもできます。詳しくは、exploreパラメータのドキュメントをご覧ください。
exploreはダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
explore パラメータは、要素クエリに使用する Explore を定義します。
- name: orders_by_date
explore: order
explore パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を explore の値として設定できます。定数を使用すると、1 つの場所で Explore の名前を定義できます。これは、複数のダッシュボード要素で使用される Explore の名前を更新する場合に特に便利です。
LookML ダッシュボードで定数の詳細と使用例については、constant パラメータのドキュメント ページをご覧ください。
fields
fields パラメータは、要素クエリに使用するフィールドを定義します。フィールドを指定するには、構文 view_name.dimension_name を使用します。
## single field example
- name: orders_by_date
fields: order.order_date
## multiple fields example
- name: orders_by_date
fields: [order.order_date, order.order_count]
fields パラメータを使用する場合、dimensions パラメータと measures パラメータを使用する必要はありません。
dimensions
dimensions パラメータは、要素クエリに使用するディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。クエリに dimensions を含めない場合は、含めないでください。
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
measures パラメータは、要素クエリに使用するメジャーを定義します。構文は view_name.measure_name を使用してメジャーを指定します。クエリに measures を含めない場合は、含めないでください。
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
sorts パラメータは、要素クエリに使用する並べ替えを定義します。1 番目、2 番目、3 と順に表示されます。構文 view_name.field_name は、ディメンションまたはメジャーを指定するときに使用します。Looker のデフォルトの並べ替え順を使用する場合は、sorts を含めないでください。降順にする場合、末尾には desc を付けます。昇順で並べ替える場合は、接尾辞は不要です。
## single sort example
- name: orders_by_date
sorts: order.order_date desc
## multiple sort example
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
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
ダッシュボードには、ユーザーがダッシュボード要素の背後にあるデータを変更できるフィルタを含めることができます。これらは、ダッシュボードの filters パラメータを使用して設定します。フィルタが要素に影響するには、listen パラメータを使用して、フィルタの要素が「リッスン」に設定する必要があります。
listen の構文は次のとおりです。
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
たとえば、[日付] というフィルタを作成し、ユーザーが UI のフィルタ フィールドに日付を入力する必要があるとします。その後、ユーザーが入力した値を次のように orders_by_date 要素に適用できます。
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
このコンセプトの詳細については、LookML ダッシュボードの構築のドキュメントをご覧ください。
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 パラメータでは、複数のクエリから結果を結合する方法を定義します。コンポーネント クエリを merged_queries パラメータの下に定義し、join_fields サブパラメータを使用してマージルールを定義します。
merged_queries の構文は次のとおりです。
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: 'field from the source query using the view_name.field_name syntax'
source_field_name: 'joined field from the primary query using the
view_name.field_name syntax'
# more join_fields definitions as needed
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
# more join_fields definitions as needed
# additional source queries and join_fields definitions as needed
merged_results で定義された最初のクエリがプライマリ クエリであり、他のクエリはそのクエリと統合されます。
たとえば、銘柄コード、会社名、Twitter ユーザー名で結合すると、2 つのクエリを統合して、会社名、会社の Twitter ユーザー名、IPO の年、銘柄コード、従業員数、求人数の結果を返すことができます。
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
filters:
company.twitter_username: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: crunchbase
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.twitter_username: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: company.name
- field_name: companies.twitter_username
source_field_name: company.twitter_username
データの結果は次のようになります。
次に、要素パラメータを適用して、お好みでビジュアリゼーションのスタイルを設定できます。
時系列パラメータ
このセクションで説明するパラメータは、ウォーターフォール グラフ用のビジュアリゼーション エディタの [シリーズ] メニューのオプションに対応しています。
up_color
グラフの正の値の棒の色を設定します。色の値は、#2ca6cd のように引用符で囲んだ 16 進文字列か、mediumblue などの CSS 名前付き色文字列で指定します。
up_color: blue
up_color パラメータは、使用する場合、color_application パラメータをオーバーライドします。
down_color
グラフの負の値バーの色を設定します。色の値は、#2ca6cd のように引用符で囲んだ 16 進文字列か、mediumblue などの CSS 名前付き色文字列で指定します。
down_color: "#ff0000"
down_color パラメータは、使用する場合、color_application パラメータをオーバーライドします。
total_color
グラフの合計値バーの色を設定します。色の値は、#2ca6cd のように引用符で囲んだ 16 進文字列か、mediumblue などの CSS 名前付き色文字列で指定します。
total_color: yellow
total_color パラメータは、使用する場合、color_application パラメータをオーバーライドします。
color_application
color_application パラメータと、そのサブパラメータ collection_id および palette_id を使用して、特定の色コレクションとパレットをダッシュボード要素に適用できます。Looker のネイティブ カラー コレクションの概要については、カラー コレクションのドキュメント ページをご覧ください。
使用するパレット用のコレクション ID とパレット ID がある場合は、collection_id と palette_id のサブパラメータにその ID を入力します。コレクション ID またはパレット ID は、英数字のコードの場合もあれば、カラー コレクションの名前に基づく場合もあります。英数字のコードは Looker のネイティブ コレクションに使用されます。これらはインスタンス固有で、次のようになります。
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
カスタム カラー コレクションは、カラー コレクションの名前に基づくコレクション ID とパレット ID を使用します。この ID はインスタンス間で移植可能で、次のようになります。
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
また、UI を使って必要な色、コレクション、パレットを見つけて、LookML を生成してダッシュボードに追加することもできます。ユーザー定義コンテンツ（Look、ダッシュボード、Explore など）に移動し、UI を使用してコンテンツのビジュアリゼーションに適用する色、コレクション、パレットを適用します。完了したら、ダッシュボード LookML を取得する手順に従って、生成された LookML をコピーし、color_application セクションに貼り付けます。
color_application と、正、負、合計の値のバー
デフォルトでは、指定したパレットの最初の色はウォーターフォール グラフの正の値のバーに適用され、2 番目の色はウォーターフォール グラフの負のバーに適用され、3 番目の色はウォーターフォール チャートの合計バーに適用されます。オプションのサブパラメータ reverse を使用すると、アプリケーションを最後の色、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 パラメータで指定された色をオーバーライドします。
値のパラメータ
このセクションで説明するパラメータは、ウォーターフォール チャートのビジュアリゼーション エディタの [値] メニューのオプションに対応しています。
show_value_labels
データポイントの横に棒、線、点の値を表示します。
show_value_labels: true | false
## default value: false
label_color
label_color パラメータは、ラベルの色の値を受け入れます。色の値は、#2ca6cd などの 16 進文字列や、mediumblue などの CSS 名前付き色文字列の形式にすることができます。
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
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