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

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

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

必要なアクセス許可

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

• 複数値の候補リスト
• 日付範囲

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

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

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

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

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

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

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

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

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