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

Note

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

ダッシュボードは Azure Government リージョンでは使用できません。 レガシ ダッシュボードを使用してください。

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

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

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

Note

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

必要なアクセス許可

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

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

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

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

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

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

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

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

     

   • 既存のレガシ ダッシュボード。

     既存のレガシ ダッシュボードの ケバブ メニューから [Lakeview ダッシュボードに複製する] をクリックします。

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

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

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

   

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

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

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

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

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

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

ダッシュボード (旧称 Lakeview ダッシュボード) では、パラメータのサポートが制限されています。 ウィジェットごとのパラメータ フィルターはサポートされていません。 次のパラメーターの型はサポートされていません。

• 候補リスト
• クエリベースの候補リスト
• 日付範囲

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

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

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

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

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

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

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

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

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