チュートリアル：Databricks SQLへのサンプルダッシュボードのインポート

[Tutorial: Import sample dashboards to Databricks SQL \| Databricks on AWS](https://docs.databricks.com/sql/get-started/sample-dashboards.html) [2022/11/3時点]の翻訳です。

:::note warn
本書は抄訳であり内容の正確性を保証するものではありません。正確な内容に関しては原文を参照ください。
:::

> [Databricksクイックスタートガイド](https://qiita.com/taka_yayoi/items/125231c126a602693610)のコンテンツです。


このクイックスタートでは、Databricks SQLのダッシュボードサンプルギャラリーにあるダッシュボードをどの様にインポートして操作するのかを説明します。これらのダッシュボードは、お使いのデータから洞察を得るためにDatabricks SQLが提供するいくつかのリッチなビジュアライゼーションを説明します。これらのダッシュボードはワークスペースですでに利用できるデータを使用し、設定済みの計算リソースを使用します。使い始めるために管理者である必要はありません。

# 要件

- お使いのDatabricksアカウントが[プレミアムプラン以上](https://databricks.com/jp/product/aws-pricing)であること。
- お使いのDatabricksワークススペースが[E2バージョンのDatabricksプラットフォーム](https://qiita.com/taka_yayoi/items/7d209bc8d32bc5f2dba4#e2%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3)であること。E2ワークスペースの作成に関しては、[ワークスペースの作成、管理](https://docs.databricks.com/administration-guide/account-settings-e2/workspaces.html)をご覧ください。新規のDatabricksアカウントや大部分の既存アカウントはE2です。どのアカウントタイプか不明の場合には、Databricks担当者にお問い合わせください。
- これらのステップを実行するユーザーは、**Databricks SQLアクセス**資格を有している必要があります。

    新規ワークスペースの全ユーザーはこの資格を有しています。この資格を持っていることを確認するには、[サイドバーのペルソナスイッチャー](#サイドバーを使用)で**SQL**を選択します。**SQL**の隣に南京錠が表示されている場合には、ワークスペース管理者に**Databricks SQLアクセス**資格を付与してもらう様に依頼してください。

    :::note
    **注意**
    パブリックプレビュー中にDatabricks SQLが有効化された場合、すなわち、2021年9月7日の週以前に有効化されている場合、管理者が変更していない限り、その日以前に割り当てられた資格を維持しています。言い換えると、パブリックプレビュー期間に**Databricks SQLアクセス**資格が付与されていない場合、管理者が資格を付与しない限り、その権限を持ちません。
  :::

# ダッシュボードサンプルギャラリーへのアクセス

## サイドバーを使用

サイドバーを使用してDatabricksのすべてのアセットにアクセスすることができます。サイドバーの中身は選択されたペルソナ**Data Science & Engineering**、**Machine Learning**、**SQL**によって変化します。

- デフォルトではサイドバーは折り畳まれた状態で表示され、アイコンのみが表示されます。全体を表示するにはサイドバーの上にカーソルを移動します。
- ペルソナを変更するには、Databricksのロゴ![](https://docs.databricks.com/_images/databricks-logo.png)の下のアイコンをクリックしてペルソナを選択します。
![](https://docs.databricks.com/_images/change-persona.gif)
- 次回ログインした際に表示されるペルソナを固定するには、ペルソナの隣の![](https://docs.databricks.com/_images/persona-pin.png)をクリックします。ピンを削除するには再度クリックします。
- サイドバーのモードを**Auto**(デフォルト)、**Expand**、**Collapse**に設定するにはサイドバーの下部にある**Menu options**を使います。

## Databricks SQLにログイン

Databricks SQLにログインすると以下の様なランディングページが表示されます。
![](https://docs.databricks.com/_images/landing-dbsql-user.png)

Databricks Data Science & EngineeringかDatabricks Machine Learning環境が表示される場合には、Databricks SQLに切り替えるために[サイドバーを使用](#サイドバーを使用)します。

:::note
**注意**
**SQL**の隣に南京錠が表示されている場合には、管理者に**Databricks SQLアクセス**資格を付与してもらう様に依頼してください。
:::

## ダッシュボードのインポート

1. サイドバーで![](https://docs.databricks.com/_images/dashboards-icon.png)**Dashboards**をクリックします。

    ダッシュボードがワークスペースに保存されている場合、一覧表示されます。

1. ページの下にスクロールします。**Sample dashboards**タイルの**Visit gallery**をクリックします。ダッシュボードサンプルギャラリーが表示されます。
    
    :::note
    **注意**
    ワークスペースURLに`/sql/dashboards/samples/`を追加することでダッシュボードサンプルギャラリーに移動することもできます。
   :::
1. **Retail Revenue & Supply Chain**の隣の**Import**をクリックします。ワークスペースにダッシュボードがインポートされ、あなたがオーナーになります。

    インポートされたダッシュボードが表示され、ビジュアライゼーションが更新されます。
![](https://docs.databricks.com/_images/retail-revenue-supply-chain.dashboard.png)

サンプルダッシュボードを複数回インポートすることができ、複数のユーザーが各自でインポートすることができます。また、**NYC Taxi Trip Analysis**ダッシュボードをインポートすることもできます。

## インポートしたダッシュボードの探索

以下のセクションでは、インポートしたRetail Revenue & Supply Chainダッシュボードを用いて、ダッシュボードのキーとなるポイントを説明します。

### ビジュアライゼーションのクエリーを探索

1. ダッシュボードのそれぞれのビジュアライゼーションはクエリーの結果です。インポートしたダッシュボードで、ビジュアライゼーション**National Revenue Trends**にマウスを移動し、コンテキストメニュー![](https://docs.databricks.com/_images/vertical-ellipsis.png)をクリックし、**View Query**をクリックします。
![](https://docs.databricks.com/_images/national_revenue_trends-context-menu.png)

    ビジュアライゼーションのクエリーがSQLエディタで表示されます。
![](https://docs.databricks.com/_images/national-revenue-trends-query.png)

    サンプルダッシュボードでは、ワークスペースのデータとは別に存在する`SAMPLES`カタログのデータを使用します。すべてのワークスペースで`SAMPLES`カタログを利用できますが、読み取り専用です。

1. 500レコードのみを返却する様に、クエリーの下にある`LIMIT 1000`を`LIMIT 500`に変更します。編集したクエリーを実行するために**Run All**をクリックし、ダッシュボードのクエリーを保存するために**Save**をクリックします。

    :::note
    **注意**
    インポートしたダッシュボードを変更しても、ダッシュボードサンプルギャラリーにあるオリジナルのダッシュボードは変更されます。最初からやり直すには、ダッシュボードを再度インポートします。
   :::

1. ダッシュボードに戻るためにブラウザの**Back**ボタンをクリックします。

### ビジュアライゼーションを操作

1. ビジュアライゼーション**Shifts in Pricing Priorities**にマウスを移動します。ビジュアライゼーションを拡大するために、ビジュアライゼーションの右下をクリックします。
1. 拡大したビジュアライゼーションにマウスを移動します。ビジュアライゼーションのダウンロード、ズーム、パン、オートスケールするためのボタンが表示されます。
![](https://docs.databricks.com/_images/shifts-in-pricing-priorities-visualization.png)
1. ダッシュボードに戻るために**Close**をクリックします。

### ダッシュボードの共有

同僚にダッシュボードを共有するには:

1. ページ上部にある**Share**をクリックします。
1. ワークスペースのユーザー、グループを選択します。
    ワークスペースの全ユーザーと共有するには、**All users**を選択します。
1. 許可する権限を選択します。
![](https://docs.databricks.com/_images/share-dashboard-permission.png)
    デフォルトでは、ダッシュボードに含まれる6個のクエリーも共有されます。

    :::note
    **注意**
    認証情報が**Run as owner**に設定されている場合には、**Can edit**権限でオブジェクトを共有することはできません。
   :::
1. 共有フォームの下部で、参照者の認証情報かオーナーの認証情報を用いてダッシュボードを実行するのかを選択します。
1. **Add**をクリックし、フォームをクローズします。

### 自動ダッシュボード更新のスケジュール

一定間隔で自動でダッシュボードを更新する様にスケジュールすることができます。

1. ページの上部にある**Schedule**をクリックします。

    すでにダッシュボードがスケジュールされている場合、**Schedule**ではなく**Scheduled**と表示されます。
1. **Every 1 hour**の様な間隔を選択します。

    5年ごとのようなより複雑な間隔を作成するには**Advanced**をクリックします。

1. SQLウェアハウスを選択します。SQLウェアハウスはDatabricks SQL専用の計算リソースです。SQLウェアハウスはダッシュボードが更新された際にダッシュボードのクエリーを実行し、ビジュアライゼーションを生成します。

    管理ユーザーはSQLウェアハウスを作成、設定、削除することができます。

1. オプションとして、自動で更新された際にメールバージョンのダッシュボードを受信するために、ワークスペースのユーザーや送信先を設定することができます。

    管理ユーザーは、アラートの送信先を作成、設定、削除を行えます。ワークスペースユーザーのメールアドレスは、自動でアラートの送信先に追加されます。

1. **Save**をクリックします。

    スケジュールに沿ってダッシュボードが更新される様になります。

1. ダッシュボードの自動更新を停止するには:
    1. **Scheduled**をクリックします。
    1. **Refresh**を**Never**に設定します。
    1. **Save**をクリックします。

# 次のステップ

これでサンプルダッシュボードのウォークスルーは完了となり、ご自身のデータで作業できる準備はほぼ整いました。

1. 管理者の方は、[Databricks SQLの管理者のタスクを完了する](https://qiita.com/taka_yayoi/items/aca244745439b9d12f2b)を完了してください。
1. 次に、管理者の方は[Databricks SQL : 管理者向けクイックスタート](https://qiita.com/taka_yayoi/items/8b6154eb8bfe202951c6)を受講してください。
1. [Databricks SQL : 管理者向けクイックスタート](https://qiita.com/taka_yayoi/items/8b6154eb8bfe202951c6)の次ステップとなる[Databricks SQL : ユーザー向けクイックスタート](https://qiita.com/taka_yayoi/items/fd0d5e4de3c7f50de617)をトライしてみてください。

### Databricks 無料トライアル

[Databricks 無料トライアル](https://databricks.com/jp/try-databricks)