Connexion à Microsoft OneLake

Microsoft OneLake offre un accès ouvert à tous vos éléments Fabric via les API et SDK (kits de développement logiciel) existants d'Azure Data Lake Storage (ADLS) et Blob. Vous pouvez accéder à vos données dans OneLake via n’importe quelle API, SDK ou outil compatible avec ADLS ou Stockage Blob Azure à l’aide d’un URI OneLake à la place. Vous pouvez charger des données dans un lakehouse via l’Explorateur Stockage Azure, ou lire une table delta à l’aide d’un raccourci à partir depuis Azure Databricks.

OneLake étant un logiciel en tant que service (SaaS), certaines opérations, telles que la gestion des autorisations ou la mise à jour d’éléments, doivent être effectuées via des expériences Fabric et ne peuvent pas être effectuées via des API ADLS. Pour obtenir la liste complète des modifications apportées à ces API, consultez Parité des API OneLake.

Syntaxe d’URI

OneLake existant dans l’ensemble de votre locataire Microsoft Fabric, vous pouvez faire référence à tout ce qui se trouve dans votre locataire par son espace de travail, son élément et son chemin :

https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>

OneLake prend également en charge le référencement d’espaces de travail et d’éléments avec des identificateurs globaux uniques (GUID). OneLake affecte des GUID, et les GUID ne changent pas même si le nom de l’espace de travail ou de l’élément change. Vous trouverez le GUID associé à votre espace de travail ou élément dans l’URL sur le portail Fabric. Vous devez utiliser des GUID pour l’espace de travail et l’élément, et vous n’avez pas besoin du type d’élément.

https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>

Lors de l’adoption d’un outil pour une utilisation sur OneLake au lieu d’ADLS, utilisez le mappage suivant :

• Le nom du compte est toujours onelake.
• Le nom du conteneur est le nom de votre espace de travail.
• Le chemin d’accès aux données commence à l’élément. Par exemple : /mylakehouse.lakehouse/Files/.

OneLake prend également en charge le pilote du système de fichiers Blob d'Azure (ABFS) pour une meilleure compatibilité avec ADLS et le Stockage d'objets Blob Azure. Le pilote ABFS utilise son propre identificateur abfs de schéma et un autre format d’URI pour traiter les fichiers et les répertoires dans les comptes ADLS. Pour utiliser ce format d’URI sur OneLake, échangez l’espace de travail pour le système de fichiers et incluez l’élément et le type d’élément.

abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>

L'URI du pilote abfs n'autorise pas les caractères spéciaux, tels que les espaces, dans le nom de l'espace de travail. Dans ce cas, vous pouvez référencer les espaces de travail et les éléments à l'aide des identifiants uniques globaux (GUID) décrits plus haut dans cette section.

Autorisation

Vous pouvez authentifier des API OneLake en tirant parti de Microsoft Entra ID via le passage d’un en-tête d’autorisation. Si un outil prend en charge la connexion à votre compte Azure pour activer la transmission de jeton, vous pouvez sélectionner n’importe quel abonnement. OneLake nécessite uniquement votre jeton d’utilisateur sans se préoccuper de votre abonnement Azure.

Lorsque vous appelez OneLake directement via des API DFS, vous pouvez vous authentifier avec un jeton du porteur pour votre compte Microsoft Entra. Pour obtenir plus d’informations sur la demande et la gestion de jetons du porteur pour votre organisation, consultez la Bibliothèque d’authentification Microsoft.

Pour effectuer des tests ad hoc et rapides de OneLake en utilisant des appels d’API directs, voici un exemple simple utilisant PowerShell pour vous connecter à votre compte Azure, récupérer un jeton étendu au stockage et le copier dans votre Presse-papiers pour pouvoir l’utiliser facilement ailleurs. Pour plus d’informations sur la récupération des jetons d’accès à l’aide de PowerShell, consultez Get-AzAccessToken.

Connect-AzAccount
$testToken = Get-AzAccessToken -AsSecureString -ResourceTypeName Storage
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$testToken.Token | Set-Clipboard

Résidence des données

Si vous utilisez le point de terminaison global (« https://onelake.dfs.fabric.microsoft.com ») pour interroger des données dans une région différente de celle de votre espace de travail, il est possible que les données quittent votre région pendant le processus de résolution du point de terminaison. Si la résidence des données vous préoccupe, l’utilisation du point de terminaison régional approprié pour votre espace de travail garantit que vos données restent dans leur région actuelle et ne franchissent aucune limite régionale. Vous pouvez découvrir le point de terminaison régional correct en vérifiant la région de la capacité à laquelle l’espace de travail est attaché.

Les points de terminaison régionaux OneLake suivent tous le même format : https://<region>-onelake.dfs.fabric.microsoft.com. Par exemple, un espace de travail attaché à une capacité dans la région USA Ouest serait accessible via le point de terminaison régional https://westus-onelake.dfs.fabric.microsoft.com.

Problèmes courants

Si un outil ou un package compatible avec ADLS ne fonctionne pas sur OneLake, le problème le plus courant est la validation d’URL. Comme OneLake utilise un autre point de terminaison (dfs.fabric.microsoft.com) que ADLS (dfs.core.windows.net), certains outils ne reconnaissent pas le point de terminaison OneLake et le bloquent. Certains outils vous permettent d'utiliser des points de terminaison personnalisés (comme PowerShell). Sinon, il suffit souvent d'ajouter le point de terminaison de OneLake comme point de terminaison pris en charge. Si vous rencontrez un problème de validation d’URL ou si vous rencontrez d’autres problèmes de connexion à OneLake, dites-le nous.

Ressources

OneLake est accessible via les mêmes API et sdk que ADLS. Pour en savoir plus sur l’utilisation des API ADLS, consultez les pages suivantes :

• Informations de référence sur l’API ADLS Gen2
• SDK de système de fichiers ADLS Gen2
  • .NET
  • Python
  • Java

Exemples

Créer un fichier

Contenu connexe

• Parité et intégration de OneLake
• Se connecter à OneLake avec Python
• Intégration de OneLake à Azure Synapse Analytics