笔记本源代码管理和部署

本文介绍 Git 集成和部署管道如何适用于 Microsoft Fabric 中的笔记本。了解如何设置与存储库的连接，如何管理笔记本以及如何在不同的环境中部署笔记本。

笔记本 Git 集成

Fabric 笔记本提供 Git 集成，用于通过 Azure DevOps 进行源代码控制。借助 Git 集成，可以对笔记本进行备份和版本控制，根据需要还原到以前的阶段，使用 Git 分支协作或单独工作，并在 Fabric 中完全管理笔记本内容生命周期。

重要

此功能目前为预览版。

从工作区设置中，可以轻松设置到存储库的连接，以提交和同步更改。若要设置连接，请参阅 Git 集成入门。连接后，各种项（包括笔记本）将显示在“源代码”控制面板中。

成功将笔记本实例提交到 Git 存储库后，可在存储库中看到笔记本文件夹结构。

现在可以执行将来的操作，例如“创建拉取请求”。

下图是存储库中每个笔记本项的文件结构示例：

将笔记本项提交到 Git 存储库时，笔记本代码将转换为源代码格式，而不是标准的 .ipynb 文件。例如，PySpark 笔记本转换为 notebook-content.py 文件。通过这种方法，可以使用内置差异功能更轻松地进行代码评审。

在项内容源文件中，元数据（包括默认湖屋和附加环境）、markdown 单元格和代码单元会被保留并加以区分。当同步回 Fabric 工作区时，此方法支持精确恢复。

同步到 Git 时不包括笔记本单元输出。

注意

目前，笔记本资源中的文件不会提交到存储库。即将发布的版本中支持提交这些文件。
从存储库同步到 Fabric 工作区时，附加环境将持久保留在笔记本中。目前不支持跨工作区引用环境。必须手动附加到新环境或工作区默认设置才能运行笔记本。
从存储库同步到 Fabric 工作区时，默认湖屋 ID 将保留在笔记本中。如果使用默认湖屋提交笔记本，则必须手动引用新创建的湖屋项。有关详细信息，请参阅湖屋 Git 集成。

还可以使用部署管道跨不同环境（例如开发、测试和生产）部署笔记本代码。借助此功能，可以简化开发过程，确保质量和一致性，并通过轻量级、低操作操作减少手动错误。还可以使用部署规则来自定义部署笔记本时的行为，例如更改笔记本的默认湖屋。

重要

此功能目前为预览版。

使用部署管道，完成以下步骤来完成笔记本部署。