Fabric 用户数据函数的服务详细信息和限制

本文详细介绍了 Fabric 用户数据函数的服务详细信息和当前限制。

容量报告

Fabric 容量指标应用程序中报告了 Fabric 用户数据函数的使用情况。 容量报告说明了 Fabric 用户数据函数的创建、发布、执行和存储。 要详细了解 Fabric 容量指标应用中报告的计量，请访问 Fabric 操作。

网络安全要求

为了使 Fabric 用户数据函数正常工作，网络必须允许“多部分/表单数据”请求和文件上传到 Fabric 终结点。 如果未满足此要求，以下请求可能会导致跨域资源共享（CORS）错误：发布函数并上传自定义库。

局限性

下面是 Fabric 用户数据函数的当前限制：

• 函数只能由所有者编辑：目前，只有用户数据函数项的所有者才能修改和发布函数代码。 有关如何转让 Fabric 项的所有权的说明，请参阅获取 Fabric 项的所有权。

• 函数发布冷却期：发布函数后，需要等待至少 2 分钟才能再次发布。 此冷却期适用于从函数门户（浏览器内）、用户数据函数 Visual Studio Code 扩展、GIT 导入操作或使用部署管道进行发布时。

• “管理连接”仅支持 Fabric 数据源：“管理连接”功能目前仅支持连接到 Fabric 本机数据源。 要了解详细信息，请访问连接到数据源。

• “管理连接”无法连接到名称中包含特殊字符的资源：结构资源（如数据库）的名称中包含特殊字符（如大括号或非 ASCII 字符）与用户数据函数中的“管理连接”体验不兼容。 要了解详细信息，请访问连接到数据源。

• 用户数据函数的区域限制：用户数据函数在 Fabric 区域的子集中不可用。 有关 Fabric 用户数据函数可用区域的更新列表，请参阅 Fabric 区域可用性。 如果主租户位于不受支持的区域，可以在受支持的区域中创建容量以使用用户数据函数。 有关详细信息，请参阅管理 Fabric 容量。

• 开发模式下的测试功能的区域限制：开发模式下的测试功能在以下 Fabric 区域中不可用：巴西南部、以色列中部和墨西哥中部。 你仍然可以通过发布和运行函数，或使用 VS Code 扩展 在本地测试它们来测试函数。

• Fabric 用户数据函数中的保留 Python 关键字：除了 Python 语言中的保留关键字外，Fabric 用户数据函数还使用以下关键字： req， context以及 reqInvocationId。 保留关键字不能用作参数名或函数名。

• 不支持具有默认值或可选值的参数：目前，调用调用时需要所有函数参数。 同样，目前不支持在函数参数定义中提供默认值。 例如，下面的函数引发语法错误：

      # The default value for the argument called 'name' is not supported and treated like a syntax error.
      @udf.function()
      def goodbye_fabric(name: str = "N/A") -> str:
          return f"Goodbye, {name}."
  

• 服务主体支持：当前不支持使用服务主体访问 Fabric 项或数据源。 例如，不能将 Fabric 用户数据函数用作托管标识或工作区标识。

服务限制

以下列表详细说明了用户数据函数项的服务限制。

后续步骤

• 从 Fabric 门户创建新的用户数据函数项或使用 VS Code 扩展。
• 了解用户数据函数编程模型