Solución de problemas de Synapse Studio

Esta guía de solución de problemas proporciona instrucciones sobre qué información proporcionar al abrir una incidencia de soporte técnico en problemas de conectividad de red. Con la información adecuada, posiblemente podamos resolver el problema con más rapidez.

Se produce un error en la publicación cuando la sesión permanece inactiva

Síntoma

En algunos casos, si la sesión del explorador ha estado inactiva durante un período prolongado, es posible que se produzca un error en el intento de publicación debido a un mensaje sobre la expiración del token:

ERROR: Unauthorized Inner error code: ExpiredAuthenticationToken Message: Token Authentication failed with SecurityTokenExpiredException - MISE12034: AuthenticationTicketProvider Name:AuthenticationTicketProvider, GetVersion:1.9.2.0.;

Causa principal y mitigación

El control de la expiración de tokens en Synapse Studio requiere una cuidadosa consideración, especialmente cuando se trabaja en un área de trabajo en directo sin integración de Git. Aquí se muestra cómo administrar la sesión para evitar perder el trabajo:

• Con la integración de Git:
  • Confirme periódicamente los cambios. Esto garantiza que incluso si necesita actualizar el explorador para renovar la sesión, el trabajo se almacena de forma segura.
  • Después de confirmar, puede actualizar el explorador para restablecer la sesión y, a continuación, continuar publicando los cambios.
• Sin integración de Git:
  • Antes de tomar descansos o períodos de inactividad, intente publicar los cambios. Es fundamental recordar que si la sesión ha estado inactiva durante mucho tiempo, es posible que encuentre un error de expiración del token al intentar publicar al devolver.
  • Si le preocupa el riesgo de perder cambios no guardados debido a una actualización necesaria, considere estructurar los períodos de trabajo para incluir acciones frecuentes de guardado y publicación y evite dejar la sesión inactiva durante períodos prolongados.

Problema de conectividad del servicio del grupo de SQL sin servidor

Síntoma 1

La opción "Grupo de SQL sin servidor" aparece atenuada en la lista desplegable Conectarse a.

Síntoma 2

La ejecución de la consulta con "grupo de SQL sin servidor" muestra el mensaje de error "No se pudo establecer una conexión al servidor".

Pasos para solucionar problemas

Abra el panel Información de diagnóstico y seleccione el botón Descargar diagnóstico . Conserve la información descargada para los informes de errores. En su lugar, puede copiar el "Id. de sesión" y adjuntarlo al abrir la incidencia de soporte técnico.

Para empezar a solucionar problemas, vuelva a intentar la operación que realizó en Synapse Studio.

• Para el síntoma 1, seleccione el botón Actualizar en la pestaña Script de SQL y compruebe si puede ver "grupo de SQL sin servidor".
• En el caso del síntoma 2, intente ejecutar de nuevo la consulta para ver si se ejecuta correctamente.

Si el problema sigue existiendo, presione F12 en el explorador para abrir Herramientas de desarrollo (DevTools).

En la ventana Herramientas de desarrollo , cambie al panel Red . Seleccione el botón Borrar de la barra de herramientas del panel Red si es necesario.

Asegúrese de que la opción Deshabilitar caché en el panel Red está activada.

Vuelva a intentar la operación que realizó en Azure Synapse Studio. Es posible que vea nuevos elementos que se muestran en la lista Red en Herramientas de desarrollo. Anote la hora actual del sistema para indicarla en la incidencia de soporte técnico.

Busque el elemento cuya columna url coincide con el siguiente patrón:

https://[*A*]-ondemand.database.windows.net:1443/databases/[*B*]/query?api-version=2018-08-01-preview&application=ArcadiaSqlOnDemandExplorer

Donde *A* es el nombre del área de trabajo, y -ondemand podría ser -sqlod y dónde *B* debe ser un nombre de base de datos, como master. Debe haber como máximo dos elementos con el mismo valor de dirección URL, pero valores de método diferentes; OPTIONS y POST. Compruebe si estos dos elementos tienen 200 o 20x están en la columna de estado, donde x podría ser cualquier dígito único.

Si alguno de ellos tiene algo distinto de 20x y:

• El estado comienza con "(failed)", amplía la columna Estado o mantiene el puntero sobre el texto de estado para ver el texto completo. Incluya el texto o la captura de pantalla al abrir la incidencia de soporte técnico.

  

  • Si ve ERR_NAME_NOT_RESOLVED y creó el área de trabajo en un plazo de 10 minutos, espere 10 minutos y vuelva a intentarlo para ver si el problema aún existe.
  • Si ve ERR_INTERNET_DISCONNECTED o ERR_NETWORK_CHANGED, puede indicar que la conexión de red del equipo tiene problemas. Compruebe la conexión de red y vuelva a intentar la operación.
  • Si ve ERR_CONNECTION_RESET, ERR_SSL_PROTOCOL_ERROR u otros códigos de error que contengan "SSL", puede indicar que la configuración de SSL local tiene problemas o el administrador de red ha bloqueado el acceso al servidor de grupo de SQL sin servidor. Abra una incidencia de soporte técnico y adjunte el código de error en la descripción.
  • Si ve ERR_NETWORK_ACCESS_DENIED, es posible que tenga que comprobar con el administrador si la directiva de firewall local ha bloqueado el acceso a un dominio *.database.windows.net o al puerto remoto 1443.
  • Opcionalmente, intente la misma operación inmediatamente en otra máquina o entorno de red para descartar un problema de configuración de red en el equipo.

• El estado es 40x, 50x u otros números, seleccione los ítem(s) para ver los detalles. Debería ver los detalles del elemento a la derecha. Busque la sección "Response Header"; a continuación, compruebe si existe un elemento denominado "access-control-allow-origin". De ser así, compruebe si tiene uno de los siguientes valores:

  • * (asterisco único)
  • https://web.azuresynapse.net/ (u otro valor con el que empiece el texto de la barra de direcciones del explorador)

Si el encabezado de respuesta contiene uno de estos valores, significa que ya deberíamos haber recopilado la información de error. Puede abrir una incidencia de soporte técnico si es necesario y, opcionalmente, adjuntar la captura de pantalla de los detalles del elemento.

Si no puede ver el encabezado, o el encabezado no tiene uno de estos valores, adjunte una captura de pantalla de los detalles del elemento cuando abra el ticket.

Si los pasos anteriores no resuelven el problema, es posible que tenga que abrir una incidencia de soporte técnico. Al enviar la incidencia de soporte técnico, incluya "Id. de sesión" o la "Información de diagnóstico" descargados al principio de esta guía.

Al notificar el problema, es posible que, opcionalmente, tome una captura de pantalla de la pestaña Consola en las Herramientas de desarrollo y adjunte a la incidencia de soporte técnico. Desplácese por el contenido y tome más de una captura de pantalla si es necesario para capturar todo el mensaje.

Si va a adjuntar capturas de pantallas, indique la hora (o un intervalo de tiempo estimado) de cuando tomó las capturas de pantallas. Nos ayudará al examinar el problema.

Algunos exploradores admiten la visualización de marcas de tiempo en la pestaña Consola . Para Chromium Edge/Chrome, abra el cuadro de diálogo "Configuración" en Herramientas de desarrollo y active "Mostrar marcas de tiempo" en la pestaña "Preferencias".

Problema de conexión de WebSocket del cuaderno

Síntoma

El mensaje de error muestra: Your notebook connection has closed unexpectedly. To re-establish the connection, run the notebook again. Diagnostic information: websocket_close_error (correlation id)

Causa principal:

La ejecución del notebook depende de establecer una conexión de WebSocket con la siguiente dirección URL:

wss://{workspace}.dev.azuresynapse.net/jupyterApi/versions/1/sparkPools/{spark-pool}/api/kernels/{kernel-id}/channels 

• {workspace} es el nombre del área de trabajo de Synapse.
• {spark-pool} es el nombre del grupo de Spark en el que está trabajando actualmente.
• {kernel-id} es un GUID que se usa para distinguir sesiones de cuaderno

Al configurar la conexión de WebSocket, Synapse Studio va a incluir un token de acceso (token de portador JWT de Microsoft Entra) en el encabezado Sec-WebSocket-Protocol de la solicitud de WebSocket.

A veces, la solicitud de WebSocket podría bloquearse, o el JWT en el encabezado de la solicitud podría estar censurado en el entorno de red. Esto hace que Synapse Notebook no pueda establecer la conexión con el servidor ni ejecutar el cuaderno.

Acción:

Si es posible, intente cambiar el entorno de red, por ejemplo, dentro o fuera de la red corporativa, o acceda a Synapse Notebook en otra estación de trabajo.

• Si puede ejecutar el cuaderno en la misma estación de trabajo pero en otro entorno de red, trabaje con el administrador de red para averiguar si se ha bloqueado la conexión de WebSocket.

• Si puede ejecutar cuadernos en una estación de trabajo diferente, pero en el mismo entorno de red, asegúrese de que no ha instalado ningún complemento de explorador que pueda bloquear la solicitud de WebSocket.

De lo contrario, póngase en contacto con el administrador de red y asegúrese de que se permiten las solicitudes de WebSocket salientes con el siguiente patrón de dirección URL y que su encabezado de solicitud no está censurado: wss://{workspace}.dev.azuresynapse.net/{path}

• {workspace} es el nombre del área de trabajo de Synapse.
• {path} indica cualquier subruta de acceso (por ejemplo, se incluye el carácter de barra diagonal) del URI

Este patrón de dirección URL es más flexible que el que se muestra en la sección "Causa principal" porque permite agregar nuevas características dependientes de WebSocket a Synapse sin ningún problema de conectividad potencial en el futuro.

La cola de mensajes está llena o completa y no puede aceptar más elementos

Síntoma

Si agrega un cuaderno que contiene más de 256 celdas de código a una canalización, las ejecuciones de la canalización fallarán con el código de error 6002 y el mensaje de error: MessageQueueFullException: The message queue is full or is completed and cannot accept more items.

Causa principal:

Hay una limitación de 256 celdas al ejecutar una actividad de cuaderno de Synapse desde una canalización.

Acción:

Puede combinar las celdas para reducir el número de celdas por debajo de 256.

Paso siguiente

Si los pasos anteriores no le ayudan a resolver el problema, cree una incidencia de soporte técnico.