レガシ ダッシュボード

SQL エディターを使用して、視覚化とデータにコンテキストを提供するテキスト ボックスを組み合わせるレガシ ダッシュボードをビルドできます。

レガシ ダッシュボードを表示および整理する

ワークスペース ブラウザーから、他の Azure Databricks オブジェクトと共にダッシュボードにアクセスできます。

• ワークスペース ブラウザーでダッシュボードを表示するには、サイドバーの [ワークスペース] をクリックします。 ダッシュボードは、既定で /Workspace/Users/<username> ディレクトリに保存されます。 ユーザーは、他の Azure Databricks オブジェクトと共に、ワークスペース ブラウザー内のフォルダーにダッシュボードを整理できます。

• ダッシュボードの一覧ページを表示するには、サイドバーの [ダッシュボード] をクリックします。

• レガシ ダッシュボードを 表示するには、[レガシ ダッシュボード ] タブをクリックします。

  既定では、[マイ ダッシュボード] タブが選択され、所有しているダッシュボードが時系列の逆順で表示されます。 [作成時に作成] 見出しをクリックして、リストの順序を変更します。 または、ページの上部付近にあるタブを使用して、[お気に入り]、または [すべてのダッシュボード] を表示します。 [タグ] タブを使用して、タグでフィルター処理します。

ワークスペース ブラウザーでダッシュボードをフォルダーに整理する

新しいダッシュボードと既存のダッシュボードを、他の Azure Databricks オブジェクトと共にワークスペース ブラウザーのフォルダーに整理します。 「ワークスペース ブラウザー」をご覧ください。

保存されたダッシュボードの一覧をフィルター処理する

自分が作成したダッシュボードの一覧 (個人用ダッシュボード)、お気に入り、タグで、すべてのダッシュボードをフィルター処理します。

レガシ ダッシュボードを作成する

新しいレガシ ダッシュボードを作成できなくなりました。 Databricks では、代わりに AI/BI ダッシュボードを使用することをお勧めします。 詳細については、「 ダッシュボード」を参照してください。 新しいダッシュボードを作成する手順については、「 ダッシュボードの作成」を参照してください。

レガシ ダッシュボードを複製する

レガシ ダッシュボードの複製はサポートされなくなりました。 既存のレガシ ダッシュボードを AI/BI ダッシュボードに変換するには、「 レガシ ダッシュボードを AI/BI ダッシュボードに複製する」を参照してください。

レガシ ダッシュボードでのクエリ パラメーターの使用

クエリでは、必要に応じて、パラメーターまたは静的値を利用できます。 パラメーター化クエリに基づく視覚化がダッシュボードに追加されると、次のいずれかを使用するように、視覚化を構成できます。

• ウィジェット パラメーター: ウィジェット パラメーターは、ダッシュボード内の単一の視覚化に固有であり、視覚化パネル内に表示され、指定されたパラメーター値は、視覚化の基になるクエリにのみ適用されます。
• ダッシュボード パラメーター: レガシ ダッシュボード パラメーターは、複数の視覚化に適用できます。 パラメーター化されたクエリに基づく視覚化をダッシュボードに追加すると、既定では、パラメーターはダッシュボード パラメーターとしてカウントされます。 ダッシュボード パラメーターは、ダッシュボード内の 1 つ以上の視覚化用に構成され、ダッシュボードの上部に表示されます。 ダッシュボード パラメーターに指定されたパラメーター値は、その特定のダッシュボード パラメーターを再利用する視覚化に適用されます。 ダッシュボードには複数のパラメーターを含めることができます。各パラメーターは、一部の視覚化に適用される場合があり、他の視覚化には適用されません。
• 静的値: 変更に対応するパラメーターの代わりに静的な値が使用されます。 静的値を使用すると、パラメーターの代わりに値をハード コーディングでき、以前に表示されたダッシュボードまたはウィジェットからパラメーターを "非表示" にします。

パラメーター化クエリを含む視覚化を追加する場合は、適切な鉛筆アイコン をクリックして、視覚化クエリのパラメーターのタイトルとソースを選択できます。 キーワードと既定値を選択することもできます。 「パラメーターのプロパティ」を参照してください。

ダッシュボードに視覚化を追加した後、 をクリックしてパラメーター マッピング インターフェイスにアクセスできます。ダッシュボード ウィジェットの右上にある kebab メニューをクリックし、[ ウィジェット設定の変更] をクリックします。

パラメーターのプロパティ

ダッシュボード ウィジェットパラメーターのプロパティは次のとおりです。

• タイトル: ダッシュボードの値セレクターの横に表示される表示名。 既定では、クエリ エディターでのタイトル セットに設定されます。 ダッシュボード内での表示方法を編集するには、鉛筆アイコン をクリックします。 値セレクターが非表示のため、静的ダッシュボード パラメーターのタイトルは表示されません。 [値のソース] として [静的な値] を選択した場合、[タイトル] フィールドは灰色表示されます。

• キーワード: 基になるクエリのこのパラメーターの文字列リテラル。 これは、ダッシュボードが予期した結果を返さない場合、デバッグに役立ちます。

• 既定値: 別のパラメーターが選択されて変更が適用されるまで、ダッシュボードでそのパラメーターに設定された値が読み込まれます。 この既定値を変更するには、SQL エディターで基になるクエリを開き、パラメーターを目的の値に変更し、[保存] ボタンをクリックします。

• 値のソース: パラメーター値のソース。 ソースを選択するには鉛筆アイコン をクリックします。

  • 新しいダッシュボード パラメーター: 新しいダッシュボード レベルのパラメーターを作成します。 これにより、ダッシュボードの 1 か所にパラメーター値を設定し、1 つまたは複数の視覚化にマップできます。 ダッシュボード内でパラメーターに一意の名前を付ける必要があります。
  • 既存のダッシュボード パラメーター: この視覚化のパラメーターを既存のダッシュボード パラメーターにマップします。 既存のダッシュボード パラメーターを指定する必要があります。
  • ウィジェット パラメーター: ダッシュボード ウィジェット内に値セレクターを表示します。 これは、ウィジェット間で共有されない 1 回きりのパラメーターの場合に便利です。
  • 静的な値: 他のウィジェットで使用される値に関係なく、ウィジェットの静的な値を選択します。 静的にマップされたパラメーター値では、ダッシュボードのどこにも値セレクターは表示されず、画面がよりコンパクトになります。 これにより、特定のパラメーターが頻繁に変更されないと予想される場合は、ダッシュボードのユーザー インターフェイスを煩雑にすることなく、クエリ パラメーターの柔軟性を活用することができます。

  

レガシ ダッシュボードを編集する

編集用のダッシュボードを開くには、 を開きます。ダッシュボードの右上にある kebab メニューを開き、[ 編集] を選択します。

編集中は、コンテンツの追加と削除、視覚エフェクトおよびフィルターの適用を行うことができます。 パラメーターを表示する順序を変更する場合は、各パラメーターをクリックして目的の位置にドラッグできます。

複数のクエリ間でフィルター処理する

ダッシュボード上の複数のクエリでフィルター処理するには:

1. レガシ ダッシュボードに移動します。
2. 編集モードで、[追加] をクリックし、[フィルター] をクリックします。
3. [New dashboard filter] (新しいダッシュボード フィルター) を選択し、フィルター処理するクエリと列を選択します。 [Existing query filters] (既存のクエリ フィルター) を選択し、SQL クエリ エディターからフィルターをインポートすることを選択して、既存のクエリ からフィルターをインポートすることもできます。 選択するクエリは、同じカタログとスキーマに属している必要があります。
4. [保存] をクリックします。 これにより、すべてのドロップダウン オプションの和集合を含むフィルターが作成されます。

ダッシュボードの視覚化を編集する

編集モードでダッシュボードの視覚エフェクトを編集するには、編集する視覚エフェクトを選択し、視覚化の右上にある をクリックします。 表示された一覧で、[視覚エフェクトの編集] を選択します。

ダッシュボードにコンテンツを追加する

1. 編集するためにダッシュボードを開きます。
2. [Add Textbox](テキストボックスの追加) または [ウィジェットの追加] をクリックします。
3. [レガシ ダッシュボードに追加] をクリックします。
4. [編集が完了しました] をクリックします。

SQL エディターで、ダッシュボードに視覚化を追加することもできます。

ダッシュボードからコンテンツを削除する

1. をクリックするか、オブジェクトの上にマウス ポインターを置き、をクリックします。ウィジェットの右上にある kebab メニューをクリックし、[ダッシュボードから削除] を選択します。
2. [削除] をクリックします。

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

クエリにフィルターがある場合は、ダッシュボード レベルでもフィルターを適用する必要があります。 [Use Dashboard Level Filters](ダッシュボード レベル フィルターを使用する) チェックボックスをオンにして、すべてのクエリにフィルターを適用します。

ダッシュボードの色をカスタマイズする

カラー パレットの作成など、ダッシュボードのカラー パレットをカスタマイズできます。

カラー パレットを作成する

ダッシュボードのカスタム カラー パレットを作成するには、次のようにします。

1. [ をクリックします。右上にある kebab メニューをクリックし、[ 編集] をクリックします。
2. [色] をクリックします。
3. 既存のカラー パレットをインポートするには、[インポート] をクリックしてパレットを選択します。 インポートしたパレットをカスタマイズできます。
4. 新しいパレットを作成するか、インポートしたパレットをカスタマイズするには、次のようにします。
   1. 新しい色を追加するには、[追加] をクリックします。
   2. 新しく追加された色または既存の色の場合は、次のいずれかの操作を実行して色を指定します:
      • 四角形をクリックし、カラー セレクターでクリックするかスポイトを使用して新しい色を選択します。
      • 四角形の横にあるテキスト フィールドをクリックし、16 進値を入力します。
5. [Apply] をクリックします。

カスタム カラー パレットの使用を停止する

カスタム カラー パレットを削除するには、次のようにします。

1. [ をクリックします。右上にある kebab メニューをクリックし、[ 編集] をクリックします。
2. [色] をクリックします。
3. [クリア] をクリックします。
4. [Apply] をクリックします。

視覚化に別のカラー パレットを使用する

既定では、ダッシュボードにカラー パレットが適用されている場合、すべての視覚化でそのカラー パレットが使用されます。 視覚化に異なる色を使用する場合は、この動作をオーバーライドできます。

1. [ をクリックします。ダッシュボードの視覚化の [Kebab] メニューをクリックし、[ 編集] をクリックします。
2. [Retain colors specified on visualization](視覚化で指定された色を保持する) の横にあるチェック ボックスをオンにします。
3. [OK] をクリックします。

ダッシュボードを更新する

レガシ ダッシュボードは、クエリが実行されるたびに更新されるキャッシュからデータを取得する際に、効率的な読み込みを行うように設計されています。 ただし、関連付けられているクエリを定期的に実行しないと、ダッシュボードが古くなる可能性があります。 ダッシュボードが古くなるのを防ぐために、ダッシュボードを更新して、関連付けられているクエリを再実行できます。

ダッシュボードが手動またはスケジュールに従って更新されるたびに、ダッシュボードで参照されているすべてのクエリが更新されます。 個々の視覚化が更新されると、そのアップストリーム クエリが更新されます。 ダッシュボードまたは個々の視覚化を手動で更新しても、クエリ ベース ドロップダウン リストで使用されているクエリは更新されません。 クエリ ベースのドロップダウン リストについて詳しくは、「クエリベースのドロップダウン リスト」をご覧ください。

動作と実行コンテキストを更新する

ダッシュボードが "所有者として実行" され、スケジュールが追加されると、所有者の資格情報が実行に使用され、少なくとも CAN RUN アクセス許可を持つすべてのユーザーに、更新されたクエリの結果が表示されます。

ダッシュボードが "Run as Viewer" でスケジュールが追加されると、所有者の資格情報が実行に使用されますが、更新されたクエリの結果は所有者のみが表示されます。更新されたクエリ結果を表示するには、他のすべての閲覧者が手動で更新する必要があります。

ダッシュボードを手動で最新の情報に更新する

強制的に最新の情報に更新するには、ダッシュボードの右上にある [更新] をクリックします。 これにより、ダッシュボードのすべてのクエリが実行され、その視覚化が更新されます。

ダッシュボードを自動的に最新の情報に更新する

ダッシュボードの所有者と CAN EDIT アクセス許可を持つユーザーは、スケジュールに従って自動的に更新されるようにダッシュボードを構成できます。 ダッシュボードを自動的に最新の情報に更新するには、次のようにします。

1. ダッシュボードの右上隅にある [スケジュール] をクリックします。 [スケジュールの追加]をクリックします。

2. ドロップダウン ピッカーを使用して、頻度、期間、開始時刻、タイム ゾーンを指定します。 必要に応じて、[Cron 構文の表示] チェックボックスをオンにして、[Quartz Cron 構文] でスケジュールを編集します。

3. オプションの設定を表示するには、[その他のオプション] を選択します。 次のいずれかを選択できます。

   • スケジュールの名前。
   • クエリを実行するための SQL ウェアハウス。 既定では、アドホック クエリの実行に使用される SQL ウェアハウスは、スケジュールされたジョブにも使用されます。 スケジュールされたクエリを実行する別のウェアハウスを選択するには、このオプションの設定を使用します。

   注

   このウェアハウスは、手動更新に使用されるものとは異なる場合があります。

4. 省略可能: [サブスクライバー] タブで、ダッシュボードが自動的に更新されたときに通知するメール アドレスのリストを入力します。 各メール アドレスは、ワークスペース へのアクセス権を持つ Azure Databricks アカウントに関連付けられているか、ワークスペース設定の通知先として定義されている必要があります。 通知の送信先は、ワークスペース管理者によって構成されます。

5. Create をクリックしてください。 [スケジュール] のラベルが "スケジュール(1)" に変わります。

6. 共有設定を編集します。

   注

   ダッシュボードのアクセス許可は、スケジュールのアクセス許可にリンクされていません。 スケジュールされた更新間隔を作成したら、スケジュールのアクセス許可を編集して、他のユーザーにアクセスできるようにします。 スケジュールを編集したり、サブスクライバー リストを編集したりできるのは、管理可能アクセス許可を持つユーザーだけです。

   • をクリックします。kebab メニュー。
   • [スケジュールのアクセス許可の編集] をクリックします。
   • ダイアログのドロップダウン メニューからユーザーまたはグループを選択します。
   • 選択したユーザーがスケジュール構成を表示できるようにするには、[表示可能] を選択します。

"表示可能" または "実行可能" のアクセス許可が割り当てられた受信者は、スケジュールが存在することを確認できます。また、レポートの周期やサブスクライバー数などの他のプロパティも表示できます。 管理可能が割り当てられた受信者はスケジュール、サブスクライバー リスト、スケジュールのアクセス許可を変更できます。 "管理可能" のアクセス許可が割り当てられた受信者はスケジュールを一時停止または一時停止解除することもできます。

開いているダッシュボードでの更新動作

Run as Owner に設定されているダッシュボード セットを開くと、スケジュールされていたか手動で更新されたかに関係なく、最新のダッシュボード更新からのデータが表示されます。 ブラウザー ウィンドウでダッシュボードが開いている場合、クエリが変更された場合、またはスケジュールされた実行によってダッシュボードの結果が更新された場合、変更はすぐに反映されません。 次にダッシュボードを開くか、開いているブラウザー ウィンドウを更新すると、更新された結果が表示されます。

ダッシュボード スナップショット サブスクリプション

ダッシュボード スナップショットを定期的にエクスポートし、電子メールで送信することができます。 ダッシュボード スナップショットは既定のダッシュボードの状態から取得されます。つまり、フィルターと視覚化とのやり取りはスナップショットには含まれません。

少なくとも CAN EDIT アクセス許可がある場合は、更新スケジュールを作成し、更新されるたびにダッシュボードの電子メール スナップショットを受信する他のユーザーをサブスクライブできます。 サブスクライバーを追加するには、前述のように [サブスクライバー] タブに ユーザーまたはグループを入力します。 対象となるサブスクライバーには、ワークスペース ユーザーと通知先が含まれます。

メールの添付ファイルには 6 MB のファイル サイズ制限があります。 ダッシュボード サブスクリプションのメールが 6 MB のサイズ制限を超えている場合、メールではインライン ダッシュボード スナップショットが省略され、ダッシュボード スナップショットの PDF のみが含まれます。

スナップショットの PDF ファイルが 6 MB を超えている場合、サブスクリプションのメールでは PDF が省略され、代わりに更新されたダッシュボードへのリンクが含まれます。 メールには、現在のダッシュボードのサイズの詳細を示す警告メモが表示されます。 (ユーザーは、ダッシュボードの PDF を手動でダウンロードすることで、PDF スナップショットのサイズをテストできます)。

スケジュールされたダッシュボードの更新を一時的に停止する

ダッシュボードが自動更新用に構成されていて、スケジュールに対して表示可能以上のアクセス許可を持っている場合、[スケジュール] ボタンのラベルには Schedule(#) と表示されます。ここで、# は表示されるスケジュールされたイベントの数です。 また、セキュリティに対して管理可能以上のアクセス許可がある場合は、スケジュールを一時的に一時停止できます。 これは、ダッシュボードへの変更をテストしている間に更新が送信されないようにする場合に役立ちます。 サブスクライバーの一覧を変更せずに、スケジュールされたダッシュボードの更新を一時的に停止するには次のようにします。

1. [スケジュール(#)] をクリックします。
2. をクリックします。kebab メニュー。
3. [一時停止] をクリックします。

ダッシュボードの自動更新を停止する

ダッシュボードの自動更新を停止し、そのサブスクリプションを削除するには、次のようにします。

1. [スケジュール(#)] をクリックします。
2. をクリックします。kebab メニュー>削除します。

サブスクリプションのダッシュボード サイズの制限

レガシ ダッシュボード サブスクリプション メールには、base64 でエンコードされた次のファイルが含まれます。

• PDF: ダッシュボード全体を含む PDF ファイル。
• DesktopImage: デスクトップ コンピューターでの表示に最適化されたイメージ ファイル。

2 つのファイルの合計サイズには最大 6 MB の制限が課せられます。 結合されたファイル サイズが制限を超えた場合に予想される動作の概要について次に説明します。

• PDF ファイルが 6 MB を超える場合: サブスクリプション メールには PDF の添付ファイルや画像は含まれません。 ダッシュボードがサイズ制限を超えたという注意と、現在のダッシュボードの実際のファイル サイズが表示されます。
• 結合されたファイル サイズが 6 MB を超える場合: PDF のみがメールに添付されます。 インライン メッセージにはダッシュボードへのリンクが含まれていますが、画像はありません。

PDF 形式でダウンロードする

ダッシュボードを PDF ファイルとしてダウンロードするには、 をクリックします。ダッシュボードの右上にある kebab メニューをクリックし、[ PDF としてダウンロード] を選択します。

レガシ ダッシュボードをごみ箱に移動する

ダッシュボードを [ごみ箱] に移動するには、次の操作を行います。

1. をクリックします。ダッシュボードの右上にある kebab メニューをクリックし、[ごみ箱に移動] を選択します。
2. [ゴミ箱に移動] をクリックして確認します。

ごみ箱からレガシ ダッシュボードを復元する

1. サイドバーで、[ワークスペース] をクリックします。
2. ワークスペース ブラウザーで [ごみ箱] をクリックして、囲まれたアセットを表示します。
3. をクリックします。復元するダッシュボードの横にある kebab メニュー。
4. [復元] をクリックします。 [移動] ダイアログが表示されます。
5. [移動] ダイアログを使用して、復元されたダッシュボードの新しい場所を選択します。

レガシ ダッシュボードを完全に削除する

1. サイドバーで、[ワークスペース] をクリックします。
2. ワークスペース ブラウザーで [ごみ箱] をクリックして、囲まれたアセットを表示します。
3. をクリックします。削除するダッシュボードの横にある kebab メニュー。
4. [完全に削除] をクリックします。
5. [削除] をクリックして確認します。

クエリを開く

SQL エディターでウィジェットに表示されるクエリを開くには、 をクリックします。ウィジェットの右上にある kebab メニューをクリックし、[ クエリの表示] を選択します。

レガシ ダッシュボードのアクセス許可とダッシュボードの所有権を構成する

ダッシュボードのアクセス許可レベルのアクセス許可を構成するには、ダッシュボードで "管理可能" が必要です。「レガシ ダッシュボード ACL」を参照してください。

1. サイドバーで [ダッシュボード] をクリックします。
2. ダッシュボードをクリックします。
3. 右上にある ボタンをクリックして、[共有] ダイアログを開きます。
4. グループまたはユーザーを検索して選び、アクセス許可レベルを割り当てます。
   1. 資格情報を [ビューアーとして実行] に設定して、編集可能または管理可能のアクセス許可を割り当てます。
5. 追加をクリックします。

歯車アイコンをクリックし、[すべてのクエリを共有] を選択すると、ダッシュボードに関連付けられているすべてのクエリをすばやく共有できます。 ダッシュボードによって参照されるクエリには個別のアクセス許可があり、ダッシュボードを共有するときに既定では共有されません。

レガシ ダッシュボードの所有権を譲渡する

ダッシュボードの所有者がワークスペースから削除された場合、ダッシュボードには所有者が存在しなくなります。 ワークスペース管理者ユーザーは、所有者がいないものを含め、任意のダッシュボードの所有権を別のユーザーに譲渡できます。 グループにダッシュボードの所有権を割り当てることはできません。 Permissions API を使用して所有権を譲渡することもできます。

1. ワークスペース管理者として、Azure Databricks ワークスペースにログインします。

2. サイドバーで [ダッシュボード] をクリックします。

3. ダッシュボードをクリックします。

4. 右上にある [共有] ボタンをクリックして、[共有] ダイアログを開いてください。

5. 右上にある歯車アイコンをクリックし、[新しい所有者の割り当て] をクリックします。

   

6. 所有権の割り当て先のユーザーを選択してください。

7. [Confirm]\(確認\) をクリックします。

管理者ビューにアクセスする

Azure Databricks ワークスペース管理者ユーザーには、ワークスペースにあるすべてのダッシュボードへの表示アクセス権限があります。 このビューでは、ワークスペース管理者は任意のダッシュボードを表示および削除できます。 ただし、共有設定の資格情報が [所有者として実行] に設定されている場合、ワークスペース管理者はダッシュボードを編集できません。

すべてのレガシ ダッシュボードを表示するには、次のようにします。

1. サイドバーで [ダッシュボード] をクリックします。
2. [レガシ ダッシュボード] タブをクリックします。
3. スクリーンの上部付近にある [すべてのダッシュボード] タブをクリックします。