Sincronización de metadatos del punto de conexión de SQL Analytics

En este artículo se describe qué es el punto de conexión de SQL Analytics, cómo se mantiene sincronizado con su lakehouse y los controles de que dispone para administrar esa sincronización. El punto de conexión de SQL Analytics detecta automáticamente el cambio y actualiza sus metadatos SQL mediante un proceso en segundo plano. También puede actualizar manualmente los metadatos del extremo de análisis de SQL a través del portal de Fabric, la API REST o el procedimiento almacenado de T-SQL.

El proceso en segundo plano de sincronización de metadatos lee los registros delta de la /Tables carpeta en OneLake y mantiene actualizado el esquema SQL.

Microsoft Fabric mantiene automáticamente el extremo de análisis de SQL sincronizado con el lakehouse subyacente. No hay ninguna infraestructura para configurar y, en la mayoría de los casos, no se requiere ninguna acción del usuario. La plataforma es responsable de:

  • Detección de tablas: detectar tablas Delta recién creadas o eliminadas en el lakehouse y crear o eliminar las correspondientes tablas SQL en el endpoint.
  • Actualización de datos : detección de cambios (inserciones, actualizaciones, eliminaciones) realizados en los datos de las tablas existentes y garantizando que las consultas devuelvan resultados de up-to-date.
  • Detección de cambios de esquema : detección de adiciones de columnas, eliminaciones o cambios de tipo en las tablas Delta existentes y actualización de la definición de tabla SQL correspondiente.

Para más información sobre cómo funciona esta sincronización y factores que afectan a la latencia de sincronización, consulte Consideraciones sobre el rendimiento del punto de conexión de SQL Analytics.

Sincronización de metadatos y detección de cambios de esquema

Cada Lakehouse, almacén de datos, base de datos y base de datos reflejada de Fabric se aprovisiona automáticamente con su propio punto de conexión de SQL analytics, por lo que puede consultar tablas Delta con T-SQL y el protocolo TDS, sin mover ni copiar datos.

  • Cada Lakehouse, almacén de datos, base de datos y base de datos reflejada tiene exactamente un punto de conexión para análisis de SQL.
  • Cada tabla Delta del elemento subyacente se muestra automáticamente como una tabla SQL en el punto de conexión.
  • El endpoint es de solo lectura para las tablas autogeneradas. Puede ampliar el modelo con sus propios esquemas SQL, vistas, procedimientos almacenados y funciones.
  • El punto de conexión se basa en el mismo motor de proceso que Fabric Data Warehouse, por lo que proporciona consultas SQL de alto rendimiento y baja latencia en archivos Delta abiertos.

Nueva sincronización de metadatos (versión preliminar)

Importante

Esta característica se encuentra en versión preliminar.

En mayo de 2026, la nueva sincronización de metadatos para el punto de conexión de SQL Analytics se anunció como una característica en versión preliminar. Puede habilitar el nuevo proceso de sincronización de metadatos, que solo se aplica a los nuevos puntos de conexión de SQL Analytics. La nueva opción de sincronización de metadatos funciona para mantener los datos disponibles para realizar consultas en cuestión de segundos a partir de su aterrizaje en lakehouse.

El nuevo proceso de sincronización de metadatos incluye las siguientes características:

  • Nueva arquitectura basada en tablas externas para analizar registros delta y crear el catálogo.
  • Una arquitectura desacoplada que detecta los cambios de esquema y datos por separado y actualiza el catálogo en consecuencia.
  • Actualización en segundo plano que comprueba si hay actualizaciones de datos periódicamente.
  • Una actualización a petición de los datos cuando se produce una consulta de lectura entrante y el sistema detecta que los datos no están actualizados.

Habilitación de la nueva sincronización de metadatos

Para habilitar la nueva sincronización de metadatos en áreas de trabajo, vaya a Configuración de almacenamiento en Configuración del área de trabajo.

Captura de pantalla del portal de Fabric, página Configuración del área de trabajo, que muestra la opción Nueva sincronización de metadatos de Warehouse y el panel Nueva sincronización de metadatos (versión preliminar).

Al habilitar la nueva sincronización de metadatos, los nuevos puntos de conexión de SQL Analytics en el área de trabajo se sincronizan más rápido al actualizar los cambios de las tablas subyacentes. Actualmente, los puntos de conexión de SQL Analytics existentes en esa área de trabajo permanecen en la versión heredada de la sincronización de metadatos.

Buscar cuándo se actualizaron por última vez los metadatos

Si usa la nueva versión de la sincronización de metadatos, puede usar vistas de administración dinámica (DMV) para obtener detalles sobre la actualización más reciente al punto de conexión de SQL Analytics. Use la sys.dm_db_external_tables_log_status DMV para obtener detalles sobre la sincronización de metadatos más reciente:

  • last_update_time_utc: marca de tiempo para la última vez que la tabla se actualizó con nuevos datos.
  • latest_log_version: la versión más alta del registro de transacciones delta de la tabla que se actualizó.
  • latest_checkpoint_version: la versión más reciente del punto de comprobación delta que se procesó.
  • is_blocked: indica si el último intento en la actualización de la tabla se bloqueó (1) o se realizó correctamente (0).

Para obtener más información, consulte sys.dm_db_external_tables_log_status.

Limitaciones de la nueva sincronización de metadatos

  • La nueva sincronización de metadatos no admite puntos de control de varias partes, una característica delta en desuso. Si las tablas de Lakehouse contienen puntos de comprobación de varias partes, no se actualizarán en la nueva sincronización de metadatos.
  • Si su área de trabajo usa Private Link del área de trabajo, actualmente no se puede habilitar la nueva sincronización de metadatos.

Actualización manual

Además de los procesos en segundo plano que actualizan automáticamente los datos, puede actualizar manualmente los metadatos:

  • Refresh desde el portal: en el editor de puntos de conexión de SQL Analytics del portal de Fabric, seleccione el icono Refresh del Explorer para forzar una sincronización de metadatos a petición. Vaya a Query el punto de conexión de SQL Analytics y busque el botón Actualizar de la barra de herramientas.

    Captura de pantalla del portal de Fabric que muestra el botón Actualizar esquema del punto de conexión de SQL Analytics.

  • Actualizar con la API REST: Use la API REST para actualizar los metadatos del punto de conexión SQL para actualizar mediante programación los metadatos de un punto de conexión de análisis de SQL.

  • Actualizar mediante procedimiento almacenado: Use el procedimiento almacenado del sistema sys.sp_dw_refresh_ext_table para actualizar los datos de una tabla específica en un punto de conexión de análisis de SQL. Este método T-SQL solo está disponible si el punto de conexión de SQL Analytics se creó después de habilitar la nueva sincronización de metadatos (versión preliminar). Por ejemplo:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Use la API solo si tiene cambios de esquema, como agregar o eliminar tablas o columnas, o cambiar los tipos de columnas, y debe actualizar todo el elemento. Para los cambios únicamente en los datos en un punto de conexión de SQL Analytics, use el procedimiento almacenado del sistema sys.sp_dw_refresh_ext_table para actualizar una tabla específica.

Para optimizar las tablas Delta subyacentes para obtener la mejor sincronización de metadatos y el rendimiento de las consultas, consulte Consideraciones sobre el rendimiento del punto de conexión de SQL Analytics.

Contenido relacionado

  • Last updated on