LookML ダッシュボードのボックス プロット図パラメータ

このページでは、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 パラメータで参照されることがあります。また、要素をタイルグループ（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 のクエリ パラメータの値を指定する必要があります。

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 構文を使用して、並べ替えの基準となるディメンションまたはメジャーを指定します。

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]

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

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

シリーズ パラメータ

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

デフォルトでは、指定したパレットの最初の色が箱ひげ図要素全体に適用されます。オプションのサブパラメータ 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