用户数据函数源代码管理和部署

本文介绍 Git 集成和部署管道如何在 Microsoft Fabric 的用户数据函数中工作。 通过 Git 集成,你可以使 Fabric 工作区与存储库分支保持同步,使你能够对用户数据功能进行版本控制,使用分支和拉取请求进行协作,并在首选的 Git 工具(如 Azure DevOps)中使用代码。

请参阅 Git 集成的基本概念,详细了解将 Git 与 Microsoft Fabric 工作区集成的过程。

设置连接

从工作区设置中,可以轻松设置到存储库的连接,以提交和同步更改。 若要设置连接,请参阅 Git 集成入门。 连接后,你的项(包括用户数据函数)显示在“源代码管理”窗格中

屏幕截图显示源代码管理中具有未提交的更改的用户数据函数项。

成功将用户数据函数项提交到 Git 存储库后,可在存储库中看到用户数据函数文件夹。 现在可以执行将来的操作,例如创建拉取请求。

Git 中的用户数据函数表示形式

下图显示了存储库中每个用户数据函数项的文件结构示例。

显示存储库中用户数据函数项的文件夹结构的屏幕截图。

文件夹结构包括以下元素:

  • .platform: 文件包含以下属性:.platform

    显示用户数据函数项的平台文件的屏幕截图。

    • version:系统文件的版本号。 此号码用于启用向后兼容性。 项的版本号可能不同。
    • logicalId:自动生成的跨工作区标识符,表示项及其源代码管理表示形式
    • type: 是用于定义用户数据函数项的类型UserDataFunction
    • displayName:表示项的名称。 重命名用户数据函数项时,会更新此 displayName。
  • definitions.json:此文件共享所有用户数据函数项定义(如连接、库等),作为用户数据函数项属性的表示形式

    显示用户数据函数项的 definitions.json 文件的屏幕截图。

  • function-app.py:此文件是函数代码。 对用户数据函数项所做的任何代码更改都通过此文件同步到存储库中。 可以执行各种 Git 操作来管理代码开发周期。

    显示用户数据函数项的 function-app.py 文件的屏幕截图。

  • resources:该文件夹中包含一个 functions.json 文件,其中包含所有元数据,如连接、库和此项中的函数。 请勿手动更新此文件functions.json 允许 Fabric 在工作区中创建或重新创建用户数据函数项。

    屏幕截图显示用户数据函数项的 resources 文件夹中的 function.json 文件。

有关 Git 集成的详细信息,包括文件夹结构和系统文件的详细信息,请参阅 Git 集成源代码格式

部署管道中的用户数据函数

可以使用部署管道跨不同的环境(例如开发、测试和生产)部署用户数据功能。 部署管道可帮助你简化开发过程,确保质量和一致性,并通过轻量级、低代码作减少手动错误。

注释

所有连接和库都会添加到在其他环境中创建的新用户数据函数项。

若要使用部署管道部署用户数据函数,请执行以下步骤:

  1. 创建新的部署管道或打开现有的部署管道。 有关详细信息,请参阅部署管道入门

  2. 根据部署目标将工作区分配到不同的阶段。

  3. 选择、查看和比较不同阶段之间的项(包括用户数据函数项)。

  4. 选择“部署”,将用户数据函数项部署到测试环境。 可以添加注释来提供有关此部署更改的详细信息。 同样,也可以跨开发、测试和生产阶段推送更改。

  5. 从“部署历史记录”监视部署状态。