LookML ダッシュボードは LookML のデベロッパーによって作成され、バージョン管理されたファイルとして保存されます。デフォルトでは、Looker インスタンスの [LookML dashboards] フォルダに表示されます。
LookML ダッシュボードとユーザー定義ダッシュボードを比較対照するには、ユーザー定義ダッシュボードと LookML ダッシュボードの比較のドキュメント ページをご覧ください。
LookML ダッシュボードを作成するには、次の Looker 権限が必要です。
また、ダッシュボードで使用するデータの LookML モデルへのアクセス権が必要です。
LookML ダッシュボード ファイルの作成
LookML ダッシュボードを構築するには、まず拡張子 .dashboard.lookml
を含むダッシュボード ファイルを作成します(ただし、拡張機能の .lookml
部分は IDE 内では機能しません)。手順は次のとおりです。
- Development Mode をオンにします。
- [開発] メニューでプロジェクトに移動します。
- Looker IDE でファイル ブラウザ パネルの上部にある [Add file or folder] プラスアイコンを選択して、既存のプロジェクト フォルダの外側に LookML ダッシュボード ファイルを作成します。または、フォルダの 3 点リーダーの [フォルダ オプション] メニューをクリックして、フォルダ内にファイルを作成します。[Create Dashboard] をクリックしてダッシュボード ファイルを作成します。
- [ファイルを作成] ウィンドウが表示されます。ウィンドウ内で、書き込みフィールドでダッシュボード ファイルに名前を付けて、[作成] ボタンを選択します。
LookML ダッシュボード ファイルの編集
LookML ダッシュボード ファイルを作成すると、Looker によっていくつかの基本的なダッシュボード パラメータがファイルに事前入力されます。これらのパラメータでダッシュボード全体の設定が行われます。また、いくつかのサンプル ダッシュボードの要素パラメータがファイルに事前入力されます。これらのパラメータは elements
ダッシュボード パラメータでグループ化され、ダッシュボード タイル、テキスト、ボタンの機能と外観を定義します。新しく作成された .dashboard.lookml
ファイルには、次のようなダッシュボード LookML が含まれています。
- dashboard: order_analysis
title: Order Analysis
layout: newspaper
preferred_viewer: dashboards-next
tile_size: 100
filters:
elements:
- name: hello_world
type: looker_column
ダッシュボード ファイルは、Development Mode であれば、IDE 内で編集できます。
ダッシュボードを作成するには、いくつかの方法があります。
- 手動作成: ダッシュボード パラメータとダッシュボードの要素パラメータを使用して、手動でダッシュボードを作成できます。
- ユーザー定義のダッシュボードのコピー: 事前入力されたダッシュボード LookML をファイルから削除し、ユーザー定義のダッシュボードからダッシュボード LookML をコピーし、ダッシュボード ファイルに貼り付けることで、ユーザー定義ダッシュボードのコピーを作成できます。
- 要素のダッシュボード LookML のコピー: Explore または Look からダッシュボード LookML をコピーして、ダッシュボード ファイルに貼り付けることができます。
ダッシュボードを作成するときは、ダッシュボード構築のベスト プラクティスに留意してください。高パフォーマンスなダッシュボードの構築に関する情報と推奨事項は、高パフォーマンスの Looker ダッシュボードを作成する際の考慮事項のベスト プラクティスのページでご確認ください。
既存の LookML ダッシュボードへのビジュアリゼーションの追加
既存の LookML ダッシュボードに可視化を追加する最も簡単な方法は、Explore ページを使用して、ダッシュボードの要素に変換するクエリを作成することです。
- ダッシュボードに追加するクエリと可視化を作成したら、Explore の [Explore アクション] の歯車メニューをクリックします。
[LookML を取得] を選択して LookML を公開します。
[LookML を取得] ウィンドウが表示されます。ウィンドウで [Dashboard] を選択した状態で、すべての LookML を選択し、コピーします。
ここから、ダッシュボードの LookML ファイルに LookML を貼り付けます。ダッシュボードの LookML ファイルを編集する場合は、次のことを行ってください。
- ダッシュボード ファイルを編集できるように、[Development Mode] になっていることを確認します。
- LookML を、ダッシュボードの
elements
パラメータの下に貼り付けます。 - LookML をダッシュボード ファイルに貼り付けるときは、正しいインデントを使用してください。可能であれば、インデントをダッシュボード ファイルにすでに存在する要素に一致させます。
必要に応じて、個々の要素タイプのドキュメント ページで説明されているパラメータを使用して、LookML パラメータを調整できます。
Look への
ダッシュボード ファイルにダッシュボードの要素を保存した後、フィルタを追加して、ダッシュボードの閲覧者がダッシュボードの一部またはすべての要素をフィルタリングできるようにすることができます。フィルタは、たとえば、次のような多くの理由から役に立つことがあります。
- 表示される期間の調整
- 表示される特定の商品カテゴリ、お客様のタイプなどの調整
- クライアントまたはお客様への「検索」型機能の提供
必要なタイプのフィルタを作成してください。次の 2 つのタイプがあります。
- ダッシュボードの要素にハードコードできるフィルタ。ダッシュボード閲覧者はこれを変更できません。
- ダッシュボードのフィルタ。ダッシュボードの閲覧者は変更可能です。
ダッシュボードの要素にハードコードされたフィルタ
ユーザーが変更できないダッシュボードの要素にハードコードするフィルタは通常、可視化用またはダッシュボード用の LookML コピーステップで自動的に作成されます。LookML ダッシュボードでは、これらのフィルタは filters
ダッシュボードの要素パラメータを使用します。次に例を示します。
- name: element_name
# lots of other element parameters here
filters:
dimension_or_measure_name: 'looker filter expression'
ダッシュボード フィルタ
ダッシュボード フィルタを使用すると、ダッシュボードの要素に表示されるデータをインタラクティブに絞り込むことができます。ダッシュボード フィルタを作成する手順は次のとおりです。
- ダッシュボード フィルタは、LookML ダッシュボード ファイル内で
filters
パラメータを使用して作成します。 listen
パラメータを使用して、個々のダッシュボード要素にフィルタを適用します。
ダッシュボード フィルタの作成
filters
パラメータを使用すると、ダッシュボードにさまざまな種類のインタラクティブ フィルタを作成できます。
ユーザーが操作できるダッシュボード フィルタを作成するには、ダッシュボード ファイルに filters
パラメータを追加します。たとえば、次のサンプルコードは、date
と category_name
のフィルタを含む LookML ダッシュボードを作成します。
- dashboard: dashboard_name
title: Dashboard Title
layout: newspaper
filters:
- name: date
title: 'Date Range'
type: date_filter
default_value: 30 days
- name: category_name
type: field_filter
model: ecommerce
explore: product
field: category.name
前の例のコードは、次のフィルタを作成します。
date
: ユーザーが期間を選択できる日付フィルタ。デフォルト値は過去 30 日間に設定されています。category_name
: ユーザーが商品カテゴリでフィルタリングできるフィールド フィルタ。このフィルタは、指定された LookML モデル(ecommerce
)と Explore(product
)内のcategory.name
フィールドに基づくオプションを動的に生成します。
ダッシュボードの要素にダッシュボード フィルタを適用する
ダッシュボード フィルタを作成したら、listen
パラメータを使用して、そのフィルタを個々のダッシュボード要素に適用できます。このように listen
パラメータを使用すると、フィルタでユーザーが選択した内容に基づいて、リンクされた要素を動的に更新できます。
たとえば、面グラフの要素の次のサンプル LookML コードについて考えてみます。
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
クエリが orders_created_date
ディメンションと orders.count
メジャーに基づいていて、orders.status: 'approved'
というフィルタが適用されているため、approved_orders_by_day
グラフには承認された注文の数が日別に表示されます。このフィルタは要素内で固定されていて、ダッシュボード閲覧者が変更することはできません。
ユーザーが前述の例の date
フィルタと category_name
フィルタを使用して approved_orders_by_day
グラフをフィルタできるようにするには、listen
パラメータをダッシュボード要素に追加します。
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
listen:
category_name: category.name
date: orders.created_date
ダッシュボードの閲覧者が category_name
フィルタまたは date
フィルタを操作すると、approved_orders_by_day
グラフが自動更新され、フィルタされた結果が反映されます。
listen
パラメータは、filter_name: field_name
構文を使用します。上記の例では、category_name
と date
はフィルタの名前、category.name
と orders.created_date
はダッシュボード閲覧者がフィルタに入力できるようにするために使用されるフィールドです。
ダッシュボード フィルタは、任意の要素内の(同じデータ型の)任意のフィールドに適用できます。 たとえば、ある要素ではユーザーの入力を注文作成日(date: orders.created_date
)に適用し、別の要素では注文出荷日(date: orders.ship_date
)に適用できます。
- name: element_one
# lots of other element parameters here
listen:
date: orders.created_date
- name: element_two
# lots of other element parameters here
listen:
date: orders.ship_date
ダッシュボード ファイルをモデルに含める
ダッシュボードを Development Mode でプレビューまたは本番環境で表示するには、include
ステートメントを使用して、ダッシュボードのベースとなっているモデルファイルに含まれている必要があります。
一般的な方法は、ワイルドカードを使用してすべての LookML ダッシュボードをモデルに含める方法です。
include: "*.dashboard.lookml"
または、IDE のフォルダ内に LookML ダッシュボードが表示されている場合は、その場所へのパスを使用します。
include: "/path/*.dashboard.lookml"
ファイル名を指定して、特定のダッシュボードを含めることもできます。
include: "my_dashboard.dashboard.lookml"
LookML ダッシュボードの保存、プレビュー、公開
ダッシュボードをプレビューするには:
- ファイルの右上にある [変更を保存] ボタンをクリックして、
.dashboard.lookml
ファイルを保存します。 - 関連するモデルファイルにダッシュボードを含めて、そのファイルに変更を保存します。
- プレビューする
.dashboard.lookml
ファイルで、下矢印 [See file Actions] アイコンをクリックして [ダッシュボードを表示] を選択します。
.dashboard.lookml
ファイルにさらに変更を加えて保存し、ダッシュボードをもう一度プレビューできます。
ダッシュボードが完成したら、本番環境に公開して、適切な権限を持つユーザーがダッシュボードを閲覧できるようにします。ダッシュボードを公開する方法は、インスタンスの LookML に対する他の変更を公開する場合と同じで、Looker インスタンスのバージョン管理設定によって異なります。
[LookML dashboard] フォルダ
公開すると、LookML ダッシュボードはデフォルトで [LookML ダッシュボード] フォルダに保存されます。[LookML dashboard] フォルダは、左側のナビゲーションの [フォルダ] フォルダにあります。[LookML dashboard] フォルダは、いくつかの点で他のフォルダと異なります。
- LookML ダッシュボードを [LookML dashboard] フォルダに表示するために、LookML ダッシュボードを少なくとも 1 つのモデルファイルに含める必要があります。
- [LookML dashboard] フォルダを表示するには、ユーザーに
see_lookml_dashboards
権限が必要です。 - [LookML dashboard] フォルダ内でダッシュボードを表示するには、ダッシュボードを含む LookML モデルへのアクセス権が必要です。
- LookML ダッシュボード内で特定のタイルを表示するには、ダッシュボードの閲覧者に、そのタイルのベースとなっている LookML モデルへのアクセス権が必要です。
- [LookML dashboard] フォルダでダッシュボードを編集するには、LookML ダッシュボードを含むモデルに対する
develop
権限が必要です。 - ダッシュボード内の特定のタイルについて [Explore from Here] を行うには、ダッシュボードの閲覧者が、タイルのベースとなっているモデルの
explore
権限を持っている必要があります。 - [LookML dashboard] フォルダ内にフォルダを作成することはできません。
[LookML dashboard] フォルダの外への LookML ダッシュボードの移動
see_lookml_dashboards
と develop
の Looker の権限に加えて、LookML ダッシュボードを含む LookML モデルへのアクセス権がある場合は、LookML ダッシュボードを、アクセスの管理、編集のフォルダ アクセスレベルを持つ任意のフォルダに移動できます。
ダッシュボードを移動するには、次の 2 つの方法があります。
- [LookML dashboard] フォルダから、移動するダッシュボードを選択し、ダッシュボード セクションの上部にある [移動] ボタンをクリックして、ダッシュボードの移動先のフォルダを選択します。詳細については、コンテンツの編成と管理のドキュメント ページをご覧ください。
- [LookML dashboards] フォルダで、ダッシュボードのその他メニューをクリックし、メニューから [移動] を選択して、ダッシュボードの移動先のフォルダを選択します。
Development Mode を使用している場合、LookML ダッシュボードを [LookML dashboards] フォルダの外に移動することはできません。代わりに、[インポート] オプションを使用して、別のフォルダに LookML ダッシュボードをユーザー定義のダッシュボードとしてコピーできます。
ユーザー定義のダッシュボードと LookML ダッシュボードの両方を含むフォルダには、[LookML ダッシュボード] セクションに LookML ダッシュボードが表示されます。LookML ダッシュボードを [LookML Dashboard] セクションから別のフォルダに移動するか、LookML ダッシュボードをボードに固定できます。ただし、ユーザー定義のダッシュボードとは異なり、LookML ダッシュボードの名前を変更したり、フォルダからゴミ箱に移動したりすることはできません。
LookML ダッシュボードの dashboard
パラメータの値が変更されると、LookML ダッシュボードは自動的に [LookML ダッシュボード] フォルダに戻ります。
既存の LookML ダッシュボードの LookML を表示
たとえば、see_lookml
権限があれば、ダッシュボードの 3 点リーダー [Dashboard actions] メニューから [Go to LookML] を選択して、既存の LookML ダッシュボードのダッシュボード LookML に移動できます。
[Go to LookML] を選択すると、Looker が LookML ダッシュボードを定義したダッシュボード ファイルに移動します。
LookML ダッシュボードの拡張
LookML ダッシュボードを作成したら、ダッシュボードを拡張できます。これにより、元のダッシュボードに基づいて 2 つ目のダッシュボードを作成できるため、設定を追加やオーバーライドを行えます。1 つ目のダッシュボードを変更すると、2 つ目のダッシュボードにもその変更が自動的に継承されます(2 つ目のダッシュボードでオーバーライドされない限り)。詳しくは、拡張機能でコードを再利用するのドキュメントのページをご覧ください。
集計認識を使用したダッシュボードのパフォーマンスの向上
LookML のデベロッパーは、集計認識を使用して LookML ダッシュボードのパフォーマンスを向上させることができます。集計認識を使用すると、デベロッパーは LookML の explore
パラメータでサマリー表を作成できます。これにより、ダッシュボードで 1 つ以上のタイルのクエリを最適化できます。
LookML ダッシュボードを作成して表示したら、[ダッシュボード アクション](縦三点リーダー)メニューにある [集計テーブル LookML の取得] オプションを使用できます。これは、see_lookml
権限が付与されていると表示されます。
詳細については、aggregate_table
パラメータのドキュメント ページをご覧ください。