OneLake 提供 REST API 终结点,用于与 Microsoft Fabric 中的表进行交互。 此终结点可与兼容 Iceberg REST 目录(IRC)API 开放标准或 Unity 目录 API 开放标准的客户端和库一起使用。
重要
此功能目前为预览版。
先决条件
识别几条信息并选择首选Microsoft Entra ID 身份验证流后,使用这些 API 非常简单。
收集基本信息
若要使用这些 API,首先需要收集以下信息片段:
Fabric 租户 ID。
租户 ID 是一个 GUID,可以在 配置文件 卡或 **帮助, 关于 Fabric 中的 Fabric 菜单中找到它。
具有顶级表目录的数据项(例如 lakehouse)的数据项 ID 及其工作区。
这些 ID 是 GUID。 可以在 OneLake 中任何表的 OneLake URL 中找到它们。 或者,在 Fabric 中打开数据项时,可以在浏览器中看到的 URL 中找到它们。
在 Microsoft Entra ID 中,拥有读取所选数据项中表的权限的用户或服务主体标识。
准备身份验证
决定如何使用 Microsoft Entra ID 进行身份验证,以获取所选Microsoft Entra 标识的访问令牌。
可以 检查本指南,了解使用 Microsoft Entra ID 获取访问令牌的不同方法。 Microsoft提供了 多种语言的便捷身份验证库。
如果您正在开发一个新应用程序,该应用程序要么允许用户登录,要么作为独立应用程序进行登录,请将应用程序注册到 Microsoft Entra ID。
向 Microsoft Entra ID 应用程序授予 Azure 存储()令牌访问群体的
https://storage.azure.com/。 授予此权限可确保你的应用程序可以获取用于 OneLake 表终结点的令牌。注释
OneLake 表 API 终结点接受与 OneLake 文件系统终结点相同的令牌受众。
如果你正在开发应用程序,你可能已经知道如何使用 Microsoft Entra ID 进行身份验证,以便与 OneLake 文件系统 REST API 进行交互。 如果是这样,则可以使用相同的方法对新的 OneLake 表终结点进行身份验证。
OneLake 上的 Iceberg REST 目录 (IRC) API 操作
了解如何开始使用 OneLake 表 API 终结点,以便与 OneLake 中的 Iceberg 表进行交互。 最初支持只读元数据表操作,我们计划尽快添加更多操作。
注释
在使用 Iceberg API 之前,请确保为租户或工作区启用了 Delta Lake 到 Iceberg 元数据转换。 查看 说明,了解如何启用自动 Delta Lake 到 Iceberg 表格式转换。
OneLake 上的 Delta Lake REST API 操作
了解如何开始使用 OneLake 表 API 终结点,以便与 OneLake 中的 Delta 表进行交互。