Fabric API for GraphQL 常见问题解答

GraphQL 是 API 的查询语言，可让应用准确请求所需的数据。 它使用强类型系统来清楚地描述可用的数据，通过允许精确的请求来减少过度提取，使 API 更新更容易，而无需中断现有代码，并允许使用一组广泛的开发人员工具。 这是应用程序与服务器和数据库通信的更高效方法。

Microsoft Fabric API for GraphQL 是一项托管服务，使你能够在几秒钟内创建 GraphQL API，以访问 Microsoft Fabric 数据仓库、Microsoft Fabric 湖屋、Microsoft Fabric 镜像数据库、Microsoft Fabric SQL 数据库和 Azure SQL 数据库等数据源中的数据。 它提供了一个统一 API 层，用于查询和更改这些支持的数据源中的数据。

当前仅支持 GraphQL 查询（读取）和突变（写入）。 通过 SQL Analytics 终结点公开的数据源是只读的，因此仅支持查询。 对于数据仓库，需要为自动生成突变定义主键。

解析程序是 GraphQL 组件，它提供业务逻辑来解析 API 中的字段，并使用驻留在数据源中的数据执行操作。 每当附加新数据源或选择要从现有数据源公开的新对象时，Fabric 都会自动生成解析程序。 目前无法自定义解析程序。 对于 API for GraphQL 中的自定义业务逻辑，可在数据源中创建存储过程，并在 GraphQL API 中公开它。

适用于 GraphQL 的 API 要求应用程序使用 Microsoft Entra ID 进行身份验证。 客户端应用程序必须正确注册和配置，以便对 Fabric 执行 API 调用。 在 Microsoft Entra 中注册的应用需要 GraphQLApi.Execute.All Power BI 服务的权限。 有关详细信息，请参阅在 Azure 中创建 Microsoft Entra 应用。 除了 Microsoft Entra 之外，如果 API 配置为使用单一登录 (SSO)，则调用 GraphQL API 的应用中经过身份验证的用户或服务主体需要访问 GraphQL API 和数据源。 更具体地说，GraphQL API 中的“运行查询和突变”权限，以及相应地所选数据源所需的读写权限。 另一种选择是将用户或服务主体作为具有 参与者角色的工作区成员 API 和数据源项所在的位置，从而提供从单个位置访问这两个项目所需的访问权限。 有关详细信息，请参阅授予用户对工作区的访问权限。 或者，如果 API 配置为使用已保存的凭据，则经过身份验证的用户或服务主体只需有权访问 API（在向 API 添加直接访问权限时选择 运行查询和突变 选项）。 可在连接应用程序中找到一个端到端示例，其中包含用户主体和服务主体的示例代码。

若要从 Microsoft 支持部门获取与 Fabric API for GraphQL 相关的任何问题的帮助，请访问我们的 Fabric 支持站点并选择“数据工程”选项。

API for GraphQL 目前在美国西部 3 区域不受支持。

目前，GraphQL 的 API 不支持专用链接。 但是，我们计划在将来支持此功能，并在更新可用时提供更新。

如果已启用租户设置“阻止公共 Internet 访问”（即禁用公共访问），则会自动禁用任何未移植的项目或项，包括 GraphQL 的 API。 这意味着无法访问以前创建的项，也不能创建新项。 访问这些项目的唯一方法是允许公共访问。

此行为有两个主要原因。 首先，如果数据源需要冷热，则第一个请求可能需要更长的时间。 即使数据源不冷，在 GraphQL 首次发出查询时，数据检索可能不如效率，如果数据源没有在内存中加载所需的数据。 第二个原因是，对 GraphQL 终结点 API 的第一个请求可能需要更长的时间，因为系统需要加载架构和配置才能接受请求。 这是一次性成本，后续请求速度更快，因为系统已预热并准备好为请求提供服务。

欢迎你的反馈和建议！ 可以通过 结构创意提供反馈。 我们的团队积极监视通过此平台提交的反馈和建议。 还可以通过 Microsoft Fabric 支持 联系我们，了解任何特定查询或问题。

相关内容

什么是 Microsoft Fabric API for GraphQL？