Important
這項功能位於 測試版 (Beta) 中。
Git Folder Serverless 提供單一無伺服器計算資源,供 Git 資料夾中的各項資產共用,包括筆記本和檔案。 使用 Git Folder Serverless 進行多檔案創作,無需啟動新的無伺服器運算資源,也不必為每個筆記本或檔案設定環境。 該環境由位於 Git 資料夾根目錄的 pyproject.toml 檔案管理。
Requirements
若要使用 Git Folder Serverless:
- 你的專案必須放在 Git 資料夾裡。
- 你必須在 Git 資料夾編輯器中開啟 Git 資料夾。
- 如果 Git 資料夾包含位於根目錄的
pyproject.toml檔案,則必須將environment_version設為5或更新版本。
共享運算與環境
- 同一個 Git 資料夾中的筆記本和檔案會附加至一個 Git Folder 無伺服器運算資源,並使用由
pyproject.toml管理的環境。 - 只有相關 Git 資料夾內的資產能附加到運算資源。
- 一個筆記本中定義的 Python 變數,在另一個筆記本中無法使用。
- 從 Git 資料夾中任何附帶的筆記本或檔案開啟 的網頁終端機 ,都會在同一個運算資源上執行。
在 Git 資料夾編輯器中使用 Git 資料夾無伺服器功能
在工作區側邊欄,點選 工作區 ,然後進入 Git 資料夾。
點擊 在編輯器中開啟。
在 Git 資料夾裡打開筆記本或檔案。
點擊計算下拉選單。
選擇 Git 資料夾無伺服器。
執行筆記本或檔案來啟動運算資源。
若要使用與另一個資產相同的運算資源,請在同一個 Git 資料夾中開啟另一個筆記本或檔案,然後選取 Git Folder Serverless。 資產共享運算,環境則由 pyproject.toml管理。
使用 pyproject.toml 管理環境
Git Folder Serverless 透過位於資料夾根目錄的 pyproject.toml 檔案,管理整個 Git 資料夾的 Python 相依性。 這與標準無伺服器筆記本不同,後者在 環境 側面板設定的相依關係會套用到同一本筆記本。
你可以用筆記本指令或編輯 pyproject.toml來新增相依性並套用環境變更。
使用筆記本指令
打開一個附在 Git 資料夾 Serverless 的筆記本。
檢查 Git 資料夾的根目錄中是否存在
pyproject.toml檔案。 如果沒有,打開 環境 側窗格並點 選 Create pyproject.toml。執行
%uv add <package>後可以為根pyproject.toml檔案新增相依。 例如:%uv add cowsay執行
%uv sync以將相依套用到共享環境,並產生或更新uv.lock。%uv sync
編輯 pyproject.toml
在 Git 資料夾編輯器中,檢查 Git 資料夾的根目錄中是否存在
pyproject.toml檔案。 如果沒有,打開 環境 側窗格並點 選 Create pyproject.toml。開啟
pyproject.toml檔案。手動編輯
dependencies清單。 例如:[project] name = "my-project" version = "0.1.0" dependencies = [ "simplejson==3.18.1", ] [tool.databricks.environment] environment_version = "5"在檔案編輯器頂端
pyproject.toml,點擊 套用 ,將環境變更套用到 Git 資料夾 Serverless。
更新後的環境可供綁定在同一 Git 資料夾無伺服器運算平台上的筆記本和檔案使用。 要檢查環境,打開 環境 側窗格。 請參閱 「配置無伺服器環境 」以了解無伺服器環境版本及已安裝相依關係的資訊。
透過 Git 協作
只有啟動 Git 資料夾無伺服器運算資源的使用者才能在該資源上執行工作負載。 如果其他使用者打開相同的 Git 資料夾,他們將被阻止在現有的運算資源上執行筆記本或檔案。
Databricks 建議每位協作者將 該儲存庫複製 到個人工作區資料夾中的 Git 資料夾中。 接著,每位協作者都會為其複本獲得一組由 pyproject.toml 管理的獨立運算資源和環境。
透過遠端 Git 儲存庫,使用分支、提交、推送和拉取來交換變更。 請參見 「在 Git 資料夾中協作」。
Limitations
- 運算共享的適用範圍以 無伺服器使用政策 為限。 同一個 Git 資料夾裡使用不同使用策略的筆記本和檔案會被分配不同的運算資源,而不是共用一個。