ダッシュボード
ダッシュボードを使用してデータの視覚化を構築し、有益なデータ分析情報をチームと共有できます。 AI/BI ダッシュボードでは、AI が支援する資料作成、強化された視覚化ライブラリ、および効率化された構成エクスペリエンスを備えているため、データを共有可能な分析情報に迅速に変換できます。
Note
ダッシュボード (旧称 Lakeview ダッシュボード) が一般公開されました。
ダッシュボードは Azure Government リージョンでは使用できません。 レガシ ダッシュボードを使用してください。
- 元の Databricks SQL ダッシュボードは、レガシ ダッシュボードと呼ばれるようになりました。 これらは引き続きサポートされ、重要なバグ修正で更新されますが、新機能は制限されます。 作成と使用の両方でレガシ ダッシュボードを引き続き利用できます。
- 移行ツールまたは REST API を使用して、レガシ ダッシュボードを変換します。 組み込み移行ツールの使用方法については、「レガシ ダッシュボードを Lakeview ダッシュボードに複製する」を参照してください。 REST API を使用したダッシュボードの作成と管理に関するチュートリアルについては、ダッシュボードのチュートリアルを参照してください。
AI/BI ダッシュボードには以下のコンポーネントがあります。
- データ: [データ] タブを使用すると、ユーザーはダッシュボードで使用するデータセットを定義できます。 UI または API を使用してデータセットを共有、インポート、またはエクスポートする場合、データセットはダッシュボードにバンドルされます。
- キャンバス: [キャンバス] タブを使用すると、ユーザーは視覚化を作成し、ダッシュボードを構築できます。 キャンバスには、視覚化、フィルター、テキスト、または画像を表示するように構成できるウィジェットが保持されます。
Note
ダッシュボードごとに最大 100 個のデータセットを定義できます。 キャンバスには、ダッシュボードごとに最大 100 個のデータセットを定義できます。
ダッシュボードの表示と整理
ワークスペース ブラウザーから、他の Azure Databricks オブジェクトと共にダッシュボードにアクセスできます。
ワークスペース ブラウザーでダッシュボードを表示するには、サイド バーの
[ワークスペース] をクリックします。 ダッシュボードは、既定で
/Workspace/Users/<username>
ディレクトリに保存されます。 ユーザーは、他の Azure Databricks オブジェクトと共に、ワークスペース ブラウザー内のフォルダーにダッシュボードを整理できます。 「ワークスペース ブラウザー」をご覧ください。ダッシュボードの一覧ページを表示するには、サイド バーの
[ダッシュボード] をクリックします。
既定では、ダッシュボードの一覧ページには、アクセスできるダッシュボードが新しい順に並べ替えられて表示されます。 検索バーにタイトルを入力して一覧をフィルター処理したり、期間内の最終更新日でフィルター処理したり、所有者でフィルター処理したりできます。
ダッシュボードのタイトルをクリックして開きます。 ダッシュボードが以前に公開されている場合は、公開済みバージョンが開きます。 それ以外の場合は、下書きダッシュボードが開きます。
新しいダッシュボードを作成する
ダッシュボード リスト ページから新しいダッシュボードを作成するには、ページの右上隅近くにある [作成] をクリックします。
データセットを定義する
[データ] タブを使用して、ダッシュボードの基になるデータセットを定義します。
データセットは、以下のいずれかとして定義できます。
- 1 つ以上のテーブルまたはビューに対する新しいクエリ。
- 既存の Unity Catalog テーブルまたはビュー。
あらゆる種類のテーブルやビューにもデータセットを定義できます。 追加のクエリを記述するか、追加のテーブルまたはビューを選択すると、複数のデータセットを定義できます。 データセットを定義したら、データセット名の右側にある kebab メニューを使って、名前の変更、複製、または削除を行うことができます。 データセットは、CSV、TSV、または Excel ファイルとしてダウンロードすることもできます。
SQL を使用してデータ アクセスを制限する
ダッシュボード データセット内のデータはすべて、視覚化で表示されていなくても、ダッシュボード ビューアーからアクセスできます。 機密データがブラウザーに送信されないようにするには、データセットを定義する SQL クエリで指定された列を制限します。 たとえば、テーブルからすべての列を選択するのではなく、テーブル構成ではなく、SQL ステートメントの視覚化に必要な特定の列のみを選択します。
キャンバス上の視覚化、テキスト、フィルター ウィジェットを追加または削除する
[キャンバス] タブを使用して、ダッシュボードを構築します。 キャンバスの下部にあるツール バーを使用して、視覚化、テキスト ボックス、フィルターなどのウィジェットを追加します。
視覚化
視覚化ウィジェットをキャンバスに追加して視覚化を作成します。 サポートされている視覚化には、面、棒、複合、カウンター、ヒートマップ、ヒストグラム、折れ線、円、ピボット、散布図、表グラフなどの種類があります。
Note
視覚化によって使用されるクエリは、必ずしもデータセットに正確に対応するとは限りません。 たとえば、視覚化に集計を適用すると、視覚化に集計値が表示されます。
視覚化を作成するには、次のいずれかの方法を使用します。
- AI 支援視覚化: 表示したいグラフについて自然言語で説明し、Databricks Assistant でグラフを生成します。 作成後、生成されたグラフは、構成パネルを使って変更できます。 アシスタントを使ってテーブルやピボット テーブル グラフの種類を作成することはできません。
- 構成パネルを使う: 視覚化構成でデータセットを直接変更することなく、追加の集計またはタイム ビンを適用します。 データセット、X 軸の値、Y 軸の値、色を選択できます。 サポートされる各視覚化の詳細な構成の種類と例については、「ダッシュボード視覚化の種類」を参照してください。 テーブルの視覚化でデータの表示を制御する方法については、「テーブル オプション」を参照してください。
Note
視覚化構成でテンポラル変換を適用すると、視覚化に表示される日付がその期間の開始を表します。
テキスト ウィジェット
Markdown は、プレーン テキスト エディターでテキストを書式設定するためのマークアップ言語です。 テキスト ウィジェットで Markdown を使って、テキストの書式設定、リンクの挿入、ダッシュボードへの画像の追加を行うことができます。
- テキスト ウィジェットで静止画像を追加するには、一般公開されている URL から、必要な説明と URL:
![description](URL)
を含む Markdown 画像構文を追加します。 たとえば、次のマークダウンでは、Databricks ロゴの画像が挿入されます:![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png)
。 画像のサイズを変更するには、ウィジェットのディメンションを変更します。 - DBFS から画像を追加するには、必要な説明と FileStore パスを含むマークダウン画像構文を追加します:
![description](files/path_to_dbfs_image)
。 画像のサイズを変更するには、ウィジェットのディメンションを変更します。 DBFS の詳細については、「DBFS とは」を参照してください。
Markdown 構文の詳細については、このガイドを参照してください。
フィルター
フィルターは、ダッシュボードを見ているユーザーが特定のフィールドでフィルター処理したり、データセット パラメーターを設定したりして結果を絞り込むためのウィジェットです。 他の BI ツールのスライサーと同じように機能するため、ダッシュボードを見ているユーザーは視覚化されたデータを操作したり、調整したりできます。 各フィルター ウィジェットは、データセット フィールドをフィルター処理したり、データセット クエリの定義済みパラメーターに値を割り当てたりするように構成できます。 クエリベースのパラメーターを使用する場合、フィルターとパラメーターは 1 つのウィジェットで組み合わせることができます。 クエリベースのパラメーターを適用する方法については、「クエリベースのパラメーターの使用」を参照してください。
フィールドにおけるフィルター処理
ダッシュボードでは、フィールドでフィルター処理するために次のフィルターの種類がサポートされています。
- 単一値
- 複数の値
- Date picker
- 期間ピッカー
- テキスト入力
- 範囲スライダー
フィルターは、1 つ以上のデータセットのフィールドに適用できます。 複数のデータセットからフィルターをフィールドに接続するには、複数のフィールド (各データセットには最大 1 つ) を追加します。 フィルターは、選択したデータセットに基づいて構築されたすべての視覚化に適用されます。 フィルター選択は、他のすべてのフィルターに連鎖します。
ダッシュボード フィルターは常にデータセット全体に適用されます。 データセットが小さい場合、ダッシュボード フィルターは、パフォーマンスを向上させるためにブラウザーに直接適用されます。 データセットが大きい場合、フィルターは、SQL ウェアハウスで実行されるクエリに追加されます。
パラメーターにおけるフィルター処理
フィルターがパラメーターに接続されている場合、データセットのサイズに関係なく、SQL ウェアハウスに対してクエリが実行されます。
ダッシュボードでは、パラメーターでフィルター処理するために以下のフィルターの種類がサポートされています。
- 単一値
- Date picker
パラメーター値は、次のいずれかのデータ型を受け入れるように設定できます。
- String
- 日
- 日付と時間
- 10 進法
- Integer
「ダッシュボード パラメーターとは」を参照してください。
Note
パラメーターを使用して日付範囲を指定することはサポートされていません。 日付範囲を指定するには、指定したい範囲の開始日と終了日を含むフィールドにフィルターを適用します。
パブリッシュされたダッシュボード URL にフィルターとパラメーターを含める
フィルターとパラメーターの選択は URL に格納されます。 ユーザーは、これらの URL をブックマークして、すべてのフィルターとパラメーターを含むダッシュボードの状態を保存できます。 これにより、ダッシュボードの設定はそのまま残り、他のユーザーはリンクにアクセスするときに同じ構成で表示できます。
ウィジェットをコピーする
キーボード ショートカットを使用して、選択したウィジェットをコピーし、キャンバスに貼り付けます。 新しいウィジェットを作成した後、他のウィジェットと同様に編集できます。
下書きダッシュボード キャンバスにウィジェットを複製するには、次の手順を完了します。
- ウィジェットを右クリックします。
- [複製] をクリックします。
ウィジェットの複製が元のウィジェットの下に表示されます。
ウィジェットを削除する
ウィジェットを選択し、キーボードの Delete キーを押してウィジェットを削除します。 または、ウィジェットを右クリックします。 その後、 [削除] をクリックします。
結果のダウンロード
データセットを CSV、TSV、または Excel ファイルとしてダウンロードできます。 キャンバス上の視覚エフェクトを PNG ファイルとしてダウンロードできます。
- [キャンバス] タブからダウンロード オプションを開くには、ウィジェットの右上隅にある
ケバブ メニューをクリックします。
- [データ] タブからダウンロード オプションを開くには、データセットの右側にある
ケバブ メニューをクリックします。
CSV および TSV 形式では最大約 1 GB の結果データを、Excel ファイルには最大 100,000 行をダウンロードできます。 最終的なファイル ダウンロードよりも前の手順に 1 GB の制限が適用されるため、最終的なファイル ダウンロード サイズは 1 GB よりも多少増減する場合があります。
ダッシュボードで下書きと共同作業を行う
新しいダッシュボードは下書きとして開始されます。 下書きをワークスペース内の他のユーザーと共有して共同作業を行うことができます。 下書きダッシュボードをワークスペースの外部のユーザーと共有することはできません。 すべてのユーザーは、自分自身の資格情報を使用して、ダッシュボードの下書きのデータと視覚化を操作します。
アクセス許可レベルの詳細については、「Dashboard ACL」を参照してください。
ダッシュボードの発行
ダッシュボードを発行して、現在の下書きのクリーンなコピーを作成します。 ダッシュボードを発行するには、少なくとも CAN EDIT アクセス許可が必要です。
ダッシュボードを発行すると、発行済みバージョンは、下書きに変更を加えた場合でも再度発行するまでそのままとなります。 公開されたコピーに影響を与えることなく、下書きバージョンを変更および改善できます。 発行されたダッシュボードへのアクセス権を持つ登録済みユーザーは、発行済みバージョンを引き続き表示できます。 発行済みバージョンは引き続きサブスクライバーにメール送信されます (存在する場合)。
ダッシュボードを公開するときに、資格情報を埋め込むかどうかを選択できます。
- 資格情報を埋め込む: 公開されたダッシュボードのすべての閲覧者は、データとコンピューティングに対する自分の資格情報を使ってクエリを実行できます。 これにより、ユーザーは、元のワークスペース、基になるデータ、SQL ウェアハウスにアクセスできない場合でもダッシュボードを表示できます。 これにより、データへの直接アクセスが許可されていないユーザーにデータが公開される可能性があります。 既定のオプションです。
- 資格情報を埋め込まない: 公開されたダッシュボードのすべての閲覧者は、自分自身のデータとコンピューティングの資格情報を使ってクエリを実行します。 閲覧者がダッシュボードの結果を表示するには、ワークスペース、アタッチされた SQL ウェアハウス、および関連するデータへのアクセス権が必要です。
選択する設定に関する推奨事項については、「公開済みダッシュボードを共有する」を参照してください。
ダッシュボードを公開するには、次の手順を実行します。
- ダッシュボードを開きます。 ダッシュボードが以前に公開されている場合は、公開済みバージョンが開きます。 必要に応じて、ページの上部にあるスイッチャーを使用して、現在の下書きバージョンを確認します。
- [発行] をクリックします。 [発行] ダイアログが表示されます。
- 発行されたダッシュボードに対して使用する資格情報を選択します。 資格情報を埋め込むかどうかを選択できます。
- [発行] をクリックします。 ダッシュボードを初めて公開する場合は、[共有] ダイアログが開き、公開済みダッシュボードを共有するように求められます。 共有の詳細と推奨事項については、「ダッシュボードの共有」を参照してください。
発行済みダッシュボードにアクセスするには、ダッシュボードの上部付近にあるドロップダウン メニューの [発行済み] をクリックします。
定期的な更新のためのダッシュボードのスケジュール
スケジュールされた更新を設定して、ダッシュボードを自動的に更新し、必要に応じて、そのスケジュールをサブスクライブしているユーザーに最新のダッシュボードの PDF を含むメールを送信できます。
少なくとも CAN EDIT 権限を持つユーザーは、公開されたダッシュボードの埋め込み認証情報を定期的に実行するように、スケジュールを作成できます。 各ダッシュボードには、最大 10 個のスケジュールを設定できます。
スケジュールされたダッシュボードの更新ごとに、次の処理が行われます。
- データセットを定義するすべての SQL ロジックは、指定された時間間隔で実行されます。
- 結果はクエリ結果キャッシュに入力され、ダッシュボードの初期読み込み時間を短縮するのに役立ちます。
スケジュールを作成するには
ダッシュボードの右上隅にある [スケジュール] をクリックします。 [スケジュールの追加] ダイアログが表示されます。
ドロップダウン セレクターを使用して、頻度とタイム ゾーンを指定します。 必要に応じて、[Cron 構文の表示] チェックボックスをオンにして、[Quartz Cron 構文] でスケジュールを編集します。
Create をクリックしてください。 [スケジュール] ダイアログが表示され、作成したスケジュールが表示されます。 このダッシュボードに他のスケジュールが存在する場合は、ダイアログにもそのスケジュールが表示されます。
必要に応じて、[サブスクライブ] をクリックして自分自身をサブスクライバーとして追加すると、スケジュールされた実行の完了後にダッシュボードの PDF スナップショットを含む電子メールが送信されます。
Note
このダッシュボードのスケジュールが既に作成されている場合は、右上隅のボタンに [サブスクライブ] と表示されます。 前に説明したワークフローを使用して、スケジュールを追加できます。
サブスクリプションの管理
スケジュールのサブスクライバーは、スケジュールが実行されるたびに現在のダッシュボードの PDF スナップショットを含む電子メールが送信されます。 対象となるサブスクライバーには、ワークスペース ユーザーと電子メール通知の送信先が含まれます。
Note
メール サブスクライバーを追加できない場合は、ワークスペース管理者がワークスペースのメール通知をオフにしている可能性があります。 「ダッシュボード管理ガイド」を参照してください。
ワークスペース管理者は、サブスクライバーとして選択する前に電子メール通知先を定義する必要があります。 詳細については、「通知の送信先を管理する」を参照してください。 アカウント ユーザー、配布リスト、アカウントの外部のユーザー (パートナーやクライアント組織のユーザーなど) はすべて、メール通知先として構成し、サブスクライブできます。 ただし、直接サブスクライブすることはできません。
重要
サブスクリプション リストには、最大 100 人のサブスクライバーを含めることができます。 電子メール通知の送信先は、送信するメールの数に関係なく、1 人のサブスクライバーとしてカウントされます。
ダッシュボードで少なくとも CAN EDIT 権限を持っている場合は、更新プログラムを受け取る他のサブスクライバーを追加および削除できます。 ダッシュボードで少なくとも CAN VIEW 権限を持っている場合は、既存のスケジュールに自分自身をサブスクライバーとして追加および削除できます。
他のユーザーをサブスクライブするには、次の手順を実施します。
- ダッシュボードの右上隅にある [サブスクライブ] をクリックします。 [スケジュール] ダイアログが表示されます。
- サブスクライバーを追加するスケジュールを指定します。 そのスケジュールの右側にある
をクリックします。 [編集]をクリックします。
Note
このコンテキストメニューはスケジュールの一時停止や削除にも使用できます。
スケジュールが割り当てられているダッシュボードへの CAN VIEW アクセス権を持っている場合は、スケジュールされた実行が発生するたびに更新プログラムを受信するように自分自身でサブスクライブできます。
既存のスケジュールを自分自身でサブスクライブするには、次の手順を実施します。
- ダッシュボードの右上隅にある [サブスクライブ] ボタンをクリックします。 [スケジュール] ダイアログには、ダッシュボードのすべてのスケジュールが表示されます。
- 選択したスケジュールの右側にある [サブスクライブ] をクリックします。
サブスクライバーとして自分自身を追加できない場合は、次の理由をご確認ください。
ワークスペース管理者が、ワークスペースの [ダッシュボード サブスクリプションを有効にする] オプションをオフにしました。
この設定は、他のすべての設定よりも優先されます。 ワークスペース管理者がこの設定をオフにした場合でも、ダッシュボードの編集者はスケジュールを割り当てることができますが、サブスクライバーを割り当てることはできません。
ダッシュボードは、埋め込み資格情報とは共有されません。
埋め込み資格情報なしで共有されたダッシュボードにはスケジュールを割り当てることができないため、サブスクライバーを割り当てることはできません。
ワークスペースへのアクセス許可がありません。
アカウント ユーザーは、電子メール通知の送信先としてのみサブスクライバーを追加できます。 アカウント ユーザーのダッシュボードには [サブスクライブ] ボタンはありません。
スケジュールが定義されていません。
スケジュールが定義されていないダッシュボードの場合、ダッシュボードに対して CAN VIEW アクセス権または CAN RUN アクセス権を持つワークスペース ユーザーは、[サブスクライブ] ボタンを操作できません。
電子メールの更新プログラムのサブスクライブを解除する
サブスクライバーは、スケジュールからのサブスクライブを解除することで、電子メールの受信を停止できます。
ダッシュボード UI を使用してサブスクライブを解除するには、次の手順を実施します。
- ダッシュボードの右上隅にある [サブスクライブ] ボタンをクリックします。 [スケジュール] ダイアログには、ダッシュボードのすべてのスケジュールが表示されます。
- [サブスクライブ済み] をクリックしてサブスクライブを解除します。 ボタンのテキストが [サブスクライブ] に変わります。
スケジュールされた更新プログラムのサブスクライブを解除するには、電子メール フッターの [サブスクライブ解除] リンクを使用します。
Note
電子メール通知用に設定された大規模な配信リストに含まれているユーザーが、電子メール フッターのリンクを使用してサブスクライブ解除を選択すると、そのアクションによって配信リスト全体がサブスクライブ解除されます。 グループ全体がサブスクリプションから削除され、今後の PDF スナップショットの更新を受け取らなくなりいます。
サブスクリプションのダッシュボード サイズの制限
ダッシュボード サブスクリプション メールには、base64 でエンコードされた次のファイルが含まれます。
- PDF: ダッシュボード全体を含む PDF ファイル。
- DesktopImage: デスクトップ コンピューターでの表示に最適化されたイメージ ファイル。
2 つのファイルの合計サイズには最大 9 MB の制限が課せられます。 結合されたファイル サイズが制限を超えた場合に予想される動作の概要について次に説明します。
- PDF ファイルが 9 MB を超える場合: サブスクリプション メールには PDF の添付ファイルや画像は含まれません。 これには、ダッシュボードがサイズ制限を超えたという注意と、現在のダッシュボードの実際のファイル サイズが表示されます。
- 結合されたファイル サイズが 9 MB を超える場合: PDF のみがメールに添付されます。 インライン メッセージにはダッシュボードへのリンクが含まれますが、画像はありません。
ダッシュボードのエクスポート、インポート、または置換
ダッシュボードをファイルとしてエクスポートおよびインポートして、さまざまなワークスペース間で編集可能なダッシュボードを共有しやすくできます。 ダッシュボードを別のワークスペースに転送するには、ファイルとしてエクスポートしてから、新しいワークスペースにインポートします。 ダッシュボード ファイルをその場で置き換えることもできます。 つまり、ダッシュボード ファイルを直接編集した場合、そのファイルを元のワークスペースにアップロードして、既存の共有設定を維持しながら、既存のファイルを上書きすることができます。
次の手順では、UI でダッシュボードをエクスポートおよびインポートする方法について説明します。 Databricks API を使用して、プログラムによってダッシュボードをインポートおよびエクスポートすることもできます。 POST /api/2.0/workspace/import を参照してください。
ダッシュボード ファイルをエクスポートする
- 下書きダッシュボードで、画面の右上隅にある
kebab メニューをクリックし、[Export dashboard]\(ダッシュボードをエクスポート\) をクリックします。
- [ダッシュボードのエクスポート] ダイアログを使用して、アクションを確定するかキャンセルします。 エクスポートが成功すると、
.lvdash.json
ファイルが Web ブラウザーの既定のダウンロード ディレクトリに保存されます。
ダッシュボード ファイルをインポートする
- ダッシュボード リスト ページで、
> [Import dashboard from file]\(ファイルからダッシュボードをインポート\) をクリックします。
- [ファイルの選択] をクリックしてローカル ファイル ダイアログを開き、インポートする
.lvdash.json
ファイルを選択します。 - [Import dashboard]\(ダッシュボードのインポート\) をクリックして、ダッシュボードを確認して作成します。
インポートされたダッシュボードは、ユーザー フォルダーに保存されます。 同じ名前のインポートされたダッシュボードが既にその場所にある場合は、かっこ内に囲まれた数値が追加されて一意の名前が作成され、競合は自動的に解決されます。
ファイルからダッシュボードを置換する
- 下書きダッシュボードで、画面の右上隅にある
kebab メニューをクリックし、[Replace dashboard]\(ダッシュボードを置換\) をクリックします。
- [ファイルの選択] をクリックしてファイル ダイアログを開き、インポートする
.lvdash.json
ファイルを選択します。 - [上書き] をクリックして、既存のダッシュボードを上書きします。
REST API を使用したダッシュボードの管理
Azure Databricks REST API を使用してダッシュボードを管理する方法を示すチュートリアルについては、「Azure Databricks API を使用してダッシュボードを管理する」を参照してください。 付属のチュートリアルでは、従来のダッシュボードを Lakeview ダッシュボードに変換する方法と、それらを作成、管理、共有する方法について説明しています。
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示