OneLake 表 API 概述

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 中,拥有读取所选数据项中表的权限的用户或服务主体标识。

准备身份验证

  1. 决定如何使用 Microsoft Entra ID 进行身份验证,以获取所选Microsoft Entra 标识的访问令牌。

    可以 检查本指南,了解使用 Microsoft Entra ID 获取访问令牌的不同方法。 Microsoft提供了 多种语言的便捷身份验证库

  2. 如果您正在开发一个新应用程序,该应用程序要么允许用户登录,要么作为独立应用程序进行登录,请将应用程序注册到 Microsoft Entra ID

  3. 向 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 表进行交互