Vue d’ensemble des API de table OneLake

OneLake offre un point de terminaison d’API REST pour interagir avec des tables dans Microsoft Fabric. Ce point de terminaison peut être utilisé avec des clients et des bibliothèques compatibles avec l’API du catalogue REST Iceberg (IRC) open standard ou l’API du catalogue Unity open standard.

Prerequisites

L’utilisation de ces API est simple une fois que vous identifiez quelques informations et sélectionnez votre flux d’authentification Microsoft Entra ID préféré.

Collecte d’informations de base

Pour utiliser ces API, vous devez d’abord collecter les informations suivantes :

• VOTRE ID de locataire Fabric.

  L’ID de locataire est un GUID et se trouve dans la carte de profil ou le menu **Aide**, À propos de Fabric dans Fabric.

• L’espace de travail et l’ID d’élément de données de l’élément de données (par exemple, un lakehouse) avec un répertoire Tables de niveau supérieur.

  Ces ID sont des GUID (Identifiants Globaux Uniques). Elles se trouvent dans l’URL OneLake de n’importe quelle table dans OneLake. Vous pouvez également les trouver dans l’URL affichée dans votre navigateur lorsque vous disposez d’un élément de données ouvert dans Fabric.

• Identité d’utilisateur ou de principal de service dans Microsoft Entra ID qui dispose des autorisations nécessaires pour lire des tables dans votre élément de données choisi.

Préparation de l’authentification

1. Décidez de la façon dont vous souhaitez vous authentifier auprès de Microsoft Entra ID pour obtenir un jeton d’accès pour votre identité Microsoft Entra choisie.

   Vous pouvez consulter ce guide pour en savoir plus sur les différentes façons d’obtenir un jeton d’accès avec l’ID Microsoft Entra. Microsoft propose des bibliothèques d’authentification pratiques dans plusieurs langues.

2. Si vous développez une nouvelle application qui permettra aux utilisateurs de se connecter ou de se connecter en tant qu’application autonome, inscrivez votre application avec l’ID Microsoft Entra.

3. Accordez l’autorisation d’API pour l’audience du jeton Stockage Azure (https://storage.azure.com/) à votre application Microsoft Entra ID. L’octroi de cette autorisation garantit que votre application peut obtenir des jetons à utiliser avec le point de terminaison de la table OneLake.

   Note

   Le point de terminaison de l'API de table OneLake accepte la même audience de jeton que les points de terminaison du système de fichiers OneLake.

   Si vous développez une application, vous savez peut-être déjà comment vous authentifier auprès de l’ID Microsoft Entra pour interagir avec les API REST du système de fichiers OneLake. Si c’est le cas, vous pouvez utiliser la même approche pour vous authentifier auprès du nouveau point de terminaison de table OneLake.

Opérations de l’API du catalogue REST Iceberg (IRC) sur OneLake

Découvrez comment commencer à utiliser le point de terminaison de l’API de table OneLake pour interagir avec les tables Iceberg dans OneLake. Initialement, les opérations de table de métadonnées en lecture seule sont prises en charge et nous prévoyons d’ajouter bientôt d’autres opérations.

Opérations de l’API REST Delta Lake sur OneLake

Découvrez comment commencer à utiliser le point de terminaison de l’API de table OneLake pour interagir avec les tables Delta dans OneLake.

Contenu connexe

• En savoir plus sur les API de table OneLake pour Iceberg.
• En savoir plus sur les API de table OneLake pour Delta.
• Configurer la conversion automatique du format Delta Lake au format Iceberg.