ダッシュボードのソース管理
この記事では、Databricks Git フォルダーを使用してバージョン管理と共同ダッシュボード開発を行う方法について説明します。 また、CI/CD プロセスを実装して、さまざまなワークスペース間でダッシュボードを開発およびデプロイするためのガイダンスも提供します。
プレビュー
この機能は パブリック プレビュー段階です。
概要
ダッシュボードに Databricks Git フォルダーを使用すると、変更と履歴の可視性が向上し、コラボレーションがより効率的になります。 また、ダッシュボードの本番運用へのデプロイが簡素化され、以前のバージョンの復元が可能になり、信頼性の高いバックアップソリューションとして機能します。
ダッシュボードのソース管理を有効にする
ワークスペース管理者は、 プレビュー ページからパブリック プレビューへのワークスペースのアクセスを制御できます。 デフォルトでは、 Git フォルダのダッシュボードサポート プレビューは [オン] です。
Git 統合とダッシュボードの連携
Databricks Git フォルダーを使用して、 下書き ダッシュボードの変更を追跡および管理できます。追跡ダッシュボードのすべての変更は、ダッシュボードのドラフトに反映されます。ウェアハウスの選択やスケジュールの作成など、公開とスケジュールの設定は追跡されません。これらの構成を管理するには、UI を使用するか、Databricks アセット バンドルまたは AI/BI REST API を使用して変更を自動化します。ダッシュボードとLakeview REST APIリファレンスを参照してください。
AI/BI ダッシュボードは、以前は Lakeview ダッシュボードと呼ばれていました。Lakeview API はその名前を保持します。
- ダッシュボード管理にバンドルを使用する方法の詳細については、「 ダッシュボード」を参照してください。
- REST APIを介したダッシュボードの公開とスケジューリングの詳細については、 Lakeview APIリファレンスを参照してください。
Databricks Git フォルダーは、ダッシュボードやその他のワークスペース オブジェクトの一般的な Git 操作を一元的に管理する方法を提供します。 詳細については、「 Databricks Git フォルダーの Git 統合」を参照してください。
ダッシュボードへのソース管理の適用
Git でダッシュボードを追跡するには、ダッシュボードを Databricks Git フォルダーに配置します。 次のいずれかのオプションを使用します。
- 新しいダッシュボード : 既存の Databricks Git フォルダー内にダッシュボードを作成して、最初からソース管理を適用します。
- 既存のダッシュボード : 既存のダッシュボードを Databricks Git フォルダーに移動して、Git で追跡します。
ソース管理ダッシュボードの権限の管理
他のワークスペースオブジェクトと同様に、フォルダレベルで設定された権限は、そのフォルダ内のすべてのオブジェクトに適用されます。Git フォルダ内のダッシュボードは、ダッシュボード固有の権限に加えて、親フォルダの権限を継承します。ほとんどの Git 操作を実行するために、ユーザーはCAN_MANAGE権限を持っている必要があります。詳細については、フォルダ ACL および Git フォルダ ACLを参照してください。
推奨される開発ワークフロー
ユーザーは、リポジトリを自分の Databricks Git フォルダーに複製し、機能ブランチを使用して、プル要求を送信する必要があります。次の表は、開発とデプロイのさまざまなフェーズで Git フォルダーを使用してダッシュボードを管理するための推奨事項の概要を示しています。
プロジェクトフェーズ | ワークフロー | 期待される結果 | 既知の制限事項 |
|---|---|---|---|
初期コミット |
| ダッシュボードは、リモートの Git リポジトリでソース管理されるようになりました。 | |
開発 |
|
| ダッシュボード ファイルは |
デプロイメント |
|
| リモート ブランチをワークスペース内の Git フォルダーと同期したり、Databricks Asset Bundles をリモートからダッシュボード リソースにデプロイしたりするための組み込みサポートはありません。CI/CD 自動化を設定して、以下を自動化します。 - リモートリポジトリから更新をプルします。 - 同期後のダッシュボードの公開。 - 更新後の Databricks アセット バンドルのデプロイ。 |
Databricks Git フォルダーでのコラボレーションに関するその他のベスト プラクティスについては、「 Git フォルダーでの共同作業」を参照してください。
制限
AI/BI ダッシュボードでソース管理を使用する場合は、次の制限を考慮してください。
- 1 つの Git フォルダーに最大 100 個のダッシュボードをコミットできます。この制限は、パブリック プレビュー期間中に変更される可能性があります。
- Git ベースのジョブ (ワークスペースのアセット ID やパスではなく Git URL を参照するジョブなど) はサポートされていません。
- ダッシュボードのシリアル化では長い文字列が生成されるため、プルリクエスト中の違いの読み取りとレビューが困難になります。
- ダッシュボードのファイル形式は定期的に変更され、新しいフィールドやその他の改善が含まれます。パブリック プレビュー期間中、これらの変更は、ユーザーが開始した編集とは無関係の Git の違いとして表示される場合があります。