查找 Fabric API for GraphQL 的常见问题解答。
什么是 GraphQL?
GraphQL 是一种用于 API 的开放源代码查询语言,也是一个使用现有数据实现这些查询的运行时。 GraphQL 通过强类型系统为 API 中的数据完整易懂的说明,使客户端能够精确地请求自己需要的数据,从而更容易逐渐改进 API,提供强大的开发工具。
什么是 Microsoft Fabric API for GraphQL?
Microsoft Fabric API for GraphQL 是一项托管服务,使你能够在几秒钟内创建 GraphQL API,以访问 Microsoft Fabric 数据仓库、Microsoft Fabric 湖屋、Microsoft Fabric 镜像数据库、Microsoft Fabric SQL 数据库和 Azure SQL 数据库等数据源中的数据。 它提供了一个统一 API 层,用于查询和更改这些支持的数据源中的数据。 Fabric API for GraphQL 当前为预览版。
Fabric API for GraphQL 支持哪些 GraphQL 操作?
当前仅支持 GraphQL 查询(读取)和突变(写入)。 通过 SQL Analytics 终结点公开的数据源是只读的,因此仅支持查询。 对于数据仓库,需要定义主键,以便自动生成突变。
如何在 Fabric API for GraphQL 中查看和编辑解析程序?
解析程序是 GraphQL 组件,它提供业务逻辑来解析 API 中的字段,并使用驻留在数据源中的数据执行操作。 每当附加新数据源或选择要从现有数据源公开的新对象时,Fabric 都会自动生成解析程序。 目前无法自定义解析程序。 对于 API for GraphQL 中的自定义业务逻辑,可在数据源中创建存储过程,并在 GraphQL API 中公开它。
GraphQL API 客户端应用程序是否需要访问数据源才能执行查询或变更?
API for GraphQL 要求应用程序使用 Microsoft Entra 进行身份验证。 客户端应用程序必须正确注册和配置,以便对 Fabric 执行 API 调用。 在 Microsoft Entra 中注册的应用需要对 Power BI 服务的 Item.Execute.All 权限。 有关详细信息,请参阅在 Azure 中创建 Microsoft Entra 应用。 除了 Microsoft Entra 之外,如果 API 配置为使用单一登录 (SSO),则调用 GraphQL API 的应用中经过身份验证的用户或服务主体需要访问 GraphQL API 和数据源。 更具体地说,GraphQL API 中的“运行查询和突变”权限,以及相应地所选数据源所需的读写权限。 另一种选择是让用户或服务主体作为工作区成员,并在 API 和数据源项所在的位置拥有参与者角色,这将提供从单一位置访问这两项所需的权限。 有关详细信息,请参阅授予用户对工作区的访问权限。 或者,如果 API 配置为使用保存的凭据,则经过身份验证的用户或服务主体只需有权访问 API(在向 API 添加随机存取权限时,使用“运行查询和突变”选项)。 可在连接应用程序中找到一个端到端示例,其中包含用户主体和服务主体的示例代码。
如何为 GraphQL API 开具支持票证?
若要从 Microsoft 支持部门获取与 Fabric API for GraphQL 相关的任何问题的帮助,请访问我们的 Fabric 支持站点并选择“数据工程”选项。
GraphQL 的 API 尚不支持哪些区域?
API for GraphQL 目前在美国西部 3 区域不受支持。