Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La actividad Actualizar punto de conexión de SQL en canalizaciones de Microsoft Fabric le permite actualizar mediante programación un punto de conexión sql de Lakehouse como parte de un flujo de trabajo orquestado. Este enfoque garantiza que los consumidores de nivel inferior(como informes, cuadernos o clientes SQL externos) vean los datos más recientes después de completar los pasos de preparación o mantenimiento de los datos.
Use esta actividad para que los puntos de conexión de 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 punto de conexión de SQL de Lakehouse refleje los últimos metadatos y cambios de 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 punto de conexión sql para Lakehouse.
- La identidad del pipeline (usuario o principal de servicio) tiene permiso para actualizar el punto de conexión de SQL.
Adición de una actividad Actualizar punto de conexión de SQL a la canalización en la interfaz de usuario
Cree una canalización en el área de trabajo.
Busque Actualizar punto de conexión de SQL en el panel Actividades de canalización y selecciónelo para agregarlo al lienzo de la canalización.
Seleccione la nueva actividad de actualización del punto de conexión SQL en el lienzo si aún no está seleccionada.
Consulte las instruccionesgenerales para configurar la pestaña de parámetros General.
Actualizar los ajustes de actividad del punto de conexión de SQL
Seleccione la pestaña Configuración para configurar la actividad.
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.
Especifique el área de trabajo que contiene el "Lakehouse".
Especifique el punto de conexión de SQL que contiene la vista de lago materializada que se va a actualizar. Este punto de conexión de SQL es el Lakehouse cuyo punto de conexión SQL desea actualizar. El punto de conexión de SQL asociado a la instancia de Lakehouse seleccionada.
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 indica que la actualización del endpoint de SQL 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.
Nota:
La ejecución de la actividad establece estos estados en el elemento emergente de salida. No confunda estos estados con el propio estado de actividad.
Escenarios frecuentes
- Actualizar el endpoint SQL después de que un notebook escriba datos transformados en un Lakehouse.
- Iniciar una actualización del punto de conexión de SQL después de que se completen las operaciones de optimización o Vacuum.
- Asegurarse de que los informes y los paneles consultan el estado de Lakehouse más reciente en puntos bien definidos en una canalización.
¿Por qué se produce un error en la actualización del punto de conexión de SQL cuando los datos subyacentes están bloqueados?
La actividad Actualizar punto de conexión de SQL puede producir un error 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 error se produce porque el punto de conexión de SQL debe 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 se espera en función de cómo los puntos de conexión de SQL administran 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 canalizaciones con actividades secuenciales de actualización de puntos finales de SQL muestran mayores tasas de error.
Causa principal
Los puntos de conexión de SQL requieren acceso exclusivo a determinadas 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 en la actividad Actualizar punto de conexión de SQL. 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 Punto Final SQL de Actualización al Final del Procesamiento
- Implementar una programación de actualización periódica
Usar una única actividad de actualización para el punto final SQL al concluir el proceso
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 punto de conexión SQL al final.
- Este enfoque no elimina completamente los errores, pero reduce considerablemente la frecuencia con la que se producen.
Implementar una programación de actualización periódica
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. Es posible que se produzca un error en algunos intentos de actualización debido al bloqueo, pero es suficiente para mantener el punto de conexión de SQL 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 Actualizar punto de conexión de SQL puede producir un error intermitente cuando otros procesos actualizan activamente los datos subyacentes de Lakehouse. Para obtener soluciones alternativas, consulte la sección ¿Por qué se produce un error en la actualización del punto de conexión de SQL cuando los datos subyacentes están bloqueados?