次の方法で共有

Git を使用したバージョン 管理ダッシュボード

このページでは、Databricks Git フォルダーを使用してバージョン管理とコラボレーション ダッシュボード開発を行う方法について説明します。 また、CI/CD プロセスを実装して、さまざまなワークスペースにダッシュボードを開発してデプロイする方法についても説明します。

重要

この機能は パブリック プレビュー段階です。

概要

Databricks Git フォルダーは、ダッシュボードの変更と履歴、サポート チームのコラボレーションを追跡し、ダッシュボードを運用環境にデプロイして以前のバージョンを回復できるようにします。

ダッシュボードのソース管理を有効にする

ワークスペース管理者は、[ プレビュー] ページからパブリック プレビューへのワークスペース アクセスを制御できます。 既定では、 Git フォルダー プレビューのサポート ダッシュボード は [オン] です。

Git 統合とダッシュボードの連携

Databricks Git フォルダーは、 下書き ダッシュボードの変更を追跡および管理します。 ダッシュボードの下書きには、追跡対象のダッシュボードのすべての変更が反映されます。 Git では、発行とスケジュールの構成 (倉庫の選択やスケジュール作成など) は追跡されません。 これらの構成を管理するには、UI を使用するか、Databricks アセット バンドルまたは AI/BI REST API を使用して変更を自動化します。

  • ダッシュボード管理にバンドルを使用するには、 ダッシュボードを参照してください。
  • REST API を使用してダッシュボードを発行およびスケジュールするには、 Lakeview API リファレンスを参照してください。

注

Lakeview API は、AI/BI ダッシュボードに以前の名前を使用します。

Databricks Git フォルダーは、ダッシュボードやその他のワークスペース オブジェクトに対する一般的な Git 操作を管理します。 詳細については、 Azure Databricks Git フォルダーを参照してください。

ダッシュボードへのソース管理の適用

Git を使用してダッシュボードを追跡するには、それらを Databricks Git フォルダーに配置します。 次のいずれかのオプションを使用します。

  • 新しいダッシュボード: 既存の Databricks Git フォルダー内にダッシュボードを作成し、最初からソース管理を適用します。
  • 既存のダッシュボード: 既存のダッシュボードを Databricks Git フォルダーに移動して、Git で追跡します。

ソース管理ダッシュボードのアクセス許可の管理

フォルダー レベルのアクセス許可は、ダッシュボードを含め、そのフォルダー内のすべてのオブジェクトに適用されます。 Git フォルダー内のダッシュボードは、ダッシュボード固有のアクセス許可に加えて、親フォルダーのアクセス許可を継承します。 ほとんどの Git 操作には CAN MANAGE アクセス許可が必要です。 詳細については、「フォルダー ACL と Git フォルダー ACL」を参照してください。

リポジトリを独自の Databricks Git フォルダーに複製し、機能ブランチを使用して、pull request を送信します。 次の表は、開発とデプロイのさまざまなフェーズで Git フォルダーを使用してダッシュボードを管理する方法の概要を示しています。

重要

Git ブランチの切り替えは、ダッシュボードの破壊的操作です。 Azure Databricks では、ターゲット ブランチに存在しないダッシュボードが削除されます。 切り替えると、ダッシュボードに新しい URL と ID が再び表示され、発行されたリンク、ブックマーク、API の統合が中断されます。 切り替える前にターゲット ブランチを確認し、後ですべての参照を更新します。

プロジェクト フェーズ Workflow 予想結果 既知の制限事項
初期コミット
  • ワークスペース内の Git フォルダーにダッシュボードを移動します。
  • リモート Git リポジトリにコミットしてプッシュします。
 Git は、リモート リポジトリ内のダッシュボードを追跡します。
発達
  • 開発者は、Git フォルダーを別々の開発ブランチ (通常はホーム フォルダー) に作成します。
  • 開発ブランチに変更をコミットします。
  • Pull Request を使用して開発ブランチをメイン ブランチにマージします。
  • 開発者は独立して作業します。
  • Git では、ダッシュボードのバージョンが追跡されます。
 ダッシュボード ファイルでは、 JSON 形式が使用されます。 SQL クエリは 1 行で表示されるため、プル要求での差分の確認が困難になる可能性があります。
デプロイメント
  • ユーザー以外の最上位フォルダー内のデプロイ ブランチに Git フォルダーを作成します。 Databricks Git フォルダーを使用した CI/CD を参照してください。
  • 展開フォルダーに変更をプルします。
  • このフォルダーからダッシュボードを発行します。
  • Edit+ アクセスを削除し、Git への更新を制限します。
  • コンシューマーとダッシュボードを共有します。
  • コンシューマーは、一貫性のある公開バージョンのダッシュボードにアクセスします。
  • 同じフォルダー内のダッシュボードを異なる対象ユーザーと共有できます。
 Databricks では、リモート ブランチをワークスペース内の Git フォルダーと同期したり、リモートからダッシュボード リソースを使用して Databricks アセット バンドルをデプロイしたりするための組み込みのサポートは提供されていません。 CI/CD オートメーションを設定して自動化します。
  • リモート リポジトリから更新を取得しています。
  • 同期後のダッシュボードの発行。
  • 更新後の Databricks アセット バンドルのデプロイ。

Databricks Git フォルダーでのコラボレーションに関するベスト プラクティスの詳細については、「 Git フォルダーを使用した共同作業」を参照してください。

制限

AI/BI ダッシュボードを使用したソース管理には、次の制限があります。

  • 1 つの Git フォルダーに最大 100 個のダッシュボードをコミットできます。 この制限は、パブリック プレビュー中に変更される可能性があります。
  • Git ベースのジョブ (ワークスペース資産 ID やパスの代わりに Git URL を参照するジョブなど) は、ダッシュボードでは機能しません。
  • ダッシュボードのシリアル化では長い文字列が生成されるため、プル要求時の読み取りと確認の違いが困難になります。
  • ダッシュボード ファイルの形式は、新しいフィールドやその他の機能強化を含むように定期的に変更されます。 パブリック プレビュー中、これらの変更は、開始しなかった Git の違いとして表示される場合があります。
  • Last updated on