使用门户编辑器编写和发布用户数据函数

可以直接从 Fabric 门户编辑、发布和管理用户数据函数。 本文概述了最常使用门户组件,包括工具栏、设置和导航元素。 了解如何使用门户界面管理函数、连接和库。

小窍门

本文重点介绍门户界面。 有关编写函数代码的信息,请参阅 Python 编程模型

门户编辑器概述

门户编辑器是打开用户数据函数项时访问的基于 Web 的界面。 以下是门户编辑器的元素:

显示门户编辑器元素的屏幕截图。

  1. “开始”和“编辑”选项卡:使用这些选项卡可在“开始”和“编辑”工具之间切换。 有关每个选项卡上可用的工具的详细信息,请参阅 “开始”工具栏“编辑”工具栏 部分。
  2. 设置: 此按钮将打开“用户数据函数”项设置。 这些设置包括用户数据函数项说明、敏感度标签、认可、管理连接和库管理设置。 此菜单中的设置适用于此项中的所有函数。
  3. 函数列表: 此列表包含此用户数据函数项内的函数。 将鼠标悬停在列表项上会显示“运行”或“测试”功能以及更多选项。
    • “开发 ”模式下,列表包含已发布和未发布的函数以及 “测试 ”按钮。
    • “仅运行 ”模式下,列表仅显示具有 “运行” 按钮的已发布函数。
  4. 代码查看器/编辑器: 包含此用户数据函数项中所有函数的代码。
    • “开发 ”模式下,代码是可编辑的,并且可能包含未发布的函数。
    • “仅运行 ”模式下,代码为只读,仅显示已发布的函数。
  5. 状态栏: 此栏包含两个元素:
    1. 测试会话指示器: 显示测试会话是否正在运行(仅开发模式)。 在 “开发模式”文档中了解有关测试函数的详细信息。
    2. 发布进程指示器: 显示函数当前是否已发布,或上次成功发布函数的时间戳。
  6. 模式切换器: 此下拉菜单允许在 “开发 模式”和 “仅运行 ”模式之间进行切换。 在 “开发模式”文档中了解详细信息。
  7. “共享”按钮: 此功能允许你与其他用户共享此用户数据函数项,并向其分配权限(共享、编辑和/或执行权限)。
  8. “发布”按钮: 此按钮启动用户数据函数项的发布过程。 此过程将发布项中的所有函数。 发布函数后,其他用户和 Fabric 项可以运行函数。
    • 仅在 开发 模式下可用。

主页工具栏

此工具栏提供适用于用户数据函数项中的所有函数的功能。 其中一些功能仅在 开发 模式下可用。

显示主工具栏元素的屏幕截图。

  1. 设置: 此按钮将打开“用户数据函数”项设置。 这些设置包括项说明、敏感度标签、认可、管理连接和库管理。 此菜单中的设置适用于用户数据函数项中的所有函数。
  2. “刷新”按钮: 此按钮刷新用户数据函数项以显示最新的已发布函数和元数据。 可以使用刷新按钮来确保使用最新版本的代码。
  3. 语言选择器: 此只读按钮将 Python 显示为默认选项。
  4. 生成调用代码: 此功能自动生成用于从外部应用程序或 Fabric 项调用函数的代码模板。 详细了解如何 生成调用代码
  5. 管理连接: 使用此功能,可以使用 OneLake 数据目录创建与 Fabric 数据源的连接。 此按钮将打开“设置”中的“管理连接”页。 详细了解 “管理连接”功能
  6. 库管理: 此功能允许你安装公共库和专用库,以便函数代码使用。 此按钮将打开“设置”中的“库管理”页。 详细了解 库管理功能
  7. 在 VS Code 中打开按钮: 通过此按钮,可以使用 Fabric 用户数据函数 VS Code 扩展在 VS Code 编辑器中打开函数。 详细了解如何使用 VS Code 扩展
  8. “发布”按钮: 此按钮启动用户数据函数项的发布过程。 此过程将发布项中的所有函数。
    • 仅在 开发 模式下可用。

编辑工具栏

此工具栏提供有助于编辑函数代码的功能。 其中大多数功能仅在 开发 模式下可用。

显示编辑工具栏元素的屏幕截图。

  1. 重置代码按钮: 此按钮将所有函数重置为已发布的代码版本。 此功能撤消与已发布函数不同的任何代码更改。
    • 仅在 开发 模式下可用。
  2. 编辑按钮: 这些按钮为代码编辑器提供以下功能:撤消、恢复、复制和粘贴。
    • 仅在 开发 模式下可用。
  3. 插入示例: 此功能提供代码模板,可帮助你为给定方案入门。 选择代码模板后,它将插入函数底部。 请确保安装必要的库,并根据 编程模型 准则添加必要的连接。
    • 仅在 开发 模式下可用。
  4. 管理连接: 使用此功能,可以使用 OneLake 数据目录创建与 Fabric 数据源的连接。 此按钮将打开“设置”中的“管理连接”页。 详细了解 “管理连接”功能
  5. 库管理: 此功能允许你安装公共库和专用库,以便函数代码使用。 此按钮将打开“设置”中的“库管理”页。 详细了解 库管理功能
  6. 查找和替换: 此功能允许你在代码编辑器中搜索关键字,并根据需要替换关键字。
    • 仅在 开发 模式下可用。
  7. “发布”按钮: 此按钮启动用户数据函数项的发布过程。 此过程将发布项中的所有函数。
    • 仅在 开发 模式下可用。

熟悉门户编辑器界面后,可以使用这些工具创建、编辑、测试和发布用户数据函数。 门户提供管理函数所需的一切,从编写代码到管理连接和库。