Conexión a Microsoft OneLake

Microsoft OneLake proporciona acceso abierto a todos los elementos de su Fabric a través de Azure Data Lake Storage (ADLS) y APIs y SDKs de Blob existentes. Puede acceder a sus datos en OneLake a través de cualquier API, SDK o herramienta compatible con ADLS o Azure Blob Storage simplemente mediante un URI de OneLake. Puede cargar datos en una instancia de LakeHouse a través del Explorador de Azure Storage o leer una tabla delta a través de un acceso directo desde Azure Databricks.

Como OneLake es software como servicio (SaaS), algunas operaciones, como administrar permisos o actualizar elementos, deben realizarse a través de experiencias de Fabric y no se pueden realizar a través de las API de ADLS. Para obtener una lista completa de los cambios en estas API, consulte paridad de la API de OneLake.

Sintaxis de URI

Dado que OneLake existe en todo el inquilino de Microsoft Fabric, puede hacer referencia a cualquier elemento del inquilino por su área de trabajo, elemento y ruta de acceso:

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

OneLake también admite la referencia a áreas de trabajo y elementos con identificadores únicos globales (GUID). OneLake asigna GUID y los GUID no cambian, aunque cambie el área de trabajo o el nombre del elemento. Puede encontrar el GUID asociado para el área de trabajo o el elemento en la dirección URL del portal de Fabric. Debe usar GUID para el área de trabajo y el elemento y no necesita el tipo de elemento.

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

Al adoptar una herramienta para su uso en OneLake en lugar de ADLS, utilice el mapeo siguiente:

• El nombre de la cuenta siempre es onelake.
• El nombre del contenedor es el nombre del área de trabajo.
• La ruta de acceso de datos comienza en el elemento. Por ejemplo: /mylakehouse.lakehouse/Files/.

OneLake también admite el controlador azure Blob Filesystem (ABFS) para mayor compatibilidad con ADLS y Azure Blob Storage. El controlador ABFS usa su propio identificador abfs de esquema y un formato de URI diferente para direccionar archivos y directorios en cuentas de ADLS. Para usar este formato de URI a través de OneLake, cambie el área de trabajo por el sistema de archivos e incluya el elemento y el tipo de elemento.

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

El URI del controlador abfs no permite caracteres especiales, como espacios, en el nombre del área de trabajo. En estos casos, puede hacer referencia a áreas de trabajo y elementos con los identificadores únicos globales (GUID), como se describió anteriormente en esta sección.

Autorización

Puede autenticar las API de OneLake mediante Microsoft Entra ID pasando un encabezado de autorización. Si una herramienta admite el inicio de sesión en su cuenta de Azure para habilitar el paso a través del token, puede seleccionar cualquier suscripción. OneLake solo requiere el token de usuario y no le importa la suscripción de Azure.

Al llamar directamente a OneLake a través de las API DFS, puede autenticarse con un token de portador para su cuenta de Microsoft Entra. Para obtener más información sobre cómo solicitar y administrar tokens de portador para su organización, consulte la Biblioteca de autenticación de Microsoft.

Para realizar pruebas rápidas y ad hoc de OneLake mediante llamadas API directas, este es un ejemplo sencillo con PowerShell para iniciar sesión en su cuenta de Azure, recuperar un token con ámbito de almacenamiento y copiarlo en el Portapapeles para facilitar su uso en otro lugar. Para obtener más información sobre cómo recuperar tokens de acceso mediante PowerShell, consulte 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

Residencia de datos

Si usa el punto de conexión global (https://onelake.dfs.fabric.microsoft.com) para consultar datos en una región distinta de la región del área de trabajo, existe la posibilidad de que los datos dejen la región durante el proceso de resolución de puntos de conexión. Si le preocupa la residencia de datos, el uso del punto de conexión regional correcto para el área de trabajo garantiza que los datos permanecen dentro de su región actual y no cruzan ningún límite regional. Para detectar el punto de conexión regional correcto, compruebe la región de la capacidad a la que está asociada el área de trabajo.

Todos los puntos de conexión regionales de OneLake siguen el mismo formato: https://<region>-onelake.dfs.fabric.microsoft.com. Por ejemplo, un área de trabajo asociada a una capacidad en la región Oeste de EE. UU. sería accesible a través del punto de conexión regional https://westus-onelake.dfs.fabric.microsoft.com.

Problemas comunes

Si una herramienta o paquete compatible con ADLS no funciona con OneLake, el problema más común es la validación de direcciones URL. Como OneLake usa un punto de conexión diferente (dfs.fabric.microsoft.com) que ADLS (dfs.core.windows.net), algunas herramientas no reconocen el punto de conexión de OneLake y lo bloquean. Algunas herramientas permiten usar puntos de conexión personalizados (como PowerShell). De lo contrario, suele ser una corrección sencilla agregar el punto de conexión de OneLake como punto de conexión compatible. Si encuentra un problema de validación de direcciones URL o tiene algún otro problema al conectarse a OneLake, háganoslo saber.

Recursos

OneLake es accesible a través de las mismas API y SDK que ADLS. Para más información sobre el uso de las API de ADLS, consulte las páginas siguientes:

• Referencia de api de ADLS Gen2
• SDK del sistema de archivos de ADLS Gen2
  • .NET
  • Python
  • Java

Ejemplos

Crear archivo

Contenido relacionado

• Integración y paridad de OneLake
• Conexión a OneLake con Python
• Integración de OneLake con Azure Synapse Analytics