LookML ダッシュボード パラメータ

ダッシュボードは次のいずれかの方法で作成できます。ユーザー定義のダッシュボードは Looker UI を使用して作成され、ユーザー定義のダッシュボードの作成に関するドキュメント ページで説明されています。ダッシュボードは LookML を使用して作成することもでき、このページで説明するように全体的な設定を変更することもできます。

このページでは、ダッシュボード全体に影響する LookML ダッシュボード パラメータについて説明します。

LookML ダッシュボードには、ダッシュボード上のデータの可視化、テキストタイル、ボタンである要素も含まれています。個々の要素タイプのリファレンス ページへのリンクについては、ダッシュボードの要素パラメータのページをご覧ください。

使用例

- dashboard: dashboard_name
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  enabled_dashboard_agents: true | false
  default_dashboard_agent: agent_name
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    vis_filter: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations
  tab_name:
  # Optional - for organizing elements onto tabs. Must be declared for each element individually.

パラメータの定義

パラメータ名 説明
dashboard ダッシュボードを作成します。
title（ダッシュボード用） ユーザーに表示されるダッシュボード名の形式を変更します。
description（ダッシュボード用） ダッシュボードの詳細パネルまたはリスト表示に設定されたフォルダで表示できる説明を追加します。
enable_viz_full_screen ダッシュボードの閲覧者がダッシュボード タイルを全画面表示と拡張表示で表示できるかどうかを定義します。
enabled_dashboard_agents [プレビュー] ダッシュボード閲覧者がダッシュボード エージェントを使用して LookML ダッシュボードとチャットできるかどうかを定義します。
default_dashboard_agent [プレビュー] ダッシュボードの会話型クエリに使用するデフォルトのダッシュボード エージェントを指定します。
extends 別の LookML ダッシュボードに基づいて LookML ダッシュボードを作成します。
extension ダッシュボードが別のダッシュボードによって拡張されることを必須とします。
layout ダッシュボードで要素を配置する方法を定義します。
tabs 追加日: 26.4 ダッシュボードのタブを追加して、ダッシュボードの要素を整理します。要素がどのタブに表示されるかを指定する要素の tab_name パラメータと併用する必要があります。
rows layout: grid ダッシュボードの各行に含める要素を定義するために、LookML セクションを開始します。
elements（行の場合） layout: grid ダッシュボードの行に含める要素を定義します。
height（行の場合） layout: grid ダッシュボードの行の高さを定義します。
tile_size layout: tile ダッシュボードのタイルのサイズを定義します。
width（ダッシュボード用） layout: static ダッシュボードのダッシュボードの幅を定義します。
refresh（ダッシュボード用） ダッシュボード要素が自動的に更新される間隔を設定します。
auto_run ダッシュボードを最初に開いたり再読み込みしたりする際に、自動的に実行されるようにするかを指定します。
フィルタパラメーター
crossfilter_enabled ダッシュボードのクロス フィルタリングを有効または無効にします。
filters_bar_collapsed ダッシュボードのフィルタバーを、デフォルトで折りたたむか展開するかを設定します。
filters_location_top ダッシュボードのダッシュボード フィルタバーの位置を上または右に設定します。
filters（ダッシュボード用） ダッシュボード フィルタを定義するために、LookML セクションを開始します。
name（フィルタの場合） フィルタを作成] をクリックします。
title（フィルタの場合） ユーザーに表示されるフィルタ名を変更します。
type（フィルタの場合） 使用するフィルタの種類を決定します。
default_value フィルタのデフォルト値を設定します。
allow_multiple_values ユーザーが 1 つのフィルタ値しか選択できないようにします。
required ダッシュボードを実行するためにフィルタ値を入力するようユーザーに要求します。
ui_config ユーザーが LookML ダッシュボードを表示するときに使用できるフィルタ コントロールを構成します。type、display、options のサブパラメータがあります。
model（フィルタの場合） （省略可）type: field_filter フィルタの基盤となるフィールドを含むモデルを指定します。
explore（フィルタの場合） type: field_filter フィルタの基盤となるフィールドを含む Explore を指定します。
field type: field_filter フィルタの基になるフィールドを指定します。
listens_to_filters ユーザーが type: field_filter の別のダッシュボード フィルタに入力した内容に基づいて、field_filter のダッシュボード フィルタの候補を絞り込みます。
vis_filter ダッシュボードのフィルタバーではなく、ビジュアリゼーション タイルに直接表示されるようにフィルタを設定します。
埋め込みダッシュボードのパラメータ
embed_style 埋め込みダッシュボードのカスタマイズを定義するために、LookML セクションを開始します。
background_color 埋め込みダッシュボードの背景色を設定します。
show_title 埋め込みダッシュボードにダッシュボードのタイトルを表示するかどうかを指定します。
title_color 埋め込みダッシュボードのタイトルの色を設定します。
show_filters_bar 埋め込みダッシュボードにフィルタバーを表示するかどうかを指定します。
tile_background_color 埋め込みダッシュボードのタイルの背景色を設定します。
tile_text_color 埋め込みダッシュボードのタイルのテキストの色を設定します。
要素パラメータ
elements（ダッシュボード用） ダッシュボード要素を定義するために、LookML セクションを開始します。

dashboard

dashboard パラメータは、新しいダッシュボードを宣言し、ダッシュボードの名前を指定します。最大文字数は 255 文字です。使用できる文字は、英字（A ～ Z）、数字（0 ～ 9）、ダッシュ（-）、アンダースコア（_）です。通常は、各 LookML ダッシュボードを独自の LookML ファイルに配置することをおすすめしますが、1 つのファイルで複数のダッシュボードを宣言することもできます。

- dashboard: sales_overview

ダッシュボードに何かを表示するには、elements パラメータを使用して少なくとも 1 つの要素を追加する必要があります。

preferred_viewer（非推奨）

Looker 23.6 でレガシー ダッシュボードが非推奨になる前は、preferred_viewer パラメータを使用すると、ダッシュボードの表示とダウンロードの形式を Looker のデフォルトのダッシュボード エクスペリエンスまたはレガシー ダッシュボードとして選択できました。

title （ダッシュボード用）

title パラメータを使用すると、フォルダとダッシュボードの上部にユーザーに表示されるダッシュボード名の表示方法を変更できます。指定しない場合、タイトルはデフォルトでダッシュボードの名前に設定されます。タイトル テキストはローカライズできます。

次の例を考えてみましょう。

- dashboard: sales_overview
  title: "1) Sales Overview"

この場合、ダッシュボードは [売上概要] ではなく [1) 売上概要] と表示されます。

description （ダッシュボード用）

description パラメータを使用すると、LookML ダッシュボードに説明を追加できます。

description パラメータの内容は、LookML ダッシュボードの [ダッシュボードの詳細] パネルの [説明] フィールドに表示されます。

説明は、リスト表示に設定されたフォルダで表示されるダッシュボードのリストで、ダッシュボードのタイトルの下に表示されます。説明が指定されていない場合、リストにはダッシュボードのタイトルのみが表示されます。

説明テキストはローカライズできます。

enable_viz_full_screen

このパラメータは、Looker 管理者が 全画面表示の設定を有効にした場合にのみ有効になります。[全画面表示] 設定はデフォルトで有効になっています。

enable_viz_full_screen パラメータを使用すると、ダッシュボードの閲覧者がダッシュボードのタイルを全画面表示と拡張表示で表示できるかどうかを設定できます。これは、ダッシュボードの [ビジュアリゼーションの全画面モードを許可する] 設定と同じです。

このパラメータには、true（全画面表示と拡張表示が利用可能）と false（全画面表示と拡張表示が利用不可）の値を指定できます。デフォルト値は true です。

enabled_dashboard_agents

enabled_dashboard_agents パラメータを使用すると、ダッシュボード閲覧者がダッシュボード エージェントを使用して LookML ダッシュボードとチャットできるかどうかを制御できます。

このパラメータは、Gemini in Looker の管理ページで Looker インスタンスの [会話型分析] 設定が有効になっている場合にのみ有効になります。

このパラメータには、true（チャット有効）と false（チャット無効）を指定できます。このパラメータが LookML ダッシュボード ファイルから省略されている場合、API レイヤではデフォルトで true になります。

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

default_dashboard_agent パラメータは、LookML ダッシュボードに関連付けるデフォルトのダッシュボード エージェントの名前を指定します。指定されたエージェントは、agent LookML パラメータを使用して宣言する必要があります。

閲覧者がダッシュボードで会話を開始すると、デフォルトのエージェントの設定（思考モードやデバッグ情報の表示など）が会話に適用されます。

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

enabled_dashboard_agents が true で、default_dashboard_agent が指定されていない場合、ユーザーはカスタム手順なしでデフォルト設定を使用してダッシュボードとチャットできます。

extends

拡張機能によるコードの再利用のドキュメント ページで説明されているように、extends パラメータを使用すると、1 つの LookML ダッシュボードを別の LookML ダッシュボードに基づいて作成し、一部の設定を追加またはオーバーライドできます。extends パラメータには、別の LookML ダッシュボードの名前を指定します。

extension

拡張機能でのコードの再利用のドキュメント ページで説明されているように、extension パラメータは、ダッシュボードが別のダッシュボードによって拡張されることを必須とします。このダッシュボードは他のユーザーには表示されませんが、他のユーザーに表示される他のダッシュボードを作成するためのテンプレートとして使用できます。extension パラメータは値 required のみを受け入れます。extension パラメータが含まれていない場合、ダッシュボードに拡張機能は必要ありません。

layout

layout パラメータは、Looker がダッシュボード要素を配置する際に使用するレイアウト方法を設定します。次の値を使用できます。

tabs

ダッシュボードの要素を整理するためのタブを追加しました。tabs は、ダッシュボードに表示されるタブの数、名前、ラベルを定義します。要素は、tab_name パラメータを使用してダッシュボードのタブに整理されます。

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4

tab_name

要素が表示されるダッシュボードのタブを指定します。tab_name は個々の要素ごとに指定する必要があります。

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

rows

layout: grid ダッシュボードの場合、rows パラメータは、どの要素をどの行に配置するか、各行の高さを定義する LookML のセクションを開始します。各行内では、各要素の幅は同じです。このセクションに要素を記載しないと、ダッシュボードに表示されません。

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

elements パラメータは、ダッシュボードの要素名のカンマ区切りリストを受け取ります。elements 宣言ごとに、ダッシュボードに新しい行が作成されます。行に配置された要素はすべて同じ幅になります。そのため、2 つの要素を 1 行に配置すると、それぞれが利用可能なスペースの 50% を占有します。4 つの要素を 1 つの行に配置すると、それぞれが使用可能なスペースの 25% を占有します。

height

height パラメータは、行の高さをピクセル単位で定義します。デフォルト値は 300 です。

tile_size

layout: tile ダッシュボードと layout: static ダッシュボードでは、要素のサイズと位置の指定に使用される単位はタイルサイズです。tile_size はピクセル単位で定義します。デフォルト値は 160 です。次に例を示します。

- dashboard: sales_overview
  layout: tile
  tile_size: 100

この場合、height: 5 と width: 3 を含むダッシュボードの要素は、高さ 500 ピクセル、幅 300 ピクセルになります。height パラメータと width パラメータはすべての要素タイプに適用され、その使用に関する詳細は、個々の可視化タイプのドキュメント ページに表示されます。height と width の動作の典型的な例については、LookML ダッシュボードの縦棒グラフ パラメータのドキュメント ページをご覧ください。

width

layout: static ダッシュボードの場合、width パラメータは、使用する予定のダッシュボードの合計幅をピクセル単位で定義します。要素が大きすぎる場合や、行に要素が多すぎる場合、width パラメータはダッシュボードのサイズを制限しません。width 設定は、ダッシュボードを画面の中央に配置するのに役立ちます。幅を設定しない場合、デフォルトは 1, 200 です。

- dashboard: sales_overview
  layout: static
  width: 800

refresh

refresh パラメータを使用すると、ダッシュボードを定期的に自動的に再読み込みして、新しいデータを取得できます。これは、オフィスのテレビなど、ダッシュボードが常に表示されている設定で役立ちます。このパラメータを有効にするには、ダッシュボードがブラウザ ウィンドウで開いている必要があります。この設定は、ダッシュボードのキャッシュを「事前準備」するためにバックグラウンドで実行されません。

更新頻度は、秒、分、時間、日の任意の数（小数なし）で指定できます。次に例を示します。

- dashboard: sales_overview
  refresh: 2 hours

更新間隔を短く設定する場合は注意してください。ダッシュボードには多くのクエリを含めることができ、その一部はリソースを大量に消費する可能性があるため、特定のダッシュボードがデータベースに負荷をかけることがあります。

auto_run

auto_run パラメータは、ダッシュボードを最初に開いたときや再読み込みしたときに実行するかどうかを決定します。デフォルト値は true です。このパラメータを false に設定すると、ユーザーは [実行] ボタンを押してダッシュボードを読み込む必要があります。たとえば、次のようなダッシュボードは、開くと自動的に実行されます。

- dashboard: sales_overview
  auto_run: true

auto_run の設定に関係なく、ユーザーはフィルタ値を変更した後、必ず [実行] ボタンをクリックする必要があります。これにより、ユーザーがフィルタの変更中に一時停止した場合や、複数のフィルタを同時に変更したい場合に、不要な再読み込みを防ぐことができます。

crossfilter_enabled

crossfilter_enabled パラメータを使用すると、ダッシュボードのクロスフィルタをオンまたはオフにできます。このパラメータが true に設定されている場合、ダッシュボードの閲覧者は特定のデータポイントをクリックして、ダッシュボードにクロスフィルタを作成できます。

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

filters_bar_collapsed パラメータを使用すると、ダッシュボードのフィルタバーをデフォルトで折りたたむか展開するかを設定できます。このパラメータを true に設定すると、フィルタバーはデフォルトで折りたたまれます。ダッシュボードの閲覧者は、フィルタ アイコンをクリックすることでフィルタバーを開くことができます。この設定のデフォルトは false です。

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

filters_location_top パラメータを使用すると、ダッシュボードのフィルタバーをダッシュボードの上部または右側に配置できます。このパラメータを true に設定すると、フィルタバーがダッシュボードの上部に表示されます。false に設定すると、フィルタバーがダッシュボードの右側に表示されます。この設定のデフォルトは true です。

- dashboard: sales_data
  filters_location_top: false

filters

filters パラメータは、ダッシュボード フィルタを定義する LookML のセクションを開始します。フィルタはダッシュボードの上部に表示され、ユーザーはダッシュボード要素の基になるデータを変更できます。

フィルタが要素に影響を与えるには、listen パラメータを使用して、そのフィルタを「リッスン」するように要素を設定する必要があります。このパラメータは、type: text と type: button 以外のすべての要素タイプに適用されます。listen の動作の典型的な例については、LookML ダッシュボードの縦棒グラフ パラメータのドキュメント ページをご覧ください。

このようにフィルタを要素に適用する場合、フィルタタイプはフィルタをリッスンしているディメンションまたはメジャーのタイプと一致する必要があります（詳しくは、LookML ダッシュボードの作成をご覧ください）。

フィルタの形式は次のとおりです。

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  vis_filter: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

name 宣言ごとに新しいダッシュボード フィルタが作成され、名前が割り当てられます。この名前は、フィルタの影響を受ける要素の listen パラメータで参照されます。listen パラメータは、type: text 以外のすべての要素タイプに適用され、その使用に関する詳細は、個々の可視化タイプのドキュメント ページに表示されます。listen の動作の典型的な例については、LookML ダッシュボードの縦棒グラフ パラメータのドキュメント ページをご覧ください。

filters:
- name: order_date

title （フィルタの場合）

title パラメータを使用すると、ダッシュボードの上部に表示されるフィルタ名をユーザーにどのように表示するかを変更できます。指定しない場合、タイトルにはデフォルトでフィルタの名前が適用されます。

次の例を考えてみましょう。

filters:
- name: order_date
  title: "Order Date(s)"

この場合、フィルタは [Order Date] ではなく [Order Date(s)] と表示されます。

type

type パラメータは、フィルタに配置される入力のタイプを指定します。type: field_filter は、フィルタを基盤となるディメンションまたは指標に直接接続し、ユーザーにカスタマイズされたフィルタ ウィジェットを提供するため、通常はデフォルトの選択肢となります。フィルタの種類は次のとおりです。

  • field_filter: 一般に、基盤となるディメンションまたは指標を指定できる場合は、これがデフォルトの選択肢となります。type: field_filter を使用してフィルタを type:string フィールドに関連付けると、フィルタでフィルタ値の候補が表示されます。
  • number_filter: ユーザーが数値、整数値、式を入力できるようにします。
  • date_filter: ユーザーが日付値または式を入力できるようにします。

  • string_filter（非推奨）: Looker 23.6 で従来のダッシュボード エクスペリエンスが非推奨になったため、string_filter タイプはサポートされなくなりました（詳しくは、リリースノートをご覧ください）。候補のプルダウン リストのない自由形式のテキスト入力フィルタが必要な場合は、field_filter を使用した例をご覧ください。

field_filter

選択肢を提案し、指定した基盤となるフィールドに基づいてユーザーへの表示を変更します。

これは、ユーザーがフィルタを操作する際に候補を提示したい場合に最適なフィルタタイプです。候補が取得されるディメンションは、explore パラメータと field パラメータを使用して定義します。フィルタ候補を生成するには、type: string のフィールドである必要があります。

フィールドが派生テーブルから取得された場合、Explore で sql_always_where が使用されている場合、またはフィールドが measure の場合、候補が機能しないことがあります。

field_filter タイプの LookML の例を次に示します。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

候補のプルダウン リストのない自由形式のテキスト入力フィルタが必要な場合は、type: field_filter を使用し、ui_config: type: advanced を使用してコントロール タイプを構成します（UI 構成を参照）。

次の例は、候補なしで自由形式のテキスト入力を使用するフィルタを示しています。

filters:
- name: customer_name
  type: field_filter
  explore: orders
  field: customer.name
  ui_config:
    type: advanced

number_filter

候補を表示せず、ユーザーが整数、数値、式を入力できるようにします。

filters:
- name: order_value
  type: number_filter

date_filter

候補を表示せず、ユーザーが日付値または式を入力できるようにします。

filters:
- name: order_date
  type: date_filter

default_value

default_value パラメータを使用すると、フィルタで使用するデフォルト値を指定できます。この値は、妥当な出発点を提案することでユーザーの役に立ちます。

デフォルト値は、使用するフィルタのタイプと一致するようにしてください。次に例を示します。

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: field_filter
  explore: orders
  field: customer.name
  default_value: "John Doe"

フィルタ式を使用してデフォルト値を作成できます。詳細については、Looker のフィルタ式のドキュメント ページをご覧ください。

default_value パラメータと ui_config パラメータの両方を使用する場合、フィルタ式は、ui_config の type サブパラメータに指定された値と、type 値をサポートするデータ型と互換性がある必要があります。

_localization と _user_attributes の Liquid 変数を使用して、デフォルトのフィルタ値を柔軟に設定することもできます。

allow_multiple_values

allow_multiple_values パラメータを使用すると、ユーザーが単一のフィルタ値を選択できるか、複数のフィルタ値を選択できるかを制御できます。このパラメータが true（デフォルト）に設定されている場合、ユーザーはフィルタに複数の値を選択できます。このパラメータが false に設定されている場合、ユーザーは単一のフィルタ値のみを選択できます。

次に例を示します。

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

required パラメータを使用すると、ダッシュボードを実行するためにユーザーがフィルタの値を指定することを要求できます。デフォルトでは、フィルタ値は必須ではありません。値を必須としないフィルタが空白の場合、データはフィルタ フィールドによって制限されません。値が必須となっているフィルタを空欄のままにした場合、ダッシュボードは実行されません。

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

filters の ui_config サブパラメータを使用すると、LookML ダッシュボードのフィルタ設定を構成できます。これらの設定には、使用するフィルタ コントロールのタイプ、フィルタ コントロールの配置、フィルタ値の候補が含まれます。

次に例を示します。


  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

UI でフィルタを構成する方法について詳しくは、ユーザー定義のダッシュボード フィルタの追加と編集のドキュメント ページをご覧ください。

type

ui_config の type サブパラメータを使用すると、表示するフィルタ オプションの種類を指定できます。

type に入力する値に応じて、フィルタ コントロールは単一選択または複数選択になります。

STR = string データ型に対応 DIST = distance データ型と互換性があります
NUM = number データ型と数値メジャーに対応 DUR = duration データ型に対応
TIER = tier データ型に対応 D&T = ほとんどの日時データ型に対応
ZIP = zipcode データ型に対応 LOC = location データ型に対応
Y/N = yesno データ型に対応 PAR = parameter パラメータに対応
値説明サポートされるデータ型
複数選択
button_group フィルタには、options パラメータで指定された値ごとに 1 つのボタンを含むボタンのグループが表示されます。 STR NUM TIER ZIP Y/N DIST DUR
checkboxes フィルタにはチェックボックスが表示されます。options パラメータで指定された値ごとに 1 つのチェックボックスが表示されます。 STR NUM TIER ZIP Y/N DIST DUR
tag_list フィルタには、options パラメータを使用して指定された各可能な値が一覧表示されます。 STR NUM TIER ZIP DIST DUR
range_slider 数値フィールドの場合、フィルタにはスライダーが表示され、ユーザーはフィルタの値として数値の範囲を設定できます。options の min サブパラメータと max サブパラメータは、フィルタの最小値と最大値の指定に使用されます。デフォルトの範囲は default_value パラメータを使用して指定できます。 NUM DIST DUR
単一選択
button_toggles フィルタには、options パラメータで指定された値ごとに 1 つのボタンを含むボタンのグループが表示されます。 STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons フィルタには、ラジオボタンが表示されます。任意の値のボタンと、options パラメータで指定された値ごとに 1 つのボタンが表示されます。 STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu フィルタには、options パラメータで指定された各使用可能な値が一覧表示されたプルダウン メニューが表示されます。プルダウンでは、[任意の値] を選択することもできます。 STR NUM TIER ZIP Y/N DIST DUR PAR
slider 数値フィールドの場合、フィルタにはスライダーが表示されます。ユーザーは、options パラメータで指定された最小値と最大値の間をスライドしてフィルタを選択できます。 NUM DIST DUR
日付と時刻
day_picker このフィルタを使用すると、ユーザーはフィルタを適用する特定の日付を選択できます。 D&T 1 日コントロールは、主に時間枠や時間ベースの型で使用できますが、閲覧者が選択できるのはこのコントロールのタイプのある 1 日のみです。
day_range_picker このフィルタを使用すると、開始日と終了日を選択して、日付の範囲でフィルタできます。 D&T 期間コントロールは主に時間枠と時間ベースの型で使用することができますが、閲覧者が選択できるのはこのコントロールのタイプがある期間のみです。
date_time_range_input このフィルタを使用すると、ユーザーは日付と時刻の範囲でフィルタできます。 D&T 日付と時刻の範囲コントロールは、主に時間ベースの型で使用できます。閲覧者はこのコントロールのタイプがある日付と時刻の両方のオプションを選択する必要があります。
relative_timeframes このフィルタを使用すると、ユーザーはカスタムの日付範囲でフィルタしたり、[今日]、[過去 7 日間]、[過去 90 日間] などの期間のプリセットから選択したりできます。 D&T 時間枠コントロールは、主に時間枠と時間ベースの型で使用されますが、閲覧者はこのコントロールのタイプがある時間オプションを選択できません。
その他
advancedフィルタには、1 つ以上のフィルタまたは高度な一致フィルタを適用するためのオプションが表示されます。

高度なコントロールの詳細については、このページの高度なコントロールの使用をご覧ください。		 STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

ui_config の display サブパラメータを使用して、ダッシュボード フィルタの位置を設定できます。フィルタの位置は、display に次のいずれかの値を割り当てることで設定できます。

  • inline: フィルタはダッシュボードのトップバーに直接表示されます。
  • popover: 要約値がダッシュボードのトップバーに表示されます。値をクリックすると、フィルタ全体が表示されます。
  • overflow: ダッシュボードのトップバーに [その他]ボタンが表示され、オーバーフローフィルタの数を示す数値インジケーターも表示されます。ユーザーはボタンをクリックして、オーバーフローフィルタとその値を確認できます。

一部のフィルタタイプは、特定の方法でのみ表示できます。たとえば、type: day_picker のフィルタは inline または overflow としてのみ表示できます。フィルタに type に対して有効でない display 値を指定すると、フィルタは inline または popover のいずれか有効な方として表示されます。詳しくは、ユーザー定義のダッシュボード フィルタの追加と編集のドキュメント ページをご覧ください。

UI を使用してダッシュボード フィルタを配置する方法については、ユーザー定義フィルタの追加と編集のドキュメント ページをご覧ください。

options

ui_config のオプションの options サブパラメータを使用すると、ユーザーが LookML ダッシュボードを表示するときに、ダッシュボードのフィルタ値を一時的に更新するためにユーザーが選択できる値を指定できます。options に値を指定しない場合、Looker はデータベースから最初の値を取得します。

たとえば、users.city フィールドのフィルタで使用可能な値として San Francisco、New York、Tokyo を設定できます。


ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

ui_config の type サブパラメータが range_slider または slider に設定されている場合は、options の min サブパラメータと max サブパラメータを使用できます。

  • min: フィルタの最小値を設定します。
  • max: フィルタの最大値を設定します。

次に例を示します。


ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

type: field_filter のダッシュボード フィルタの場合、model パラメータは使用するフィールドのモデルを定義します。model パラメータは省略可能で、デフォルトではダッシュボードが含まれているモデルになります。

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

type: field_filter のダッシュボード フィルタでは、フィルタで候補を取得するフィールドを定義する必要があります。explore パラメータは、使用するフィールドを含む Explore を指定します。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

type: field_filter のダッシュボード フィルタでは、フィルタで候補を取得するフィールドを定義する必要があります。field パラメータは、使用するフィールドを指定します。完全修飾フィールド名を使用することが重要です。つまり、field_name だけでなく view_name.field_name も使用します。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

type: field_filter のダッシュボード フィルタの場合、ユーザーが type: field_filter の別のフィルタに入力した内容に基づいて、フィルタの候補を絞り込むことができます。

次の例では、State フィルタに表示される候補は、Order ID フィルタの値に基づきます。Order ID フィルタで選択された値には users.state 値が関連付けられ、その値が State フィルタの候補値になります。詳細については、ユーザー定義のダッシュボード フィルタの追加と編集のドキュメント ページをご覧ください。

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

vis_filter

vis_filter パラメータを使用すると、フィルタをビジュアリゼーション レベルのフィルタとして構成できます。このフィルタは、ダッシュボードのトップバーのフィルタバーではなく、個々のビジュアリゼーション タイルに直接表示されます。

vis_filter が true に設定されている場合、フィルタは、そのフィルタをリッスンするタイル（ダッシュボードの要素 の listen パラメータを使用して構成）の上部にあるフィルタバーに表示されます。デフォルト値は false です。この場合、フィルタは標準のダッシュボード レベルのフィルタとして上部のフィルタバーに表示されます。標準のダッシュボード フィルタでは、vis_filter: false を設定する必要はありません。

次に例を示します。

filters:
- name: order_date
  title: "Order Date"
  type: date_filter
  default_value: "last 30 days"
  vis_filter: true

ビジュアリゼーション レベルのフィルタの詳細については、ビジュアリゼーション タイルのフィルタのドキュメント ページをご覧ください。

embed_style

embed_style パラメータは、埋め込みダッシュボードの外観をカスタマイズする LookML セクションを開始します。embed_style とその関連パラメータは、埋め込みダッシュボードでのみサポートされており、ダッシュボードが埋め込まれていない場合は無視されます。

embed_style を変更したら、埋め込み LookML ダッシュボードに embed_style 設定を反映させるために、LookML を本番環境にデプロイする必要があります。

色を指定する次の埋め込みダッシュボード属性では、色の値は #2ca6cd などの 16 進数文字列、または mediumblue などの CSS 指定のカラー文字列にできます。

埋め込みダッシュボードのカスタマイズの形式は次のとおりです。

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

埋め込みダッシュボードの背景色を設定します。

embed_style:
  background_color: "#ffffff"

show_title

埋め込みダッシュボードのタイトルをユーザーに表示するかどうかを指定します。

embed_style:
  show_title: false

title_color

埋め込みダッシュボードのタイトルの色を設定します。

embed_style:
  title_color: "#008000"

show_filters_bar

埋め込みダッシュボードのフィルタをユーザーに表示するかどうかを指定します。

embed_style:
  show_filters_bar: true

tile_background_color

埋め込みダッシュボードのすべてのタイルの背景色を設定します。

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

埋め込みダッシュボードのすべてのタイルのテキストの色を設定します。

embed_style:
  tile_text_color: "crimson"

elements

elements パラメータは、ダッシュボードを構成する要素を定義する LookML のセクションを開始します。ダッシュボードの要素の外観を定義できるパラメータは多数あります。詳細については、ダッシュボードの要素のパラメータのページをご覧ください。

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1