使用 Git 的版本控制儀表板

本頁說明如何使用 Databricks Git 資料夾進行版本控制和共同作業儀錶板開發。 它還說明如何實作 CI/CD 程序，以跨不同工作區開發和部署儀表板。

概觀

Databricks Git 資料夾會追蹤儀錶板變更和歷程記錄、支援小組共同作業，並可讓您將儀錶板部署至生產環境，並復原舊版。

啟用儀錶板原始檔控制

工作區管理員可以從 預覽頁面控制工作區存取權限。 預設情況下， Git 資料夾中的支援儀表板 設定是 開啟的。

替代方案：手動版本控制

如果您無法啟用 Git 資料夾，請使用以下手動工作流程來追蹤儀表板版本：

  1. 將儀錶板導出為 JSON 檔案。 檔案格式 lvdash.json。 請參閱 「匯出、匯入或替換 儀表板」以了解匯出說明。
  2. 將該檔案新增至版本控制系統，例如 Git。
  3. 編輯檔案。 您可以直接編輯文字檔中的值，或將它上傳回您的工作區，並在 UI 中進行變更。
  4. 儲存新檔案。 如果您在 UI 中做了變更，請匯出新的檔案。 使用您的版本控制系統來追蹤儀錶板變更和版本。
  5. 更新現有的儀錶板。 從現有的草案儀錶板：
    1. 點擊右上角的 Kebab 功能表圖示，然後點擊 取代儀錶板。
    2. 點擊 [選擇檔案] 在 [從檔案取代儀錶板] 對話框中。 然後按下 覆寫。

Git 整合如何與儀表板搭配使用

Databricks Git 資料夾會追蹤和管理 草稿 儀錶板的變更。 儀表板草稿會反映追蹤儀表板中的所有變更。 Git 不會追蹤發佈和排程設定，例如倉儲選取和排程建立。 要管理這些設定，請使用 UI 或使用 Declarative Automation Bundles 或 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 資料夾中、使用功能分支，以及提交提取要求。 下表概述如何使用 Git 資料夾在開發和部署的不同階段管理儀表板。

這很重要

切換 Git 分支對儀錶板來說是具破壞性的操作。 Azure Databricks 會移除目標分支上不存在的儀錶板。 如果您切換回來，儀表板會以新的 URL 和 ID 重新出現，這會中斷已發佈的連結、書籤和 API 整合。 在切換之前驗證目標分支，然後更新所有參考。

專案階段 Workflow 預期結果 已知的限制
初始提交
  • 將儀錶板移至工作區中的 Git 資料夾。
  • 提交並推送到遠端 Git 存放庫。
 Git 會追蹤遠端存放庫中的儀表板。
發展
  • 開發人員會在個別的開發分支上建立 Git 資料夾，通常是在其主資料夾中。
  • 提交更改至開發分支。
  • 使用拉取請求將開發分支合併至主分支。
  • 開發人員獨立工作。
  • Git 會追蹤儀表板版本。
Deployment
  • 在非使用者最上層資料夾中的部署分支上建立 Git 資料夾。 請參閱 具有 Databricks Git 資料夾的 CI/CD。
  • 將變更提取至部署資料夾。
  • 從這個資料夾發布儀表板。
  • 拿掉編輯+ 存取權，並限制 Git 的更新。
  • 與使用者分享儀錶板。
  • 消費者會存取一致且已發佈的儀錶板版本。
  • 您可以與不同的對象共用相同資料夾中的儀表板。
 Databricks 並未提供內建支援以同步遠端分支與工作空間中的 Git 資料夾，也不支援從遠端部署包含儀表板資源的宣告式自動化套件。 設定 CI/CD 自動化 以自動化：
  • 從遠端存放庫提取更新。
  • 同步後發佈儀錶板。
  • 更新後部署宣告式自動化套件。

如需 Databricks Git 資料夾中共同作業的更多最佳做法，請參閱 使用 Git 資料夾共同作業。

局限性

具有 AI/BI 儀表板的原始檔控制有下列限制：

  • 以 Git 為基礎的作業 （例如參考 Git URL 而非工作區資產識別碼或路徑的作業） 不適用於儀表板。
  • 上次更新時間：