次の方法で共有

レガシ ダッシュボードを AI/BI ダッシュボードに複製する

  • [アーティクル]

重要

  • Databricks では、AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) を使用することを推奨しています。 以前のバージョンのダッシュボード (以前は Databricks SQL ダッシュボードと呼ばられていた) は、 legacy ダッシュボードと呼ばれるようになりました。 Databricks は、新しいレガシ ダッシュボードの作成を推奨していません。
  • 移行ツールまたは REST API を使用して、レガシ ダッシュボードを変換します。 組み込み移行ツールの使用方法については、「レガシ ダッシュボードを AI/BI ダッシュボードに複製する」を参照してください。 REST API を使用したダッシュボードの作成と管理に関するチュートリアルについては、ダッシュボードのチュートリアルを参照してください。

この記事では、既存のレガシ ダッシュボードを複製して、新しいドラフト ダッシュボードを作成する方法を説明します。 [AI/BI ダッシュボードに複製する] は、変換プロセスを簡素化する UI のメニュー オプションです。 AI/BI ダッシュボードへの複製は、最大 100 個のウィジェットを含むレガシ ダッシュボードでサポートされています。

このボタンを使って新しいダッシュボードを作成しても、元のレガシ ダッシュボードやクエリには影響しません。 代わりに、このプロセスでは、基になるクエリとウィジェットの設定を使って、同等のダッシュボードを作成します。

Note

AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) では、レガシ ダッシュボードのすべての機能がサポートされるわけではありません。 使用できる機能については、「ダッシュボード」をご覧ください。

必要なアクセス許可

レガシ ダッシュボードと、クエリべースのドロップダウン リスト パラメーターをサポートするものなどのすべてのアップストリーム クエリに対して、少なくとも "表示アクセス許可" が必要です。 レガシ ダッシュボードは、Databricks SQL クエリとダッシュボードのアクセス許可を個別に処理します。 アップストリーム クエリのアクセス許可が不十分であるため、クローン操作に失敗しました。

AI/BI ダッシュボードに複製する

次のアニメーションでは、正常な変換を示しています。

変換プロセスを示す Gif

ダッシュボードの複製を行うには、次の手順を実行します。

  1. [AI/BI ダッシュボードに複製する] をクリックします。

    [AI/BI ダッシュボードに複製する] オプションには、次の UI の領域からアクセスできます。

    • ワークスペース ファイル ブラウザー。

      ダッシュボード タイトルを右クリックし、[AI/BI ダッシュボードに複製する] をクリックします。 または、ケバブ メニュー ケバブ メニューを使用して同じオプションにアクセスします。

    • レガシ ダッシュボード。

      • 保存したダッシュボードを表示する場合: 既存のレガシ ダッシュボードのケバブ メニューケバブ メニューから [AI/BI ダッシュボードに複製する] をクリックします。
      • 保存したダッシュボードを編集する場合: ケバブ メニュー ケバブ メニューをクリックし、[AI/BI に複製する] をクリックします。

  2. (省略可能) 新しいダッシュボードのタイトルとフォルダーの場所を指定します。

    既定では、新しいダッシュボードは、元のタイトルに (AI/BI) が付加された元のレガシ ダッシュボードと同じフォルダーに保存されます。 この段階で、新しいダッシュボードをリタイトルし、別の宛先フォルダーを選択できます。

  3. [複製] をクリックします。

    新しいダッシュボードへのリンクを含む成功メッセージ。

操作が完了したら、画面右上に通知が表示されます。 リンクを使って、新しいダッシュボードに移動します。

複製したダッシュボード結果を確認する

複製操作が成功すると、新しいドラフト ダッシュボードが作成されます。 既存のレガシ ダッシュボードと関連クエリは変更されません。 2 つのダッシュボードは関連がなく、一方に対する更新はもう一方に影響しません。

新しいダッシュボードはドラフトとして作成されます。 フォルダー レベルで適用されている共有アクセス許可はすべて継承されます。 ソース ダッシュボードで設定されたアクセス許可は伝播されません。

すべてのダッシュボードのドラフトには、元のレガシ ダッシュボードでの既存の資格情報の設定に関係なく、自動的に閲覧者として実行の資格情報が付与されます。 ダッシュボードを発行するときに、資格情報を埋め込むかどうかを選択できます。 これは、他のユーザーがダッシュボードをどのように表示し、操作するかに影響します。 発行されるダッシュボードのアクセス許可を共有および管理する方法については、「AI/BI ダッシュボードの ACL」をご覧ください。

レガシ パラメータを調整する

パラメーターを含むクエリを含むダッシュボードを複製する場合は、名前付きパラメーター構文を使用するようにこれらのクエリを更新する必要があります。 移行ツールは、この変換を自動的に行おうとします。 構文を手動で更新するには、ウィジェットを右クリックしてクエリを開き、編集します。 構文と例については、 Syntax の変更 を参照してください。

[データ] タブで、編集するデータセットを開きます。 変換時に、レガシ ダッシュボードで使用されるクエリからのすべての口ひげ構文パラメーター ({{ }}) が、UI に表示されるパラメーターのコレクションに自動的に追加されます。

mustache 形式の構文と警告メッセージを使用して記述されたパラメータを含む、新しく変換されたデータセット クエリ。

パラメータ ウィジェットを操作する

複製操作中、すべてのレガシ ダッシュボード レベルのパラメータ ウィジェットがフィルターに変換され、新しいダッシュボード キャンバスの上部に表示されます。 日付と時刻のパラメータ ウィジェットは、日付の選択フィルター として追加され、その他すべての種類のパラメータ ウィジェットは、単一値フィルターに変換されます。

トラブルシューティングと手動の調整

AI/BI ダッシュボードでは、従来のダッシュボードで使用できるグラフの種類がすべてサポートされているわけではありません。 サポートされていない要素を含むレガシ ダッシュボードを複製すると、新しいダッシュボード上のウィジェットに元のウィジェットのコピーではなくエラー メッセージが表示されます。 一般的に、サポートされていない視覚化またはフィルターの変換からエラーが発生します。 サポートされている視覚化とフィルターについては、「 ページ、視覚エフェクト、テキスト、フィルターをキャンバスに追加する を参照してください。

エラーのあるウィジェットを含むダッシュボード。

ダッシュボードでサポートされているグラフの種類の使用方法については、「ダッシュボードの視覚化の種類」をご覧ください。