Creación de accesos directos de OneLake en una base de datos KQL

Los accesos directos de OneLake en una base de datos KQL permiten consultar datos en elementos de Fabric internos y almacenamiento externo sin mover los datos. En una base de datos KQL, cada acceso directo aparece en Accesos directos y se puede consultar como una tabla externa en un queryset de KQL mediante la función external_table().

En este artículo, aprenderá a crear un acceso directo de OneLake en una base de datos de KQL que apunte a orígenes externos o Fabric interno. No puede cambiar el nombre de los accesos directos creados en una base de datos KQL y solo puede crear un acceso directo a la vez.

Para obtener información general sobre los tipos de acceso directo, las instrucciones específicas del origen y las limitaciones más amplias, consulte Accesos directos de OneLake.

Requisitos previos

• Un espacio de trabajo con una capacidad habilitada para Microsoft Fabric.
• Una base de datos KQL con permisos de edición.
• Una casa de lago.

Para acceder a los datos de la base de datos KQL en otras experiencias de Microsoft Fabric, consulte Una copia lógica.

Crear un acceso directo

1. Vaya a una base de datos KQL existente.

2. Seleccione +>Nuevo>acceso directo OneLake.

   

Seleccione un origen

Las bases de datos KQL admiten accesos directos a recursos internos de OneLake, como bases de datos KQL, lakehouses y warehouses, y a recursos externos, como Azure Data Lake Storage, Amazon S3 y Google Cloud Storage. Para obtener una lista completa de los tipos de métodos abreviados admitidos y las instrucciones de configuración específicas del origen, consulte Tipos de accesos directos.

1. En la ventana Nuevo acceso directo , elija el tipo de origen al que desea conectarse.
2. Complete los detalles de conexión necesarios para el origen y, a continuación, seleccione la carpeta o tabla que desea exponer en la base de datos KQL.
3. Opcional: Para activar la aceleración de consultas en el nuevo acceso directo, establezca Accelerate en On.
4. Selecciona Crear.

Para conocer los escenarios y limitaciones admitidos, consulte Aceleración de consultas para accesos directos de OneLake: información general.

Después de crear el acceso directo, la base de datos se actualiza automáticamente. El acceso directo aparece en Accesos directos en el panel Explorador. Ahora puede consultar los datos.

Organizar accesos directos con carpetas

Para crear una subcarpeta o moverse a una carpeta existente:

1. En el panel Explorador, realice una de las siguientes acciones:
   • Haga clic con el botón derecho en el acceso directo y seleccione Mover a la carpeta>+ Nueva carpeta.
     
   • O bien, seleccione los puntos suspensivos (...) situados junto al acceso directo específico y seleccione Mover a la carpeta>+ Nueva carpeta o elija una carpeta existente.
     
2. Para crear una carpeta, escriba un nombre para la carpeta y seleccione Crear. El acceso directo se mueve a la nueva carpeta.
   
3. Para mover más de un acceso directo, escriba otro nombre de carpeta o active el menú desplegable y active las casillas situadas junto a los accesos directos que desea mover a la misma carpeta.
   
4. También puede mover accesos directos a una carpeta existente. Para ello, seleccione Mover a la carpeta y, a continuación, seleccione la carpeta a la que desea mover el acceso directo, o arrastre y coloque el acceso directo en la carpeta.

Consultar datos

Para consultar datos desde el acceso directo de OneLake, use la función external_table().

1. En el lado derecho de la base de datos, seleccione Explorar los datos. La ventana se abre con algunas consultas de ejemplo que puede ejecutar para obtener un vistazo inicial a los datos.
2. Reemplazar el marcador de posición del nombre de la tabla por external_table('<shortcut-name>').
3. Seleccione Ejecutar o pulse Mayúsculas+ Entrar para ejecutar una consulta seleccionada.

Asignación de tipos de datos

Asignación de tipos de datos de Delta Parquet a Eventhouse

Los tipos de datos primitivos de Delta se asignan a los tipos de datos escalares de Eventhouse, como se muestra en la tabla siguiente. Para obtener más información, consulte Tipos de datos escalares.

Sincronización automática de esquemas

Los esquemas de tabla para una tabla de acceso directo se sincronizan automáticamente, por lo que las adiciones, eliminaciones, cambios de nombre y cambios de tipo en la tabla de origen se reflejan en el acceso directo sin necesidad de actualizaciones manuales. Este comportamiento está activado por defecto. Para desactivarlo, ejecuta el siguiente comando en la base de datos de origen:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

Para más información sobre el comportamiento de sincronización de esquemas, véase Sincronización automática de esquemas.

Contenido relacionado

• Consulta de datos en un conjunto de consultas KQL
• external_table() función
• Aceleración de consultas a través de métodos abreviados de OneLake