通过

适用于 GraphQL 的 Microsoft Fabric API 的限制

本文详细介绍了 Microsoft Fabric API for GraphQL 中的当前限制。

局限性

本文列出了 Microsoft Fabric 中用于 GraphQL 的 API 的当前常规产品限制。 我们不断改进具有新功能的 GraphQL API。 有关 Microsoft Fabric 的未来的详细信息，请参阅 Fabric 路线图。

  • 利用 SQL Analytics 终结点进行访问的任何数据源仅支持针对它的读取操作。 例如，对于 Lakehouse 或镜像数据库不可使用变换。

  • 当前默认页面大小为 100，这意味着每个请求将返回答复中最多 100 个元素。 如果结果集大于 100，请使用 GraphQL 分页迭代结果。

  • 最大分页大小为 100,000。 这意味着，请求返回的元素数量有一个固定的最大值，并且你能够遍历这些元素。 如果需要为应用程序返回 10 万多个元素，请发出多个请求。 了解此模式在 GraphQL 中并不常见。

  • 我们支持的最大回复大小为 64MB。 这意味着，答复大小大于 64MB 的任何 API 请求都返回错误。 若要解决此限制，可以发出多个筛选的请求。

  • 存储过程的限制（适用于 Azure SQL、Fabric 中的 SQL 数据库和数据仓库）：

    • API for GraphQL 仅使用存储过程返回的第一个结果集。
    • 仅支持其第一个结果集的元数据由 sys.dm_exec_describe_first_result_set 描述的存储过程。
    • 在配置文件和 URL 查询字符串中同时指定存储过程参数时，URL 查询字符串中的参数优先。
    • 由存储过程支持的实体不具备由表或视图支持的实体所自动提供的所有功能。
    • 由存储过程支持的实体不支持分页、排序或筛选。 此类实体也不支持返回主键值指定的项。

  • 请求超时目前为 100 秒。 这意味着，如果发出一个生成数据源查询的请求，该查询需要超过 100 秒才能完成，则请求可能会失败并出错。

  • 支持的最大查询深度为 10。 查询深度是查询中的字段的嵌套级别，如果由于潜在的递归和过度数据提取而太深，可能会影响性能。

已知问题

有关 GraphQL API 中的已知问题，请访问 Microsoft Fabric 已知问题。

相关内容