LookML ダッシュボードの散布図パラメータ

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

Looker UI を使用して散布図を作成する方法については、散布図のオプションのドキュメント ページをご覧ください。

使用例


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_scatter
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
stacking: normal | percent | ''
show_null_points: true | false
swap_axes: true | false
cluster_points: true | false
hide_legend: true | false
legend_position: center | left | right
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'
quadrants_enabled: true | false
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'
custom_quadrant_point_x: 3
custom_quadrant_point_y: 6
custom_quadrant_value_x: 55
custom_quadrant_value_y: 40

## SERIES PARAMETERS
colors: [css_color, css_color, …]
show_view_names: true | false
point_style: none | circle | circle_outline
size_by_field: view_name.field_name
plot_size_by_field: true | false
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
  series_name: column | line | area | scatter
  # Possibly more series visualization assignments
series_point_styles:
  series_name: square | diamond | triangle | triangle-down | auto

## VALUE PARAMETERS
show_value_labels: true | false
custom_value_label_column: default | series_name
label_color: [css_color, css_color, …]
font_size: Npx
label_value_format: 'value formatting string'
hidden_series: [series_name, series_name, …]

## X-AXIS PARAMETERS
x_axis_scale: auto | linear | ordinal | time
x_axis_reversed: true | false
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_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
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 を定義します
dimensions 要素のクエリに使用するディメンションを定義します
measures 要素のクエリに使用する指標を定義します
sorts 要素のクエリに使用する並べ替えを定義します
pivots 要素のクエリに使用するためにピボットするディメンションを定義します
limit 要素のクエリに使用する行制限を定義します
filters（要素の場合） 要素のクエリで変更できないフィルタを定義します。
listen filters（ダッシュボード用）が作成されている場合、要素のクエリで変更できるフィルタを定義します
query_timezone クエリの実行時に使用するタイムゾーンを定義します。
merged_queries 統合された結果のクエリを定義します
プロット パラメータ
stacking 系列を積み重ねて積み重ねグラフを作成します
show_null_points null 値を持つポイントをプロットするかどうかを指定します
swap_axes グラフの X 軸と Y 軸を反転する
cluster_points 多数のデータ値をクラスタにグループ化する
hide_legend グラフの凡例を非表示にします
legend_position 凡例をグラフの左、中央、右のいずれに表示するかを指定します
hidden_fields クエリで使用するがグラフには表示しないフィールドを指定します
limit_displayed_rows 結果の位置に基づいてビジュアリゼーションの行を表示または非表示にする
limit_displayed_rows_values ビジュアライゼーションで表示または非表示にする行を指定します。このパラメータには、show_hide、first_last、num_rows のサブパラメータがあります。
quadrants_enabled type: looker_scatter のダッシュボード要素に四分円の線を追加します
custom_quadrant_point_x 垂直象限線の位置を定義します
custom_quadrant_point_y 水平象限線の位置を定義します
custom_quadrant_value_x X 軸の値に基づいて垂直象限線の位置を定義します
custom_quadrant_value_y Y 軸の値に基づいて水平の四分円線の位置を定義します
シリーズ パラメータ
colors 系列の表示順序に基づいてグラフの系列の色を設定する
show_view_names グラフのラベルからビュー名を非表示にします
point_style データポイントの表示方法を指定します
size_by_field グラフのすべてのポイントを特定のフィールドでサイズ設定します
plot_size_by_field ポイントのサイズ設定に使用されるフィールドを個別にプロットするかどうかを設定します
series_colors 系列の名前に基づいてグラフの系列の色を設定します
series_labels ユーザーに表示される系列名を変更します
series_types 各系列のタイプを定義して、ビジュアリゼーション タイプを混在させる
series_point_styles グラフのポイントの形状を指定します
値パラメータ
show_value_labels データポイントの横にラベルを表示する
custom_value_label_column show_value_labels が true に設定されている場合に、データポイントの値ラベルとして使用されるフィールドを設定します。
label_color 色の値のカンマ区切りのリストを指定します
font_size 値ラベルのフォントサイズを設定します
label_value_format 値ラベルの Excel 形式の書式設定を指定します
hidden_series 要素の読み込み時にグラフの系列を非表示にします
X 軸のパラメータ
x_axis_scale X 軸の目盛りの計算方法を指定します
x_axis_reversed X 軸の方向を指定します
show_x_axis_label X 軸のラベルを非表示にします
x_axis_label カスタムの x 軸ラベルを定義します
show_x_axis_ticks X 軸の目盛りを表示します
x_axis_gridlines X 軸からグリッド線を延長する
x_axis_label_rotation X 軸のラベルを回転させる角度
x_axis_datetime_label X 軸のラベルが日付の場合の形式文字列を定義します。
x_axis_zoom X 軸に沿ったズームを許可するかどうかを指定します
Y 軸のパラメータ
y_axis_gridlines Y 軸からグリッド線を延長する
y_axis_reversed X 軸の方向を設定します
reference_lines グラフに基準線を追加します
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 クエリ パラメータの値を指定する必要があります。また、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 パラメータは、要素クエリに使用する並べ替えを定義します。最初の並べ替えが最初に表示され、次に 2 番目の並べ替えが表示されます。ディメンションまたは指標を指定するには、構文 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]

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 構文を使用して、フィルタの名前、コロン、フィルタを適用するフィールドへの参照を指定します。たとえば、ユーザーが UI のフィルタ フィールドに日付を入力する必要がある [日付] というフィルタを作成できます。ユーザーが入力した値を orders_by_date 要素に適用するには、次のようにします。

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

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）の会社に関する情報を結合するマージされたクエリを作成するとします。各探索の 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 ダッシュボード フィルタを操作すると、結合されたクエリ要素内の対応するソースクエリがフィルタされます。

プロット パラメータ

このセクションで説明するパラメータのほとんどは、散布図のビジュアリゼーション エディタの [プロット] セクションのオプションに対応しています。

stacking

stacking パラメータは、グラフで系列をクラスタ化する方法を指定します。

  • normal: 通常の積み上げ縦棒グラフのように、棒、線、ポイントを積み重ねます。

  • percent: グラフの塗りつぶしが合計 100% になるようにバー、線、ポイントを積み重ね、Y 軸の値をパーセンテージに設定します。

  • '': 棒、線、ポイントは積み上げられず、グループ化されます。

stacking: normal | percent | ''

## default value: ''

show_null_points

show_null_points パラメータは、null 値を持つ点をプロットするかどうかを決定します。true に設定すると、null 値は y 軸のゼロにプロットされます。false に設定すると、null 値はプロットされず、グラフには null 値の前後にあるポイントを結ぶ直線が描画されます。グラフで null 値を空白で表示する場合は、discontinuous_nulls: true を検討してください。

show_null_points: true | false

## default value: true

swap_axes

X 軸と Y 軸を通常の構成から入れ替えます。軸を入れ替えると、ディメンションは Y 軸にプロットされ、メジャーは X 軸にプロットされます。

swap_axes: true | false

## default value: false

cluster_points

cluster_points パラメータが true に設定されている場合、Looker は 密にクラスタ化されたデータポイントをデータ値のブロックにグループ化します。クラスタ上の数値は、クラスタに含まれているデータポイントの数を示しています。散布図のビジュアリゼーションを表示しているときに、特定のデータ クラスタを選択して、そのクラスタに含まれる個々のデータポイントを表示できます。


cluster_points: true | false

hide_legend

この宣言により、ビジュアリゼーションの凡例が非表示になります。

hide_legend: true | false

## default value: false

legend_position

hide_legend が false に設定されている場合（系列が複数ある場合）、legend_position パラメータを使用して、系列の凡例をグラフの左、中央、右のいずれに表示するかを指定できます。

legend_position: center | left | right

## default value: 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 行をビジュアリゼーションで表示または非表示にします。

quadrants_enabled

quadrants_enabled パラメータを使用すると、type: looker_scatter のダッシュボード要素に四分円線を追加できます。

custom_quadrant_point_x パラメータと custom_quadrant_point_y パラメータ、または custom_quadrant_value_x パラメータと custom_quadrant_value_y パラメータを使用して、垂直方向と水平方向の象限線の位置を定義できます。また、quadrant_properties パラメータを使用して、各象限の背景色とラベルをカスタマイズできます。


quadrants_enabled: true
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'

custom_quadrant_point_x

custom_quadrant_point_x パラメータを使用して、垂直象限線の位置を定義できます。custom_quadrant_point_x パラメータを 1～9 の値に設定します。デフォルト値は 5 で、ビジュアリゼーションの中央に線が配置されます。


custom_quadrant_point_x: 6

custom_quadrant_point_y

custom_quadrant_point_y パラメータを使用して、水平象限線の位置を定義できます。custom_quadrant_point_y パラメータを 1～9 の値に設定します。デフォルト値は 5 で、ビジュアリゼーションの中央に線が配置されます。


custom_quadrant_point_y: 2

custom_quadrant_value_x

custom_quadrant_value_x パラメータを使用すると、垂直象限線をビジュアリゼーションの X 軸上の特定の数値の位置に設定できます。custom_quadrant_value_x の値を指定すると、custom_quadrant_point_x パラメータに指定された値がオーバーライドされます。


custom_quadrant_value_x: 55

custom_quadrant_value_y

custom_quadrant_value_y パラメータを使用すると、垂直象限線をビジュアリゼーションの Y 軸上の特定の数値の位置に設定できます。custom_quadrant_value_y の値を指定すると、custom_quadrant_point_y パラメータに指定された値がオーバーライドされます。


custom_quadrant_value_y: 40

quadrant_properties

quadrants_enabled パラメータが true に設定されている場合は、quadrants_properties パラメータを使用して、4 つの象限それぞれにカスタムラベルと背景色を定義できます。quadrant_properties パラメータを使用して各象限のカスタムの色またはラベルを定義するには、color パラメータと label パラメータを各象限の適切な数値とともに使用します。

  • '0': 第 1 象限
  • '1': 第 2 象限
  • '2': 第 3 象限
  • '3': 第 4 象限

たとえば、次の LookML では、第 1 象限の色を 16 進コード #EDEDED に設定し、ユーザーに表示されるラベルを「第 1 象限」に変更しています。

quadrant_properties:
  '0':
    color: '#EDEDED'
    label: 'First Quadrant'

系列パラメータ

このセクションで説明するパラメータは、散布図の可視化エディタの [シリーズ] セクションのオプションに対応しています。

colors

colors パラメータは、系列の色のリストを指定します。リストの最初の色は、最初のデータ系列に対応しています。表示されている色よりも多くの系列がある場合、色は先頭から繰り返されます。


colors: [blue, orange, yellow, red, purple]

色を指定するすべてのグラフ属性で、色の値として #2ca6cd などの 16 進数文字列、または mediumblue などの CSS 指定のカラー文字列を使用できます。

show_view_names

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

show_view_names: true | false

## default value: true

point_style

point_style パラメータは、データポイントの表示方法を指定します。次のオプションが用意されています。

  • none: 折れ線グラフと面グラフの場合。ポイントが表示されない。
  • circle: 塗りつぶされた円が表示されます。
  • circle_outline: 枠線付きの円が表示されます。

size_by_field

size_by_field にフィールドを指定すると、グラフのすべてのポイントが選択したフィールドでサイズ設定されます。plot_size_by_field が true に設定されていない限り、そのフィールドはグラフに個別にプロットされなくなります。ポイントがフィールドによってサイズ設定されると、ポイントがサイズ設定されるフィールドを示すキーが凡例に表示されます。

データテーブルにピボットが含まれ、ピボットの範囲外である測定値も含まれている場合、size_by_field パラメータは使用できません。たとえば、pivot_index 関数を使用するテーブル計算がテーブルに含まれている場合、size_by_field は使用できません。


size_by_field: order_items.id

plot_size_by_field

plot_size_by_field パラメータは、size_by_field にフィールドが指定されている場合に使用できます。このパラメータは、ポイントのサイズ設定に使用するフィールドを個別にプロットするかどうかを指定します。デフォルト設定は false で、フィールドがプロットされないことを意味します。このパラメータを true に設定すると、フィールドを表す追加のポイントがグラフに表示されます。

series_colors

name: value ペアを使用して、系列名に基づいて系列の色を設定します。

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

series_colors:
  'Yes': skyblue
  'No': '#000000'

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

series_colors:
  inventory_items.count: crimson
  orders.count: green

系列名が series_colors にリストされていない場合、グラフはデフォルトで colors で指定された色のリストになります。colors が設定されていない場合、グラフはデフォルトの配色にフォールバックします。

series_labels

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

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

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

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

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

series_types

series_type パラメータを使用すると、同じ可視化でさまざまな直交座標グラフ タイプを使用できます。このパラメータを使用して、変更する各系列にグラフの種類を割り当てます。型オプションは line、column、bar、area、scatter です。

series_types:
  series_a_name: column
  series_b_name: line

すべての系列は、最初に選択したグラフの種類にデフォルト設定されます。その後、個々の系列を変更できます。

series_point_styles

線、面、散布グラフの系列タイプについて、グラフの点の形状を指定します。series_point_styles は、square、diamond、triangle、triangle-down、auto のいずれかに設定できます。


series_point_styles:
  users.count: triangle

値パラメータ

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

show_value_labels

棒グラフ、折れ線グラフ、ポイントの値をデータポイントの横に表示します。

show_value_labels: true | false

## default value: false

custom_value_label_column

show_value_labels パラメータが true に設定されている場合、custom_value_label_column パラメータが有効になります。

custom_value_label_column パラメータを使用して、グラフの値ラベルとして使用するディメンションをカスタマイズします。view_name.field_name 形式を使用してディメンションを割り当てます。

custom_value_label_column: default | products.category

このパラメータが設定されていない場合、値ラベルのデフォルト値はプロットされる指標です。

詳細と例については、散布図のオプションのドキュメント ページをご覧ください。

labelColor

labelColorEnabled が true に設定されている場合は、labelColor パラメータを使用してラベルとパーセンテージのカスタム色を指定します。labelPosition が inline に設定されているラベルは選択した色で表示され、グラフの両脇にあるラベルは選択した色より約 40% 暗く表示されます。


labelColor: "#4FBC89"

font_size

10px や 12px などの有効な CSS サイズを使用して、値ラベルのフォントサイズを設定します。


font_size: 14px

label_value_format

label_value_format パラメータは、基になるディメンションまたはメジャーに適用された形式とは無関係に、値に適用する形式を指定します。このフィールドでは Excel 形式の書式設定を使用できます。label_value_format が指定されていない場合、値は基になるディメンションまたはメジャーの形式で表示されます。

これらの形式を指定する方法については、数値フィールドにカスタム フォーマットを追加するをご覧ください。ただし、Looker では色の書式設定はサポートされていません。

label_value_format LookML ダッシュボード パラメータで使用される形式は、value_format LookML パラメータで使用される形式と同じですが、value_format LookML パラメータでは、書式設定する文字列を二重引用符で囲む必要があります。


label_value_format: '0.00'

hidden_series

hidden_series パラメータは、グラフで無効にする系列を指定します。つまり、系列はグラフの凡例に表示されますが、グレー表示になります。グラフの凡例で無効にした系列をクリックすると、その系列を有効にできます。そのため、hidden_series は hide_legend: true で意図したとおりに動作しない可能性があります。

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

hidden_series: ['Yes', 'No']

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

hidden_series: [inventory_items.count, orders.count]

show_silhouette パラメータと組み合わせて使用すると、無効な系列をグラフ自体に薄い影で表示するかどうかを指定できます。

X 軸のパラメータ

このセクションで説明するパラメータは、散布図のビジュアリゼーション エディタの Xのオプションに対応しています。

x_axis_scale

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

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

## default value: auto

x_axis_reversed

このパラメータは、X 軸の方向を設定します。x_axis_reversed が false に設定されている場合、値は左から右へと増加します。true に設定すると、値は左から右へと減少します。


x_axis_reversed: true | false

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_label_rotation

x_axis_label_rotation パラメータは、X 軸ラベルの回転を度単位で定義します。このパラメータに -360～360 の値を設定することで、ラベルを回転させる度数を指定します。

x_axis_label_rotation: -45

x_axis_datetime_label

このパラメータは、X 軸のラベルが日付の場合の形式文字列を指定します。x_axis_scale が time に設定されていない場合、何も行いません。


x_axis_datetime_label: '%b %d'

時間の書式設定については、グラフの時間形式のドキュメント ページをご覧ください。

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 軸の同等のビジュアリゼーション メニュー オプションをご確認ください。

このセクションで説明するパラメータは、散布図のビジュアリゼーション エディタの Y セクションのオプションに対応しています。

y_axis_gridlines

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

y_axis_gridlines: true | false

## default value: true

y_axis_reversed

このパラメータは、Y 軸の方向を設定します。y_axis_reversed が false に設定されている場合、値は軸の上方向に向かって増加します。true に設定すると、値は軸に向かって減少します。


## y_axis_reversed: true | false

# default value: false

reference_lines

このパラメータは、基準線と領域を指定するための値の配列を指定します。

基準線の設定については、ダッシュボードの基準線パラメータのドキュメント ページをご覧ください。


reference_lines:
   # reference line options

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