Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
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.
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.
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.
Contenido relacionado
- Infórmate más sobre metadatos adicionales de tablas.
- Aprende más sobre la API de metadatos de Iceberg.
- Infórmate más sobre la API de metadatos Delta.
- Aprende más sobre la lectura de los datos de las tablas de OneLake.
- Configure la conversión automática de Delta Lake al formato Iceberg.