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

注：

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

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

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

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

注：

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

必要なアクセス許可

レガシーダッシュボードと、クエリベースのダッシュボードリストをサポートするクエリを含むすべてのアップストリームクエリに対して、少なくとも「表示可能」権限を持っている必要があります。従来のダッシュボードは、Databricks SQL クエリとダッシュボードのアクセス許可を個別に処理します。アップストリームクエリに対するアクセス許可が不十分な場合、複製操作は失敗します。

ダッシュボードに複製

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

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

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

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

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

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

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

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

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

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

レガシーを調整する

ダッシュボード (以前のLakeviewダッシュボード) は、に対する限定的なサポートを提供します。ウィジェットごとのフィルターはサポートされていません。次のタイプはサポートされていません:

ドロップダウンリスト
クエリベースのドロップダウンリスト
日付範囲

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

ウィジェットを操作する

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

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

データセットで作業する

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

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

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

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

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