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

重要

  • Databricks では、AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) の使用を推奨しています。

  • 元の Databricks SQL ダッシュボードは、 レガシ ダッシュボードと呼ばれるようになりました。 重大なバグ修正は引き続き提供されますが、新機能で更新されることはありません。 従来のダッシュボードは、2025年後半までにサポートが終了する予定です。 Databricks では、新しいレガシ ダッシュボードを作成することはお勧めしません。

    • 移行ツールまたは REST API を使用して、従来のダッシュボードを変換します。 組み込みの移行ツールの使用手順については、「 レガシーダッシュボードを AI/BI ダッシュボードにクローニング する」を参照してください。 DatabricksAPIsを使用したダッシュボードの作成と管理に関するチュートリアルについては、 を使用したダッシュボードの管理RESTAPI を参照してください。

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

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

注:

AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) は、すべてのレガシー ダッシュボード機能をサポートしているわけではありません。 使用可能な機能については、 ダッシュボード を参照してください。

必要な権限

少なくとも、従来のダッシュボードとすべてのアップストリーム クエリ (クエリベースのドロップダウン リスト パラメーターをサポートするクエリを含む) に対する CAN VIEW アクセス許可が必要です。 従来のダッシュボードは、Databricks SQL クエリとダッシュボードのアクセス許可を別々に処理します。 アップストリーム クエリに対するアクセス許可が不十分な場合、クローン操作は失敗します。

AI/BI ダッシュボードへのクローン作成

次のアニメーションは、変換が成功したことを示しています。

変換プロセスを示すGIF

次のステップを完了して、ダッシュボードを複製します。

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

    「AI/BI ダッシュボードにクローンを作成」オプションには、UI の次の領域からアクセスできます。

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

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

    • 従来のダッシュボード。

      • 保存したダッシュボードを表示する場合 :ケバブメニュー 既存のレガシーダッシュボードの ケバブメニューから 「AI/BI ダッシュボードにクローン 」をクリックします。

      • 保存したダッシュボードを編集する場合:ケバブ ケバブメニュー メニューをクリックし、次に AI/BIにクローンします。

  2. (オプション)新しいダッシュボードのタイトルとフォルダの場所を指定します。

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

  3. [クローンを作成] をクリックします。

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

操作が完了したら、画面の右上隅にある通知を探します。 リンクを使用して、新しいダッシュボードに移動します。

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

クローニング操作が成功すると、新しいドラフトダッシュボードが作成されます。 既存のレガシ ダッシュボードと関連するクエリは変更されません。 2 つのダッシュボードは無関係であり、一方の更新は他方に影響を与えません。

新しいダッシュボードが下書きとして作成されます。 フォルダレベルで適用された共有権限を継承します。 ソース ダッシュボードで設定されたアクセス許可は反映されません。

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

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

AI/BI ダッシュボードでは、パラメーターのサポートが限定的です。 次のパラメーター タイプはサポートされていません。

  • 複数値のドロップダウンリスト

  • 日付範囲

サポートされているすべてのパラメーターの種類は、新しいダッシュボードに保持されます。 サポートされていないパラメーターの型は、デフォルトで string 値になります。 以前に設定されたデフォルト値は保持されます。

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

クローン作成操作中に、すべての従来のダッシュボード レベルのパラメーター ウィジェットがフィルターに変換され、新しいダッシュボード キャンバスの上部に表示されます。 日付と時刻のパラメーター ウィジェットは 日付ピッカー フィルターとして追加され、他のすべての種類のパラメーター ウィジェットは 1 つの値 フィルターに変換されます。

パラメーターを持つクエリを含むダッシュボードを複製すると、複製はターゲット クエリの再作成に成功しますが、成功するためには名前付きパラメーター構文を使用するようにクエリを調整する必要があります。 関連するデータセット クエリの構文を更新して、パラメーター フィルター ウィジェットに表示されるエラー メッセージをクリアする必要があります。 ウィジェットを右クリックして、接続されたデータセットクエリを開いて編集します。 構文と例については、「 クエリ パラメーターの操作 」を参照してください。

データセット内のパラメーターの操作

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

新しく変換されたデータセット クエリで、口ひげの構文と警告メッセージで記述されたパラメーターが含まれます。

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

AI/BI ダッシュボードは、従来のダッシュボードで使用可能なすべての機能またはグラフの種類をサポートしているわけではありません。 サポートされていない要素を含むレガシーダッシュボードを複製すると、新しいダッシュボードのウィジェットには、元のウィジェットのコピーではなくエラーメッセージが表示されます。 通常、サポートされていないビジュアライゼーションやフィルターの変換によってエラーが発生します。 キャンバス上のビジュアライゼーション、テキスト、フィルター ウィジェットの追加または削除を参照して、サポートされているビジュアライゼーションとフィルターを確認してください。

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

ダッシュボードでサポートされているグラフ タイプの使用方法については、 ダッシュボードの視覚化タイプ を参照してください。