Actualizar la actividad de endpoint de analítica SQL

La actividad de actualización del endpoint de analítica SQL en los pipelines de Microsoft Fabric te permite actualizar programáticamente un endpoint de análisis SQL de Lakehouse como parte de un flujo de trabajo orquestado. Forma parte de Lakehouse Utility Suite para canalizaciones y se usa normalmente después de la actividad de mantenimiento de Lakehouse (por ejemplo, después de las operaciones OPTIMIZE o VACUUM). Los consumidores finales, como informes de Power BI, notebooks o clientes SQL externos, ven los datos más recientes una vez completados los pasos de preparación o mantenimiento de datos.

Utiliza esta actividad para que los endpoints de analítica SQL reflejen inmediatamente las actualizaciones recientes sin depender de actualizaciones manuales ni procesos ad hoc. Utiliza esta actividad cuando el flujo de trabajo:

• Actualiza o mantiene los datos de Lakehouse (por ejemplo, después de trabajos de copia, ejecución de notebooks o actividades de mantenimiento del Lakehouse).
• Requiere que el endpoint de análisis SQL de Lakehouse refleje los últimos metadatos y cambios en los datos.
• Necesita un tiempo de actualización determinista antes de los pasos posteriores, como análisis, informes o exportaciones.

Prerrequisitos

Antes de usar esta actividad, asegúrese de que:

• Una cuenta de inquilino con una suscripción activa. Cree una cuenta gratuita.
• Un espacio de trabajo con un Lakehouse
• Existe un endpoint de análisis SQL para el Lakehouse.
• La identidad de la tubería (usuario o principal de servicio) tiene permiso para actualizar el endpoint de analítica SQL.

Añade a tu pipeline una actividad de actualización del endpoint de SQL Analytics en la interfaz de usuario

1. Cree una canalización en el área de trabajo.

2. Busca el endpoint de Refresh SQL Analytics en el panel de Actividades de la tubería y selecciona para añadirlo al lienzo de la canalización.

   

3. Selecciona la nueva actividad endpoint de análisis SQL de actualización en el lienzo si aún no está seleccionada.

   

   Sugerencia

   Puede organizar esta actividad junto con otras actividades de Lakehouse Utility Suite (como la actividad de mantenimiento de Lakehouse) en la misma canalización para que el mantenimiento y la actualización se ejecuten en secuencia.

4. Consulte las instruccionesgenerales para configurar la pestaña de parámetros General.

Actualizar la configuración de actividad de endpoints de SQL Analytics

1. Seleccione la pestaña Configuración para configurar la actividad.  

2. Configure la conexión seleccionando una conexión existente en la lista desplegable Conexión o creando una conexión y especificando sus detalles de configuración.

3. Especifique el área de trabajo que contiene el "Lakehouse".

4. Especifica el endpoint de análisis SQL como el Id del endpoint de analítica SQL para el Lakehouse que quieres actualizar. La actualización actualiza los metadatos del endpoint de análisis SQL de Lakehouse para reflejar los datos recientes y los cambios en el esquema.

   

Comportamiento de la actividad

Una vez finalice el proceso de ejecución de la actividad:

• Si el elemento emergente de Resultados muestra el estado Correcto, la solicitud sincroniza los datos no sincronizados correctamente.

  

• Un estado NotRun en la ventana emergente de Salida significa que la actualización del endpoint de SQL Analytics no se ejecutó. Normalmente, esa condición significa que no ha agregado nuevos datos desde la última sincronización, por lo que no es necesario ejecutarlos.

  

• Si el cuadro emergente de salida muestra el estado Fallo, algo salió mal.

Escenarios frecuentes

• Actualizar el endpoint de analítica SQL después de que un Notebook escriba datos transformados en un Lakehouse.
• Desencadena una actualización del endpoint analítico de SQL una vez completada la actividad de mantenimiento de Lakehouse (OPTIMIZE o VACUUM).
• Asegurarse de que los informes y paneles de control consulten el estado más reciente del Lakehouse en puntos bien definidos de una canalización.

¿Por qué falla la actualización de mi endpoint de análisis SQL cuando los datos subyacentes están bloqueados?

La actividad de actualización del endpoint de analítica SQL puede fallar de forma intermitente cuando otros procesos actualizan activamente los datos subyacentes de Lakehouse. Estos procesos incluyen canalizaciones de ingesta, cuadernos o operaciones de escritura simultáneas.

Este fallo ocurre porque el endpoint de analítica SQL necesita adquirir bloqueos internos para completar la actualización. Si otra operación bloquea los datos, la solicitud agota el tiempo de espera o devuelve un error.

Este comportamiento es esperado según cómo gestionan los endpoints de análisis SQL las operaciones de actualización de metadatos.

Síntomas

• La actividad falla de manera intermitente, no de manera consistente.
• Los mensajes de error indican conflictos de actualización o contención de bloqueo.
• Las pipelines con múltiples actividades de endpoint SQL Analytics de actualización secuencial muestran tasas de fallo más altas.

Causa principal

Los endpoints de análisis SQL requieren acceso exclusivo a ciertas estructuras de metadatos durante la actualización. Si otro proceso de computación escribe en el Lakehouse al mismo tiempo, ocurre una contención de bloqueo.

Este comportamiento no es un defecto de la actividad de actualización del punto de conexión de SQL Analytics. Es el resultado natural de las operaciones simultáneas de lectura y escritura en los datos subyacentes.

Soluciones alternativas

Dos enfoques prácticos pueden mitigar este problema:

• Usar solo una actividad de actualización del punto de conexión de SQL Analytics al final del procesamiento
• Implementa un calendario de actualizaciones recurrentes

Utiliza solo una actividad de actualización del endpoint de análisis SQL al final del procesamiento

Para reducir la probabilidad de conflictos de bloqueo, consolide la canalización para que:

• Todas las actividades de ingesta, transformación y actualización se ejecutan primero,
• Luego solo se ejecuta una actividad de actualización del endpoint de analítica SQL al final.
• Este enfoque no elimina completamente los errores, pero reduce considerablemente la frecuencia con la que se producen.

Implementa un calendario de actualizaciones recurrentes

Si el escenario no requiere una coherencia transaccional estricta en un momento específico, adopte un patrón de actualización periódico:

• Programe una actualización cada 15 minutos, continuamente. Algunos intentos de actualización pueden fallar por bloqueo, pero lo suficiente tiene éxito como para mantener tu endpoint de SQL Analytics relativamente actualizado.

Este enfoque es práctico y sólido para muchas cargas de trabajo de análisis.

Guardar, ejecutar o programar el flujo de trabajo

Cambie a la pestaña Inicio de la parte superior del editor de canalizaciones y seleccione el botón Guardar para guardar la canalización. Seleccione Ejecutar para ejecutarlo directamente o Programar para programar ejecuciones en intervalos o horas específicos. Para más información sobre las ejecuciones de canalización, consulte: ejecuciones de canalización programadas.

Una vez que se haya ejecutado, puede supervisar la ejecución de la canalización y ver el historial de ejecución desde la pestaña Salida debajo del lienzo.

Problemas conocidos

• La actividad de actualización del punto de conexión de analítica SQL puede fallar de forma intermitente cuando otros procesos actualizan activamente los datos subyacentes del Lakehouse. Para soluciones alternativas, consulta ¿Por qué falla la actualización de mis endpoints de SQL Analytics cuando los datos subyacentes están bloqueados?

Contenido relacionado

• Actividad de mantenimiento de Lakehouse
• Actualizar los metadatos de endpoints de análisis SQL con la API REST