このページでは、dashboard.lkml ファイルで LookML ダッシュボード パラメータを使用して type: looker_boxplot の LookML ダッシュボードの要素を追加してカスタマイズする方法について説明します。
Looker UI を使用して箱ひげ図を作成する方法については、箱ひげ図グラフのオプションのドキュメント ページをご覧ください。
使用例
N は、数値が必要であることを示します。一重引用符は説明文を示しており、ライブコードに含めるべきではありません。
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
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
fields: [view_name.field_name, 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, …]
limit: N
filters:
view_name.field_name: 'looker filter expression'
listen:
dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]
## SERIES PARAMETERS
color_application:
collection_id: 'collection ID'
palette_id: 'palette ID'
options:
reverse: true | false
## STYLE PARAMETERS
show_view_names: true | false
## X-AXIS PARAMETERS
show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false
## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
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 |
要素のメモを定義するために、LookML セクションを開始します。このパラメータには、text、state、display のサブパラメータがあります。 |
|
| クエリ パラメータ | ||
model |
要素のクエリに使用するモデルを定義します | |
explore（要素の場合） |
要素のクエリに使用する Explore を定義します | |
fields |
要素のクエリに使用するフィールドを定義します。これは、dimensions と measures の代わりに使用できます。 |
|
dimensions |
要素のクエリに使用するディメンションを定義します | |
measures |
要素のクエリに使用する指標を定義します | |
sorts |
要素のクエリに使用する並べ替えを定義します | |
limit |
要素のクエリに使用する行制限を定義します | |
filters（要素の場合） |
要素のクエリで変更できないフィルタを定義します。 | |
listen |
filters（ダッシュボード用）が作成されている場合、要素のクエリで変更できるフィルタを定義します。 |
|
query_timezone |
クエリの実行時に使用するタイムゾーンを定義します | |
hidden_fields |
クエリで使用するが、グラフでは非表示にするフィールドを指定します | |
| シリーズ パラメータ | ||
color_application |
グラフにカラー コレクションとパレットを適用します | |
| スタイル パラメータ | ||
show_view_names |
グラフのラベルにビュー名を表示するか非表示にするか | |
| X 軸のパラメータ | ||
show_x_axis_label |
X 軸ラベルの表示 / 非表示を切り替えます | |
x_axis_label |
カスタムの X 軸ラベルを定義します | |
show_x_axis_ticks |
X 軸に値を表示します | |
x_axis_gridlines |
X 軸からグリッド線を延長する | |
x_axis_reversed |
X 軸の方向を反転します | |
x_axis_zoom |
x 軸に沿ったズームを許可するかどうかを指定します | |
| Y 軸のパラメータ | ||
show_y_axis_labels |
Y 軸のラベルの表示 / 非表示を切り替えます | |
y_axis_labels |
カスタム Y 軸ラベルを定義します | |
show_y_axis_ticks |
Y 軸の値を表示する | |
y_axis_gridlines |
Y 軸からグリッド線を延長する | |
y_axis_min |
Y 軸の最小値を定義します | |
y_axis_max |
Y 軸の最大値を定義します | |
y_axis_tick_density |
y_axis_tick_density_custom パラメータを使用して、カスタムの Y 軸の目盛りの密度を設定するオプションを有効にします。 |
|
y_axis_tick_density_custom |
y_axis_tick_density が custom に設定されている場合の Y 軸の目盛りの密度を定義します |
|
y_axis_reversed |
Y 軸の方向を反転します | |
y_axis_value_format |
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 パラメータで参照されることがあります。
- name: orders_by_date
title
このセクションでは、ダッシュボードの要素の一部である
titleパラメータについて説明します。
titleは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
titleは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
title パラメータを使用すると、要素の名前がユーザーにどのように表示されるかを変更できます。指定しない場合、タイトルはデフォルトで要素 name になります。
次の例を考えてみましょう。
- name: sales_overview
title: '1) Sales Overview'
この形式を使用した場合、要素は Sales Overview ではなく 1) Sales Overview と表示されます。
type
このセクションでは、ダッシュボードの要素の一部である
typeパラメータについて説明します。
typeは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
typeは結合の一部としても使用できます。これについては、type（結合の場合）パラメータのドキュメント ページで説明しています。
typeは、ディメンション、フィルタ、パラメータのタイプに関するドキュメント ページで説明されているように、ディメンションの一部としても使用できます。
typeは、測定タイプのドキュメント ページで説明されているように、指標の一部としても使用できます。
type パラメータは、要素で使用するビジュアリゼーションのタイプを決定します。
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot
さまざまな種類の LookML ダッシュボード要素の概要については、type（LookML ダッシュボードの場合）のドキュメント ページをご覧ください。
height
このセクションでは、ダッシュボードの要素の一部である
heightパラメータについて説明します。
heightは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの行の一部としても使用できます。
tile または static レイアウトのダッシュボードの場合
height パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の高さを tile_size 単位（ピクセル単位で定義）で定義します。
たとえば、次のコードでは tile_size: 100 と height: 4 を指定し、orders_by_date 要素の高さを 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
newspaper レイアウトのダッシュボードの場合
height パラメータは、layout: newspaper ダッシュボードの要素の高さを row 単位で定義します。
新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行（約 300 ピクセル）になります。preferred viewer パラメータが dashboards-next に設定されているダッシュボードの最小の高さは 1 行です。preferred viewer パラメータが dashboards に設定されているダッシュボードの最小高さは 2 行です。
たとえば、次のコードでは、要素の高さを 12 行に設定します。これは、デフォルトに設定されている他の要素の 2 倍の高さです。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
このセクションでは、ダッシュボードの要素の一部である
widthパラメータについて説明します。
widthは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
width パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の幅を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と width: 4 を指定し、orders_by_date 要素の幅を 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
width パラメータは、layout: newspaper ダッシュボードの要素の幅を列単位で定義します。
ニュースペーパー レイアウトのダッシュボードのデフォルトの幅は 24 列です。
たとえば、次のコードは、要素をダッシュボードの幅の半分に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
top パラメータは、layout: static ダッシュボードの要素の上から下の位置を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と top: 4 を指定し、orders_by_date 要素の上端をダッシュボードの上端から 400 ピクセル離して配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left パラメータは、layout: static ダッシュボードの要素の左右の位置を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と left: 4 を指定し、orders_by_date 要素の左端をダッシュボードの左端から 400 ピクセル離して配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
layout: newspaper ダッシュボードの場合、row パラメータは要素の上端が配置される行を定義します。
ダッシュボードは、ダッシュボードの上部にある行 0 から始まります。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になります。つまり、ダッシュボードの上部にあるダッシュボード要素（row: 0）は、デフォルトで 0 ～ 5 行を占有します。
各行の高さは 50 ピクセルです。つまり、6 行の要素のデフォルトの高さは 300 ピクセルです。
たとえば、次のコードでは、要素がデフォルトの高さに設定されていると仮定して、ダッシュボードの 2 行目の要素に設定される要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
layout: newspaper ダッシュボードの場合、col パラメータは要素の左端が配置される列を定義します。
ダッシュボードは 24 列に分割されます。ダッシュボードは、ダッシュボードの左端の列 0 から始まります。新聞レイアウトのダッシュボードでは、要素の幅はデフォルトで 8 列になります。つまり、ダッシュボードの左側にあるダッシュボード要素（col: 0）は、デフォルトで 0 ～ 7 列を占有します。
たとえば、次のコードでは、ダッシュボードの 3 列目の要素に設定される要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
このセクションでは、ダッシュボードの要素の一部である
refreshパラメータについて説明します。
refreshは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
refresh パラメータを使用すると、要素が定期的に自動的に再読み込みされ、新しいデータが取得されます。これは、オフィスのテレビなど、ダッシュボードが常に表示されている設定で役立ちます。このパラメータを有効にするには、ダッシュボードがブラウザ ウィンドウで開いている必要があります。この設定は、ダッシュボードのキャッシュを「事前準備」するためにバックグラウンドで実行されません。
更新頻度は、秒、分、時間、日の任意の数（小数なし）で指定できます。次に例を示します。
- name: orders_by_date
refresh: 2 hours
更新間隔を短く設定する場合は注意してください。要素の背後にあるクエリがリソースを大量に消費する場合、特定の要素がデータベースに過度の負荷をかける可能性があります。
note
要素に説明用のメモを追加するには、次のようにします。
- 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 クエリ パラメータの値を指定する必要があります。
type: looker_boxplot の要素には、少なくとも 1 つのディメンションと、次の 2 つ、3 つ、または 5 つの種類の尺度が必要です（この順序でリストする必要があります）。
- 最小値: 最小データ値を表す尺度。これは、LookML で
type: minのメジャーとして定義できます。 - 25 パーセンタイル: 25 パーセンタイル、または第 1 四分位を表す指標。データ値の 4 分の 1 がこの値以下です。これは、LookML で
type: percentileのメジャーとして定義できます。この場合、percentileの値は25に設定されます。 - 中央値: データセットの中央値または中間点、または第 2 四分位を表す測定値。データ値の半分がこの値以下です。これは、LookML で
type: medianのメジャーとして定義できます。 - 75 パーセンタイル: 75 パーセンタイル、または第 3 四分位を表す指標。データ値の 4 分の 3 がこの値以下です。これは、LookML で
type: percentileのメジャーとして定義できます。この場合、percentileの値は75に設定されます。 - 最大値: 最大値を表す指標。これは、LookML で
type: maxのメジャーとして定義できます。
fields パラメータ、または dimensions パラメータと measures パラメータの両方を使用して、箱ひげ図要素の基になるディメンションと指標を指定できます。Looker UI での箱ひげ図の作成について詳しくは、箱ひげ図のオプションのドキュメント ページの箱ひげ図の作成をご覧ください。
このセクションで説明する他のクエリ パラメータを使用して、ダッシュボードの要素でのデータの表示方法を制御できます。
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 構文を使用して、並べ替えの基準となるディメンションまたは measure を指定します。
sorts パラメータを省略すると、要素は Looker のデフォルトの並べ替え順を使用します。昇順ソートには接尾辞は必要ありませんが、降順ソートには desc 接尾辞が必要です。
次の例では、単一の並べ替えを定義しています。
- 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]
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 構文で指定します。たとえば、ユーザーが UI のフィルタ フィールドに日付を入力する必要がある Date というフィルタを作成できます。ユーザーが入力した値を 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
hidden_fields
hidden_fields パラメータは、クエリで使用されているがグラフで非表示になっているフィールドを示します。非表示のフィールドは、Explore のデータテーブル セクションに表示されます。
hidden_fields: [inventory_items.count, distribution_centers.id]
シリーズ パラメータ
color_application
color_application パラメータとそのサブパラメータ collection_id と palette_id を使用して、特定のカラー コレクションと Palette をダッシュボードの要素に適用できます。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 セクションに貼り付けます。
デフォルトでは、指定したパレットの最初の色が箱ひげ図の要素全体に適用されます。省略可能なサブパラメータ reverse は、パレットの最後の色にアプリケーションを切り替えます。
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
options:
reverse: true
スタイル パラメータ
show_view_names
show_view_names パラメータは、軸名や列名などのグラフラベルにビュー名を表示するかどうかを決定します。
show_view_names: true | false
## default value: true
X 軸のパラメータ
show_x_axis_label
このパラメータは、X 軸のラベルを表示するかどうかを決定します。
show_x_axis_label: true | false
## default value: true
x_axis_label
このパラメータは、X 軸のラベルを指定します。このパラメータは、show_x_axis_label が true に設定されている場合に使用できます。
x_axis_label: Order Date
show_x_axis_ticks
このパラメータは、X 軸に値ラベルを表示するかどうかを決定します。
show_x_axis_ticks: true | false
## default value: true
x_axis_gridlines
このパラメータは、X 軸からグリッド線を延長するかどうかを決定します。
x_axis_gridlines: true | false
## default value: false
x_axis_reversed
このパラメータは、X 軸の方向を設定します。x_axis_reversed が false に設定されている場合、値は左から右へと増加します。true に設定すると、値は左から右へと減少します。
x_axis_reversed: true | false
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 軸のパラメータ
show_y_axis_labels
このパラメータは、ラベルを Y 軸に表示するかどうかを決定します。
show_y_axis_labels: true | false
## default value: true
y_axis_labels
このパラメータは、y 軸のラベルを指定します。このパラメータは、show_y_axis_labels が true に設定されている場合に使用できます。
y_axis_labels: ['label']
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_min
このパラメータは、Y 軸の最小値を定義します。
y_axis_min: ['10']
## default value: true
y_axis_max
このパラメータは、Y 軸の最大値を定義します。
y_axis_max: ['100']
## default value: true
y_axis_tick_density
このパラメータを使用すると、y 軸の目盛りの密度を設定するオプションが有効になります。この機能を有効にするには、y_axis_tick_density を custom に設定し、y_axis_tick_density_custom パラメータを使用して密度を設定します。
y_axis_tick_density: default | custom
## default value: default
y_axis_tick_density_custom
このパラメータを使用すると、y_axis_tick_density が custom に設定されている場合に、Y 軸の目盛りの密度を設定できます。表示する目盛りの数を表す整数を受け取ります。
y_axis_tick_density_custom: 10
## default value: 5
y_axis_reversed
このパラメータは、Y 軸の方向を設定します。y_axis_reversed が false に設定されている場合、値は軸の上方向に向かって増加します。true に設定すると、値は軸に向かって減少します。
## y_axis_reversed: true | false
# default value: false
y_axis_value_format
このパラメータは、基になるディメンションまたはメジャーとは独立して、Y 軸の値の数値形式を指定します。このパラメータでは Excel 形式の書式設定を使用できます。形式が指定されていない場合、値は基になるディメンションまたはメジャーの形式で表示されます。
y_axis_value_format パラメータに指定する値は二重引用符で囲む必要があります。
y_axis_value_format: "*00#.00"
これらの形式を指定する方法については、こちらのドキュメントで Excel の完全ガイドをご覧ください。ただし、現時点では、Looker では日付の書式設定と色の書式設定はサポートされていません。
最も一般的な書式設定オプションを以下に示します。
| Value Format | 意味 |
|---|---|
# |
整数（123） |
*00# |
百の位までゼロパディングされた整数（001） |
0.## |
小数点以下 2 桁までの数字（1、1.2、または 1.23） |
0.00 |
小数点以下 2 桁の数字（1.23） |
*00#.00 |
百の位までゼロパディングされた整数と、小数点以下 2 桁の数字（01.23） |
#,### |
千区切りのコンマのある数字（1,234） |
#,##0.00 |
千区切りのコンマがあり、小数点以下 2 桁の数字（1,234.00） |
0.000,," M" |
小数点以下 3 桁の 100 万単位の数字（1.234 M）。100 万の区切りは自動的に行われます。 |
$# |
小数点以下 0 桁のドル（$123） |
$0.00 |
小数点以下 2 桁のドル（$123.00） |
$#,##0.00 |
千区切りのある数字と小数点以下 2 桁のドル（$1,234.00） |
#% |
小数点以下 0 桁のパーセント（1%）。100 による乗算を自動的に行います。 |
0.00% |
小数点以下 2 桁のパーセント（1.00%）。100 による乗算を自動的に行います。 |
0.00\% |
小数点以下 2 桁のパーセント（1.00%）。100 は自動的には乗算されません。 |
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