使用 Git 的版本控制儀表板

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

重要

這項功能目前處於 公開預覽版。

概述

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

啟用儀錶板原始檔控制

工作區管理員可以從 [預覽] 頁面控制對公開預覽的工作區存取權。 根據預設，Git 資料夾中的支援儀錶板預覽為開啟。

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

Databricks Git 資料夾會追蹤和管理 草稿 儀錶板的變更。 儀表板草稿會反映追蹤儀表板中的所有變更。 Git 不會追蹤發佈和排程設定，例如倉儲選取和排程建立。 若要管理這些設定，請使用 UI，或者使用 Databricks Asset 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 會追蹤儀表板版本。	儀表板檔案使用 JSON 格式。 SQL 查詢顯示為單行，這會使拉取請求中的差異難以檢閱。
部署	在非使用者最上層資料夾中的部署分支上建立 Git 資料夾。 請參閱 具有 Databricks Git 資料夾的 CI/CD。 將變更提取至部署資料夾。 從這個資料夾發布儀表板。 拿掉編輯+ 存取權，並限制 Git 的更新。 與使用者分享儀錶板。	消費者會存取一致且已發佈的儀錶板版本。 您可以與不同的對象共用相同資料夾中的儀表板。	Databricks 不提供內建支援，以將遠端分支與工作區中的 Git 資料夾進行同步，或使用遠端的儀錶板資源來部署 Databricks 資產套件組合。 設定 CI/CD 自動化 以自動化： 從遠端存放庫提取更新。 同步後發佈儀錶板。 在更新之後部署 Databricks 資產套件組合。

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

局限性

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

• 您最多可以在單個 Git 資料夾中認可 100 個儀表板。 此限制可能會在公開預覽期間變更。
• 以 Git 為基礎的作業 （例如參考 Git URL 而非工作區資產識別碼或路徑的作業） 不適用於儀表板。
• 儀表板序列化會產生長字串，這使得在提取請求期間讀取和檢閱差異變得困難。
• 儀錶板檔格式會定期變更，以包含新的欄位和其他改善。 在公開預覽期間，您可能會在 Git 中看到一些不是由您主動發起的差異。