Important
此功能在 Beta 版中。
Git 文件夹 Serverless 提供一个供 Git 文件夹中各项资产共享的无服务器计算资源，包括笔记本和文件。 使用 Git 文件夹 Serverless 进行多文件创作，无需启动新的无服务器计算资源，也无需为每个笔记本或文件设置环境。 环境由位于 Git 文件夹根目录的 pyproject.toml 文件管理。
要求
要使用 Git Folder Serverless：
- 你的项目必须放在 Git文件夹里。
- 你必须在Git文件夹编辑器中打开Git文件夹。
- 如果 Git 文件夹包含根
pyproject.toml文件，environment_version必须设置为5或更高。
共享计算与环境
- 同一 Git 文件夹中的笔记本和文件会附加到同一个 Git 文件夹无服务器计算资源，并使用由
pyproject.toml管理的环境。 - 只有关联的 Git 文件夹内的资产可以附加到计算资源上。
- 一个笔记本中定义的 Python 变量在另一个笔记本中不可用。
- 从Git文件夹中任何附带的笔记本或文件打开的 网页终端 ，运行在同一计算资源上。
在 Git 文件夹编辑器中使用 Git Folder Serverless
在工作区侧边栏，点击 工作区 ，进入Git文件夹。
点击 编辑器中打开。
在Git文件夹里打开一个笔记本或文件。
点击“Compute”下拉菜单。
选择 无服务器的Git文件夹。
运行笔记本或文件启动计算资源。
要使用其他资源的同样计算，请在同一Git文件夹中打开另一个笔记本或文件，选择 Git文件夹无服务器。 这些资产共享由 pyproject.toml 管理的计算资源和环境。
使用 pyproject.toml 管理环境
Git Folder Serverless 通过位于文件夹根目录的 pyproject.toml 文件管理整个 Git 文件夹的 Python 依赖项。 这与标准无服务器笔记本不同，后者在 环境 侧面板中配置的依赖关系适用于一个笔记本。
你可以通过笔记本命令或编辑 pyproject.toml 来添加依赖项并应用环境更改。
使用笔记本命令
打开附加到 Git Folder Serverless 的笔记本。
检查 Git 文件夹根目录下是否存在
pyproject.toml文件。 如果没有，打开 环境 侧面板，点击 创建pyproject.toml。运行
%uv add <package>以将依赖项添加到根pyproject.toml文件中。 例如：%uv add cowsay运行
%uv sync以将依赖应用到共享环境，生成或更新uv.lock。%uv sync
编辑 pyproject.toml
在 Git 文件夹编辑器中，检查 Git 文件夹的根目录中是否存在
pyproject.toml文件。 如果没有，打开 环境 侧面板，点击 创建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 无服务器文件夹。
更新后的环境可用于附加到同一 Git 文件夹无服务器计算资源的笔记本和文件。 要检查环境，打开 环境 侧面板。 有关无服务器环境版本和已安装依赖的信息，请参见 配置无服务器环境 。
通过 Git 协作
只有启动 Git 文件夹无服务器计算资源的用户才能在其上运行工作负载。 如果其他用户打开同一个Git文件夹，他们将被阻止在现有计算资源上运行笔记本或文件。
Databricks 建议每位协作者将仓库克隆到各自个人工作区文件夹下的 Git 文件夹中。 随后，每位协作者都会为其克隆体获得一套由 pyproject.toml 管理的独立计算资源和环境。
通过分支、提交、推送和拉取来通过远程 Git 仓库交换变更。 参见 “在Git文件夹中协作”。
局限性
- 计算共享的范围限定在无服务器使用策略内。 同一个Git文件夹中使用不同使用策略的笔记本和文件会被分配不同的计算资源，而不是共享一个。