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

注：

AI/BI ダッシュボード (旧 Lakeview ダッシュボード) が一般提供されました。

Databricks では、最新のツールを使用して新しいダッシュボードを作成することをお勧めします。「ダッシュボード」を参照してください。
オリジナルの Databricks SQL ダッシュボードは、現在、レガシーダッシュボードと呼ばれています。これらは引き続きサポートされ、重大なバグ修正で更新されますが、新機能は制限されます。レガシダッシュボードは、作成と使用の両方に引き続き使用できます。
移行ツールまたは REST API を使用して、従来のダッシュボードを変換します。組み込みの移行ツールの使用方法については、「レガシーダッシュボードを Lakeview ダッシュボードに複製する」を参照してください。 DatabricksAPIsを使用してダッシュボードを作成および管理する方法については、「RESTAPI を使用してダッシュボードを管理する」を参照してください。

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

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

注：

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

必要なアクセス許可

従来のダッシュボードと、バッキングクエリベースのドロップダウンリストを含むすべての上流クエリに対する少なくともCAN VIEW権限が必要です。従来のダッシュボードは、Databricks SQL クエリとダッシュボードのアクセス許可を個別に処理します。アップストリームクエリに対するアクセス許可が不十分な場合、クローン操作は失敗します。

ダッシュボードに複製

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

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

「Lakeview ダッシュボードに複製」をクリックします。

UI の次の領域から、Lakeview ダッシュボードへのクローン作成オプションにアクセスできます。
- ワークスペースファイルブラウザー。
  
  ダッシュボードのタイトルを右クリックし、 [Lakeview ダッシュボードに複製] をクリックします。または、ケバブメニューを使用して、同じオプションにアクセスします。
- レガシダッシュボード。
  - 保存したダッシュLakeviewを表示する場合：既存のレガシーダッシュボード上のケバブメニュー。
  - 保存したダッシュボードを編集する場合: 画面の右上隅近くにある「Lakeview に複製」をクリックします。
(オプション)新しいダッシュボードのタイトルとフォルダーの場所を指定します。

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

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

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

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

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

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

レガシーを調整する

AI/BIダッシュボードは、問題に対する限定的なサポートを提供します。次のタイプはサポートされていません。

複数値のドロップダウンリスト
日付範囲

サポートされているすべての org タイプは新しいダッシュボードに保持されます。サポートされていない引数タイプはstring値にデフォルト設定されます。以前に設定されたデフォルト値は保持されます。

ウィジェットを操作する

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

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

データセットで作業する

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

引数が mustache 構文と警告メッセージで記述された、新しく変換されたデータセットクエリ。

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

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

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