在 Visual Studio Code 中创建 Fabric 用户数据函数项（预览版）

2025-04-04

Fabric 用户数据函数是一种无服务器解决方案，可让你快速轻松地基于 Fabric 本机数据源开发应用程序。优势是可以在 Fabric 中提高无服务器计算的灵活性和成本效益。用户数据函数作为对服务提供的终结点的 HTTP 请求被调用，在 Fabric 本机数据源上运行。

本快速入门介绍如何在 Visual Studio (VS) Code 中创建用户数据函数项。

先决条件

选择工作区

打开 VS Code 并登录到 Fabric。
在 Fabric 中，打开 Fabric 工作区或创建新工作区。
选择“+ 新建项”以打开“新建项”窗格。
在“新建项”窗格中的“开发数据”下，选择“用户数据函数”项目类型。
为新用户数据函数项提供一个名称，然后选择“创建”。随即将创建新的用户数据函数项。
在功能区中，选择“Python”作为运行时语言。
为此用户数据函数项创建虚拟环境。
选择 Python 运行时版本。用户数据函数需要 Python 版本 3.11。
通过选择“是”设置文件夹的虚拟环境。
打开 function_app.py 以添加多个函数。

编写第一个函数

使用 @udf.function() 修饰器编写一个用户数据函数项来定义函数的开头。可以为函数传递输入，例如 str、int、float 等基元数据类型。在函数中，可以编写自定义业务逻辑。

下面是 hello_fabric 函数的示例。

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

在 VS Code 中管理用户数据函数

在当前打开的工作区中，可以通过 VS Code 的 Fabric 资源管理器查看用户数据函数项。

屏幕截图显示了 Fabric 资源管理器视图和本地文件夹视图。

可以在 VS Code 的资源管理器中打开 Fabric 工作区中的所有函数以开始编辑。选择要打开的函数，然后选择“在资源管理器中打开”。可以看到在用户数据函数项中写入的连接、库和所有函数。

管理连接和网关

连接：可以从 Fabric 资源管理器查看为用户数据函数添加的所有数据连接。针对用户数据函数项，右键单击并选择“在 Fabric 中管理连接”。
库：可以从 Fabric 资源管理器查看为用户数据函数项添加的所有库。右键单击并选择“在 Fabric 中管理库”，为用户数据函数项添加新库。
函数：可在此处查看所有已发布的函数。选择一个函数并执行以下操作：
- 运行并测试：测试 VS Code 中的函数，而无需使用 API 测试工具。
- 复制公共 URL：如果此函数可以公开访问，可从外部应用程序调用）。

用于管理用户数据函数的本地文件夹

VS Code 资源管理器中打开的用户数据函数项在“本地”文件夹视图中可见。通过本地文件夹，可以测试和查看对用户数据函数项进行的本地更改。

函数：可以查看本地文件中的所有函数。function_app.py 若要从示例开始着手，请右键单击“函数”，然后选择“添加函数”以添加示例函数。

若要在本地测试函数，请按 F5 开始调试。还可以选择函数项，然后选择“运行并调试”。
查看本地函数的连接和库：可以在本地环境中查看中存在的所有连接和 local.settings.json 文件中的库。requirements.txt
- 从 local.settings 同步连接：可显示本地环境中的当前连接列表。
- 同步 requirements.txt：可显示本地环境中的库的当前列表。

发布用户数据函数

测试更改后，将用户数据函数发布到 Fabric。发布任何更改可能需要几分钟时间。

使用断点进行本地调试

选择 F5 调试 Fabric 函数。可以在代码中的任何位置添加一个断点。在调试模式下，断点按预期命中并像测试已部署的函数那样测试代码。

通过