Looker のドキュメントを表示していることに注意してください。Looker Studio のドキュメントについては、https://support.google.com/looker-studio をご覧ください。

LookML ダッシュボードの作成

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'

ダッシュボードフィルタ

ユーザーは、次の 2 つのステップで変更可能なダッシュボードフィルタを作成できます。

filters ダッシュボードパラメータとそのサブパラメータを使用して、ダッシュボードフィルタ自体を作成します。
listen ダッシュボードの要素パラメータを使用して、ダッシュボードの要素にダッシュボードフィルタを適用します。

ダッシュボードフィルタの作成

最初のステップは、ユーザーが操作するフィルタを作成することです。これを行うには、filters セクションをダッシュボードファイルに追加して次のようにします。

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  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

これらのフィルタのさまざまなオプションとパラメータについては、ダッシュボードパラメータのドキュメントページをご覧ください。留意すべき最も重要な点の 1 つは、ユーザーに期待している入力のタイプです。フィルタに type を割り当てると、フィルタは数値、日付、文字列などの特定の型の入力を受け入れることができます。または、フィルタ type を使用して、基になる LookML フィールドにフィルタを関連付けることができます。この場合、Looker は正しい入力タイプを自動的に選択し、基になる LookML フィールドが type: string の場合、ダッシュボードの閲覧者にフィルタの候補を提案します。

ダッシュボードパラメータのドキュメントページで説明されているように、explore パラメータと field パラメータは、type: field filter を指定したフィルタでのみ使用されます。他のフィルタタイプで explore パラメータと field パラメータを含めると、LookML 検証エラーが発生します。

ダッシュボードの要素にダッシュボードフィルタを適用する

ダッシュボードフィルタを作成したら、listen パラメータを使用して適切な要素に適用する必要があります。それは、要素がユーザーの入力に対して 1 つ以上のフィルタを「リッスン」し、それに応じて調整するというものです。このパラメータは、type: text と type: button 以外のすべての要素タイプに適用され、その使用に関する詳細は、個々の可視化タイプのドキュメントページに表示されます。listen の動作の典型的な例については、LookML ダッシュボードの面グラフパラメータをご覧ください。

たとえば、次のような要素があるとします。

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'

この要素には、（フィルタ order.status: 'approved' を使用して）要素を承認済みの注文に制限する filters パラメータがすでに含まれていることがわかります。この設定をユーザーが変更することはできません。

ユーザーが、この例で先に作成したダッシュボードフィルタを使用して、この要素をフィルタリングできるようにするとします。これを行うには、次のような listen パラメータを追加します。

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'
  listen:
    category_name: category.name
    date: order.created_date

ユーザーが日付やカテゴリを調整できないようにする場合は、単に listen パラメータを追加しないようにします。必要な作業は、ユーザーに調整を許可する要素に listen を追加することだけです。

listen 構文が機能していることは、最初に作成したフィルタの名前を記述してから、ユーザー入力を適用するフィールドの名前を記述することで確認できます。

ダッシュボードフィルタは、任意の要素内の（同じデータ型の）任意のフィールドに適用できます。たとえば、ある要素ではユーザーの入力を注文作成日（date: order.created_date）に適用し、別の要素では注文出荷日（date: order.ship_date）に適用できます。

- name: element_one
  # lots of other element parameters here
  listen:
    date: order.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: order.ship_date

ダッシュボードファイルをモデルに含める

ダッシュボードを Development Mode でプレビューまたは本番環境で表示するには、include ステートメントを使用して、ダッシュボードのベースとなっているモデルファイルに含まれている必要があります。

通常は、ワイルドカードを使用して、モデルにすべての LookML ダッシュボードを含めます。

include: "*.dashboard.lookml"

または、LookML ダッシュボードが IDE 内のフォルダ内にある場合は、その場所へのパスを使用します。

 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 つ目のダッシュボードの作成が可能になり、一部の設定を追加またはオーバーライドすることができます。最初のダッシュボードを変更しても、2 番目のダッシュボードはその変更を自動的に継承します（2 番目のダッシュボードでオーバーライドされない限り）。詳しくは、拡張機能でコードを再利用するのドキュメントのページをご覧ください。

集計認識を使用したダッシュボードのパフォーマンスの向上

LookML のデベロッパーは、集計認識を使用して LookML ダッシュボードのパフォーマンスを向上させることができます。集計認識を使用すると、デベロッパーは LookML の explore パラメータでサマリー表を作成できます。これにより、ダッシュボードで 1 つ以上のタイルのクエリを最適化できます。

LookML ダッシュボードを作成して表示したら、[ダッシュボードアクション]（縦三点リーダー）メニューにある [集計テーブル LookML の取得] オプションを使用できます。これは、see_lookml 権限が付与されていると表示されます。

詳細については、aggregate_table パラメータのドキュメントページをご覧ください。