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 パラメータで参照されることがあります。

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

クエリ パラメータ

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 接尾辞が必要です。

次の例では、単一の並べ替えを定義しています。

- 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 構文で指定します。たとえば、ユーザーが 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 ダッシュボード フィルタを操作すると、結合されたクエリ要素内の対応するソースクエリがそれに応じてフィルタされます。

ヒント: 各ソースクエリは 1 つ以上のダッシュボード フィルタをリッスンできます。これにより、統合された結果要素のソースクエリの数に関係なく、ソースクエリごとにフィルタ ロジックを個別に定義できます。クエリに listen パラメータがない場合、ダッシュボード フィルタの影響を受けません。

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"