Introducción a las API de tabla de OneLake

OneLake proporciona APIs para trabajar con metadatos de tablas y leer filas de tablas en Fabric. Las APIs de metadatos de catálogo funcionan con clientes y bibliotecas compatibles con el estándar abierto de la API Iceberg REST Catalog (IRC) o con el estándar abierto Unity Catalog API. Una única API REST lee y escribe descripciones y etiquetas adicionales para tablas y columnas. La API de lectura de tablas independiente del formato devuelve filas de tabla como datos de Apache Arrow, al tiempo que aplica la seguridad de OneLake.

Trabajar con metadatos de tablas

Utiliza las APIs de metadatos para descubrir esquemas, tablas y metadatos de tablas. Las operaciones de lectura y escritura soportadas varían según el protocolo.

Utiliza la API adicional de metadatos de tablas (preview) para leer y escribir descripciones y etiquetas de tablas y columnas sin necesidad de usar una API de catálogo específica para cada formato.

API Protocol Formatos de tabla
API de metadatos de Iceberg API del catálogo REST de Iceberg Metadatos de Iceberg para tablas de OneLake compatibles
API de metadatos delta API REST compatible con Unity Catalog Metadatos delta

Leer datos de tablas

Utiliza la API de lectura de tablas para recuperar filas seguras de las tablas OneLake compatibles.

API Protocolo y flujo de trabajo Formatos de tabla
API de lectura de tablas (vista previa) Asigna flujos con POST /read, y recupera cada flujo con GET /readStream/{streamId} Tablas válidas de Delta Lake y Apache Iceberg

Prerrequisitos

Antes de usar estas APIs, identifica algunos datos y selecciona tu flujo de autenticación preferido de Microsoft Entra ID.

Recopila información básica

Recopile la información siguiente:

  • Identificador de inquilino de Fabric.

    El identificador del arrendatario es un GUID. Encuéntralo en la Tarjeta de Perfil o en Ayuda>sobre Fabric.

  • El área de trabajo y el identificador de elemento de datos del elemento de datos (como un lakehouse) que contiene un directorio de nivel superior llamado Tables.

    Estos identificadores son GUID (identificadores globales únicos). Se pueden encontrar en la dirección URL de OneLake de cualquier tabla de OneLake. También se pueden encontrar dentro de la dirección URL que se ve en el explorador cuando tiene un elemento de datos abierto en Fabric.

  • El nombre del esquema y el nombre de la tabla a la que quieres acceder. Para la API de lectura de tablas, la tabla debe ser una tabla válida de Delta Lake o de Apache Iceberg.

  • Una identidad de usuario o principal de servicio en Microsoft Entra ID que tenga los permisos necesarios para las operaciones que planeas utilizar.

    • Las operaciones de lectura requieren permiso para leer las tablas objetivo. La API de lectura de tablas utiliza los permisos y políticas de seguridad de datos para esta identidad cuando devuelve filas y columnas.
    • Las operaciones de escritura requieren acceso de escritura al elemento de datos objetivo y a la ubicación de OneLake. Dependiendo del tipo de elemento y del modelo de acceso, concede un rol de elemento o espacio de trabajo que permita escrituras, o concede ReadWrite a través de un rol de acceso a datos de OneLake. Para obtener más información, consulte Introducción a la seguridad de OneLake.

Prepárate para la autenticación

Haz un plan de cómo quieres autenticarte con la API.

  1. Decida cómo desea autenticarse con el identificador de Entra de Microsoft para obtener un token de acceso para la identidad de Microsoft Entra elegida.

    Puede consultar esta guía para obtener información sobre las distintas formas de obtener un token de acceso con el identificador de Microsoft Entra. Microsoft ofrece bibliotecas de autenticación cómodas en varios idiomas.

  2. Si va a desarrollar una nueva aplicación que permita a los usuarios iniciar sesión o iniciar sesión como una aplicación independiente, registre la aplicación con el identificador de Microsoft Entra.

  3. Conceda permiso de API a la aplicación de Microsoft Entra ID para la audiencia de tokens de Azure Storage (https://storage.azure.com/). La concesión de este permiso garantiza que la aplicación pueda obtener tokens para su uso con el punto de conexión de la tabla OneLake.

    Nota:

    El punto de conexión de la API de tabla de OneLake acepta la misma audiencia de token que los puntos de conexión del sistema de archivos de OneLake.

    Si estás desarrollando una aplicación, puede que ya sepas cómo autenticarte con Microsoft Entra ID para interactuar con las APIs REST del sistema de archivos de OneLake. Si es así, puedes usar el mismo enfoque para autenticar con el endpoint de la tabla OneLake.