LookML ダッシュボードのファネル チャートのパラメータ

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

Looker UI で目標到達プロセス グラフを作成する方法については、目標到達プロセス グラフのオプションのドキュメント ページをご覧ください。

パラメータの定義

パラメータ名 説明
基本パラメータ
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 統合された結果のクエリを定義します。
hidden_fields クエリで使用するフィールドを指定しますが、グラフでは非表示にします。
軸パラメータ
leftAxisLabelVisible 左軸にラベルを適用するかどうかを指定します。
leftAxisLabel 左軸のラベルを指定します。
rightAxisLabelVisible 右軸にラベルを適用するかどうかを指定します。
rightAxisLabel 右軸のラベルを指定します
バーのパラメータ
color_application ダッシュボードの要素にカラーパレットを適用します。このパラメータには、サブパラメータ collection_id と palette_id があります。
smoothedBars ファネル チャートの各バーの外縁とその上下のバーをつなげるかどうかを指定します。
isStepped 21.16 で追加 ファネルグラフをステップ ファネル スタイルで表示するかどうかを指定します。
orientation ファネル チャートのデータを表の行または列から描画するかどうかを指定します。
labelScale チャートのバーの上側とチャートの外側の両方に配置されるラベルのサイズを指定します。
ラベル パラメータ
labelPosition グラフ上でデータラベルを表示する場所を指定します。
percentType 各バーにパーセント値を割り当てるかどうかを指定します。
percentPosition グラフ上でバーの割合が表示される場所を指定します。
valuePosition グラフ上でデータ値を表示する場所を指定します。
labelColorEnabled チャート内のラベルやパーセンテージにカスタムカラーを設定するかどうかを指定します。
labelColor ラベルとパーセンテージのカスタムカラーを指定します。

基本パラメータ

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 では、ユーザーが要素にマウスを合わせるとメモが表示されます。

クエリ パラメータ

type: looker_funnel の LookML ダッシュボードの要素を定義する場合は、少なくとも model と explore のクエリ パラメータの値を指定する必要があります。また、dimensions と measures のパラメータを使用して、少なくとも 1 つのディメンションと 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 パラメータは、要素のクエリの並べ替え動作を定義します。最初にメインの並べ替えフィールドをリストし、次にサブの並べ替えフィールドをリストします。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]

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 構文を使用して指定します。たとえば、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

merged_queries

merged_queries パラメータを使用すると、複数のクエリの結果を 1 つのダッシュボードの要素に結合できます。要素の merged_queries パラメータ内で各ソースクエリを定義し、join_fields サブパラメータを使用して結果をマージする方法を指定します。

次のサンプル LookML コードは、統合された結果type: looker_grid の要素を作成します。この例では、merged_queries パラメータを使用して、2 つの別々のクエリのデータを 1 つのテーブルグラフに結合するダッシュボードの要素を作成します。

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

この例では、ダッシュボードの要素は、ecommerce モデルの users Explore に基づく 2 つのソースクエリのデータを結合します。プライマリ クエリには users.state、users.count、users.city フィールドが含まれ、結果は users.count フィールドで並べ替えられます。2 番目のソースクエリには users.state フィールドと users.city フィールドが含まれ、結果は users.state フィールドで並べ替えられます。

join_field パラメータは、users.state フィールドと users.city フィールドの一致する値に基づいてソースクエリを結合します。

listen パラメータは、両方のクエリに State フィルタを適用します。これにより、ダッシュボードの閲覧者は、特定の州を選択して、ダッシュボード タイルに表示されるクエリ結果を絞り込むことができます。

例: 会社データの統合

2 つの異なる Explore（company_info と companies）から企業に関する情報を結合するマージされたクエリを作成するとします。各 Explore の ipo.stock_symbol、companies.name、companies.contact_email フィールドでクエリを結合して、会社名、会社の連絡先メールアドレス、IPO 年、銘柄コード、従業員数、求人数を返すクエリを作成します。LookML で統合クエリ要素を次のように定義できます。

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

マージされたクエリ要素にフィルタを適用する

統合クエリ要素の前の例では、filters パラメータを使用して、各ソースクエリ内でハードコードされたフィルタを直接適用する方法を示しています。たとえば、プライマリ クエリのフィルタ companies.contact_email: "-NULL" と ipo.valuation_amount: NOT NULL は、有効な連絡先メールアドレスと評価額を持つ企業に結果を制限します。これらのクエリレベルのフィルタは、クエリをマージする前にデータを事前フィルタリングします。ユーザーが変更することはできません。

各ソースクエリの定義内で listen パラメータを使用して、統合クエリ要素にダッシュボード フィルタを適用することもできます。たとえば、LookML ダッシュボードの filters パラメータを使用して、ダッシュボード レベルで定義した Industry という名前のダッシュボード フィルタがあるとします。

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

両方のソースクエリの companies.industry フィールドに Industry フィルタを適用するには、次のように、統合クエリの各ソースクエリ定義に listen パラメータを追加します。

listen:
  Industry: companies.industry

たとえば、次のサンプルコードでは、前の例の統合された結果要素のソースクエリの両方に Industry フィルタを追加しています。

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

この追加により、ユーザーが Industry ダッシュボード フィルタを操作すると、統合クエリ要素内の対応するソースクエリがそれに応じてフィルタされます。

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

軸パラメータ

このセクションで説明するパラメータのほとんどは、目標到達プロセス グラフのビジュアリゼーション エディタの [軸] セクションのオプションに対応しています。

leftAxisLabelVisible

このパラメータは、左軸にラベルを適用するかどうかを決定します。


leftAxisLabelVisible: true | false

leftAxisLabel

左軸のラベルを指定します。leftAxisLabelVisible パラメータは true に設定する必要があります。


leftAxisLabel: Year

rightAxisLabelVisible

このパラメータは、右軸にラベルを適用するかどうかを決定します。


rightAxisLabelVisible: true | false

rightAxisLabel

右軸のラベルを指定します。rightAxisLabelVisible パラメータは true に設定する必要があります。


rightAxisLabel: Count

バーのパラメータ

このセクションで説明するパラメータのほとんどは、ファネルグラフのビジュアリゼーション エディタの [棒] セクションのオプションに対応しています。

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

smoothedBars

ファネル チャートの各バーの外縁とその上下のバーをつなげるかどうかを指定します。


smoothedBars: true | false

isStepped

ファネル チャートをステップ ファネル スタイルで表示するかどうかを指定します。


isStepped: true | false

orientation

orientation パラメータは、ファネルグラフのデータを表の行または列から描画するかどうかを指定します。orientation を automatic に設定することもできます。これにより、ファネル チャートでは、データポイントが最も多い場所に基づいてデータが選択されます。


orientation: automatic | rows | columns

labelScale

チャートのバーの上側とチャートの外側の両方に配置されるラベルのサイズを指定します。ラベルには最小サイズと最大サイズがあり、チャートのサイズによって異なります。labelScale を '0' に設定すると、ラベルが最小サイズに指定されます。labelScale を '1' に設定すると、ラベルが最大サイズに指定されます。0～1 の範囲で数値を割合で入力すると、ラベルサイズは、最小サイズから最大サイズまでの割合で設定されます。


labelScale: '0.5'

ラベル パラメータ

このセクションで説明するパラメータのほとんどは、ファネルグラフのビジュアリゼーション エディタの [ラベル] セクションのオプションに対応しています。

labelPosition

グラフ上でデータラベルを表示する場所を指定します。labelPosition パラメータには、次の値を指定できます。

  • left: データラベルがチャートの左側に表示されます。
  • inline: データラベルがチャートの中央（チャートのバー内）にあります。
  • right: データラベルがチャートの右側に表示されます。
  • hidden: データラベルは表示されません。

labelPosition: left | inline | right | hidden

percentType

チャートの各バーにパーセント値を割り当てるかどうかを指定します。percentType パラメータは、バーの値をチャート内の最大値と比較するか（total）、バーの値をチャートの前のバーと比較して（prior）、パーセンテージを割り当てるかどうかを設定します。


percentType: total | prior

percentPosition

グラフ上でバーの割合が表示される場所を指定します。percentPosition パラメータには、次の値を指定できます。

  • left: パーセンテージがチャートの左側に表示されます。
  • inline: パーセンテージのラベルがチャートの中央（チャートのバー内）に表示されます。
  • right: パーセンテージのラベルがチャートの右側に表示されます。
  • hidden: 割合のラベルは表示されません。

valuePosition

グラフ上でデータの値を表示する場所を指定します。valuePosition パラメータには、次の値を指定できます。

  • left: データ値がグラフの左側に表示されます。
  • inline: データ値がチャートの中央（チャートのバー内）に表示されます。
  • right: データ値がチャートの右側に表示されます。
  • Hidden: データ値は表示されません。

labelColorEnabled

labelColorEnabled パラメータを使用すると、グラフ内のラベルやパーセンテージにカスタムカラーを設定できます。


labelColorEnabled: true | false

labelColor

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


labelColor: "#4FBC89"