Problemas conocidos de Azure Synapse Analytics

En esta página se enumeran los problemas conocidos de Azure Synapse Analytics y su fecha de resolución o posible solución alternativa. Antes de enviar una solicitud de soporte técnico de Azure, revise esta lista para ver si el problema que tiene ya se conoce y se está tratando.

Para más información sobre Azure Synapse Analytics, consulte la Introducción a Azure Synapse Analytics y Novedades de Azure Synapse Analytics.

Problemas conocidos activos

Componente de Azure Synapse Estado Problema
Grupo de SQL dedicado de Azure Synapse Los clientes no pueden supervisar su uso del grupo de SQL dedicado mediante métricas Tiene solución alternativa
Grupo de SQL dedicado de Azure Synapse Error de consulta al ingerir un archivo parquet en una tabla con AUTO_CREATE_TABLE='ON' Tiene solución alternativa
Grupo de SQL dedicado de Azure Synapse Errores de consultas con el error de filtración de datos Tiene solución alternativa
Grupo de SQL dedicado de Azure Synapse Error en la instrucción de ACTUALIZACIÓN DE ESTADÍSTICAS: "El flujo de estadísticas proporcionado está dañado." Tiene solución alternativa
Grupo de SQL sin servidor de Azure Synapse Errores de consulta del grupo de SQL sin servidor al almacén analítico de Azure Cosmos DB Tiene solución alternativa
Grupo de SQL sin servidor de Azure Synapse La vista del almacén analítico de Azure Cosmos DB propaga atributos incorrectos en la columna Tiene solución alternativa
Grupo de SQL sin servidor de Azure Synapse Errores de consulta en grupos de SQL sin servidor Tiene solución alternativa
Grupo de SQL sin servidor de Azure Synapse Problemas de acceso de almacenamiento debido a que el encabezado de autorización es demasiado largo Tiene solución alternativa
Grupo de SQL sin servidor de Azure Synapse La consulta de una vista muestra resultados inesperados Tiene solución alternativa
Área de trabajo de Azure Synapse El servicio vinculado de Blob Storage con la identidad administrada asignada por el usuario (UAMI) no aparece en la lista Tiene solución alternativa
Área de trabajo de Azure Synapse Error al eliminar el área de trabajo de Synapse No se puede eliminar la red virtual Tiene solución alternativa
Área de trabajo de Azure Synapse Error en las operaciones PUT de la API de REST o plantillas de ARM/Bicep para actualizar la configuración de red Tiene solución alternativa
Área de trabajo de Azure Synapse Problema conocido que incorpora corchetes [] en el valor de Etiquetas Tiene solución alternativa
Área de trabajo de Azure Synapse Errores de implementación en el área de trabajo de Synapse mediante Synapse-workspace-deployment v1.8.0 en acciones de GitHub con plantillas de ARM Tiene solución alternativa
Área de trabajo de Azure Synapse No GET operación de API dedicada a la configuración de Microsoft.Synapse/workspaces/trustedServiceBypassEnabled Tiene solución alternativa

Resumen de problemas conocidos activos del grupo de SQL dedicado de Azure Synapse Analytics

Los clientes no pueden supervisar su uso del grupo de SQL dedicado mediante métricas

Una actualización interna de nuestra lógica de emisión de telemetría, diseñada para mejorar el rendimiento y la confiabilidad de nuestros datos de telemetría, ha provocado un problema inesperado que afectaba a la capacidad de algunos clientes de supervisar su grupo de SQL dedicadotempdb, y métricas de E/S de datos de almacenamiento de datos.

Solución alternativa: al identificar el problema, nuestro equipo tomó medidas para identificar la causa principal y actualizar la configuración en nuestro sistema. Los clientes pueden corregir el problema pausando y reanudando su instancia, lo que restaurará el estado normal de la instancia y el flujo de datos de telemetría.

Error de consulta al ingerir un archivo parquet en una tabla con AUTO_CREATE_TABLE='ON'

Los clientes que intentan ingerir un archivo parquet en una tabla distribuida hash con AUTO_CREATE_TABLE='ON' pueden recibir el siguiente error:

COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables

No se admite la ingesta en una tabla distribuida por hash creada automáticamente mediante AUTO_CREATE_TABLE. Los clientes que se han cargado previamente usando este escenario no admitido deben usar la operación CTAS para pasar sus datos a una nueva tabla y usarla en lugar de la tabla anterior.

Las consultas no se pueden realizar y aparece el error de filtración de datos

Las áreas de trabajo de Synapse creadas a partir de errores de consulta de informes de grupos de SQL dedicados relacionados con la protección de filtración de datos con un mensaje de error genérico mientras la protección contra filtración de datos está desactivada en Synapse Analytics:

Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.

Solución alternativa: si ha encontrado un error similar, póngase en contacto con el equipo de Soporte técnico de Microsoft para obtener ayuda.

Error de ACTUALIZACIÓN DE ESTADÍSTICAS

Algunos grupos de SQL dedicados pueden encontrarse con una excepción al ejecutar una instrucción de UPDATE STATISTICS. El comando da como resultado el mensaje "La secuencia de estadísticas proporcionada está dañada" y no puede actualizar las estadísticas.

Cuando se agrega una nueva restricción a una tabla, se crea una estadística relacionada en las distribuciones. Si también se crea un índice agrupado en la tabla, debe incluir las mismas columnas (en el mismo orden) que la restricción; de lo contrario, se pueden producir errores en los comandos de UPDATE STATISTICS en esas columnas.

Solución alternativa: identifique si existe una restricción y un índice agrupado en la tabla. Si es así, DROP tanto la restricción como el índice agrupado. Después, vuelva a crear el índice agrupado y, a continuación, la restricción , asegurándose de que ambos incluyan las mismas columnas en el mismo orden. Si la tabla no tiene una restricción y un índice agrupado, o si el paso anterior produce el mismo error, póngase en contacto con el equipo de Soporte técnico de Microsoft para obtener ayuda.

Parece que se produce un error en las actualizaciones de etiquetas

Al realizar un cambio en las etiquetas de un grupo de SQL dedicado a través de Azure Portal u otros métodos, puede aparecer un mensaje de error aunque el cambio se realice correctamente.

Solución alternativa: Puede confirmar que el cambio en las etiquetas se realizó correctamente y omitir o suprimir el mensaje de error según sea necesario.

Resumen de problemas conocidos activos del área de trabajo de Azure Synapse

Los siguientes son problemas conocidos con el área de trabajo de Synapse.

El servicio vinculado de Blob Storage con la identidad administrada asignada por el usuario (UAMI) no aparece en la lista

Es posible que el servicio vinculado no se pueda ver en Centro de datos ->Vinculado ->Azure Blob Storage después de configurar el servicio vinculado de Blob Storage para usar la autenticación "Identidad administrada asignada por el usuario" en Azure Synapse Analytics.

Solución alternativa: el equipo de ingeniería actualmente conoce este comportamiento y está trabajando en una corrección. Como alternativa, use el método de autenticación "Identidad administrada asignada por el sistema", en lugar de "Identidad administrada asignada por el usuario".

Error al eliminar el área de trabajo de Synapse No se puede eliminar la red virtual

Se produce un error al eliminar un área de trabajo de Synapse y aparece el mensaje:

Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;

Solución alternativa: el problema se puede mitigar mediante el reintento de la operación de eliminación. El equipo de ingeniería conoce este comportamiento y está trabajando en una corrección.

Error en las operaciones PUT de la API de REST o plantillas de ARM/Bicep para actualizar la configuración de red

Cuando se usa una plantilla de ARM, una plantilla de Bicep o una operación PUT directa de la API de REST para cambiar la configuración de acceso a la red pública o las reglas de firewall para un área de trabajo de Synapse, se puede producir un error en la operación.

Solución alternativa: El problema se puede mitigar mediante una operación PATCH de la API de REST o la interfaz de usuario de Azure Portal para invertir y reintentar los cambios de configuración deseados. El equipo de ingeniería conoce este comportamiento y está trabajando en una corrección.

Problema conocido que incorpora corchetes [] en el valor de Etiquetas

En el contexto de la actualización de valores de etiqueta dentro de un área de trabajo de Azure Synapse, la inclusión de corchetes ([]) provocará una operación de actualización incorrecta.

Solución alternativa: la solución alternativa actual consiste en evitar usar los corchetes ([]) en los valores de etiqueta del área de trabajo de Azure Synapse.

Errores de implementación en el área de trabajo de Synapse mediante Synapse-workspace-deployment v1.8.0 en acciones de GitHub con plantillas de ARM

El error se produce durante la implementación en producción y está relacionado con un desencadenador que contiene un nombre de host con una barra diagonal inversa doble.

El mensaje de error que se muestra es Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.

Solución alternativa: se pueden realizar las siguientes acciones como mitigación rápida:

  • Quitar caracteres de escape: quite manualmente los caracteres de escape (\) del archivo de parámetros antes de la implementación. Esto significa editar el archivo para eliminar estos caracteres que podrían estar causando problemas durante la fase de análisis o procesamiento de la implementación.
  • Reemplazar caracteres de escape por barras diagonales: reemplace los caracteres de escape (\) por barras diagonales (/). Esto puede ser especialmente útil en las rutas de acceso de archivo, en las que muchos sistemas aceptan barras diagonales como separadores de ruta de acceso válidos. Este reemplazo puede ayudar a resolver el problema con los caracteres de escape, lo que permite que el proceso de implementación se realice correctamente.

Después de aplicar cualquiera de estas soluciones alternativas y realizar la implementación correctamente, actualice manualmente las configuraciones necesarias en el área de trabajo para asegurarse de que todo está configurado correctamente. Esto puede implicar editar archivos de configuración, ajustar la configuración o realizar otras tareas relevantes para el entorno o la aplicación específicos que se implementan.

No hay ninguna operación de API "GET" dedicada a la configuración "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled"

Resumen del problema: En Azure Synapse Analytics, no hay ninguna operación de API "GET" dedicada para recuperar el estado de la configuración "trustedServiceBypassEnabled" en el ámbito del recurso "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". Aunque los usuarios pueden establecer esta configuración, no pueden recuperar directamente su estado a través de este ámbito de recurso específico.

Impacto: Esta limitación afecta a las definiciones de Azure Policy, ya que no pueden aplicar un estado específico para la configuración "trustedServiceBypassEnabled". Los clientes no pueden usar Azure Policy para denegar o administrar esta configuración.

Solución alternativa: No hay ninguna solución alternativa disponible en Azure Policy para aplicar el estado de configuración deseado para esta propiedad. Sin embargo, los usuarios pueden usar la operación del área de trabajo "GET" para auditar el estado de configuración con fines de informes.
Esta operación de área de trabajo "GET" se asigna al alias de Azure Policy "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled".

El alias de Azure Policy puede ser usado para administrar esta propiedad con un efecto de directiva Azure Deny si la operación es una solicitud PUT contra el recurso Microsoft.Synapse/workspace, pero solo funcionará para propósitos de auditoria si la solicitud PUT esta siendo enviada directamente al recurso secundario Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. El recurso primario tiene una propiedad [properties.trustedServiceBypassEnabled] que asigna la configuración del recurso secundario y por eso todavía se puede auditar a través del alias de Azure Policy del recurso primario.

Dado que el recurso secundario Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration no tiene ninguna operación GET disponible, Azure Policy no puede administrar estas solicitudes y Azure Policy no puede generar un alias de Azure Policy para él.

Recurso primario: Microsoft.Synapse/workspaces

Recurso secundario: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

Azure Portal realiza la solicitud PUT directamente a la API de PUT para el recurso secundario y, por tanto, Azure Portal, junto con cualquier otra solicitud de API realizada fuera de las API primarias de Microsoft.Synapse/workspaces, no se puede administrar mediante Azure Policy a través de un efecto de Azure Policy denegable u otro efecto accionable de Azure Policy.

Resumen de problemas conocidos activos del grupo de SQL sin servidor de Azure Synapse Analytics

Errores de consulta del grupo de SQL sin servidor al almacén analítico de Azure Cosmos DB

Es posible que se produzca un error en las consultas que se realicen desde un grupo de SQL sin servidor al almacén de análisis de Azure Cosmos DB con uno de los siguientes mensajes de error:

  • Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'
  • Resolving CosmosDB path has failed with error 'Key not found'

Para confirmarse este problema deben darse las siguientes condiciones:

  1. La conexión al almacén de análisis de Azure Cosmos DB usa un punto de conexión privado.
  2. La consulta se vuelve a intentar y el resultado es satisfactorio.

Solución alternativa: el equipo de ingeniería conoce este comportamiento y se pueden realizar las siguientes acciones para mitigarlo rápidamente:

  1. Vuelva a intentar la consulta con errores. El token expirado se actualizará automáticamente.
  2. Deshabilite el punto de conexión privado. Antes de aplicar este cambio, confirme con el equipo de seguridad que cumple las directivas de seguridad de la empresa.

La vista del almacén analítico de Azure Cosmos DB propaga atributos incorrectos en la columna

Al usar vistas en el grupo sin servidor Azure Synapse sobre el almacén analítico Cosmos DB, si se produce un cambio en los archivos del almacén analítico Cosmos DB, el cambio no se propaga correctamente a las instrucciones SELECT que el cliente usa en la vista. Como resultado, los atributos se asignan incorrectamente a una columna diferente en los resultados.

Solución alternativa: el equipo de ingeniería conoce este comportamiento y se pueden realizar las siguientes acciones para mitigarlo rápidamente:

  1. Vuelva a crear la vista cambiando el nombre de las columnas.
  2. Evite el uso de vistas si es posible.

Se produce un error en la modificación de la credencial con ámbito de base de datos si se ha usado la credencial

Es posible que a veces no pueda ejecutar la consulta ALTER DATABASE SCOPED CREDENTIAL. La causa principal de este problema es que la credencial se almacena en caché después de su primer uso, lo que hace que sea inaccesible para la modificación. El error devuelto es:

  • Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.

Solución alternativa: el equipo de ingeniería actualmente conoce este comportamiento y está trabajando en una corrección. Como solución alternativa, puede COLOCAR y CREAR las credenciales, lo que también significaría volver a crear tablas externas mediante las credenciales. Como alternativa, puede ponerse en contacto con el equipo de Soporte técnico de Microsoft para obtener ayuda.

Errores de consulta en grupos de SQL sin servidor

La expiración del token puede provocar errores durante la ejecución de la consulta, a pesar de tener los permisos necesarios para el usuario en el almacenamiento. Estos mensajes de error también pueden producirse debido a errores comunes de usuario, como cuando los roles de control de acceso basado en rol (RBAC) no están asignados a la cuenta de almacenamiento.

Ejemplo de mensajes de error:

  • WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}
  • Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.
  • Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.
  • Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.
  • Error 16536: Cannot bulk load because the file "%ls" could not be opened.

Solución alternativa:

La resolución es diferente en función de la autenticación, Microsoft Entra (anteriormente Azure Active Directory) o identidad de servicio administrada (MSI):

Para la expiración de tokens de Microsoft Entra:

Para la expiración de tokens de MSI:

  • Desactive y active el grupo para borrar la caché del token. Póngase en contacto con el equipo de Soporte técnico de Microsoft para obtener ayuda.

Problemas de acceso de almacenamiento debido a que el encabezado de autorización es demasiado largo

Mensajes de error de ejemplo en grupos de SQL sin servidor:

  • File {path} cannot be opened because it does not exist or it is used by another process.
  • Content of directory on path {path} cannot be listed.
  • WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}

Estos errores genéricos de acceso al almacenamiento aparecen al ejecutar una consulta. El problema puede producirse para un usuario de una área de trabajo, pero funcionaría correctamente en otras áreas de trabajo. Este comportamiento se espera debido al tamaño del token.

Para comprobar la longitud del token de Microsoft Entra, ejecute el siguiente comando en PowerShell. El valor del parámetro -ResourceUrl será diferente para las nubes no publicadas. Si la longitud del token está cerca de 11000 o más, consulte la sección Mitigación.

(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length

Solución alternativa:

Las soluciones alternativas sugeridas son:

  • Cambie a autorización de almacenamiento de identidad administrada, tal como se describe en el control de acceso de almacenamiento.
  • Reducir el número de grupos de seguridad (tener 90 o menos resultados de grupos de seguridad con un token de longitud compatible).
  • Aumente el número de grupos de seguridad en más de 200 (a medida que cambia cómo se construye el token, contendrá un identificador URI de MS Graph API en lugar de una lista completa de grupos). Se puede lograr agregando grupos ficticios o artificiales siguiendo los grupos administrados, después de que necesite agregar usuarios a grupos recién creados.

La consulta de una vista muestra resultados inesperados

Al consultar la vista para la que el esquema subyacente ha cambiado después de crear la vista, es posible que encuentre resultados inesperados. Esto significa que la vista hace referencia a columnas u objetos modificados o que ya no existen. Para superar esto, debe ajustar manualmente la definición de vista para alinearse con los cambios de esquema subyacentes.

Solución alternativa: ajuste manualmente la definición de vista.

Problemas conocidos cerrados recientemente

Componente de Synapse Problema Estado Fecha de resolución
Grupo de SQL sin servidor de Azure Synapse Se produce un error en las consultas que usan la autenticación de Microsoft Entra después de 1 hora Resuelto Agosto de 2023
Grupo de SQL sin servidor de Azure Synapse Errores de consulta al leer datos de Cosmos DB mediante OPENROWSET Resuelto Marzo de 2023
Grupo de Apache Spark con Azure Synapse No se pudo escribir en el grupo dedicado de SQL desde Synapse Spark mediante el conector de grupo de SQL dedicado de Azure Synapse para Apache Spark al usar cuadernos en canalizaciones Resuelto Junio de 2023
Grupo de Apache Spark con Azure Synapse Un trabajo o una tarea determinados de Spark generan un error demasiado rápido con el código de error 503 debido al límite de la cuenta de almacenamiento Resuelto Noviembre de 2023
Grupo de Apache Spark con Azure Synapse Error de consulta con una cláusula LIKE mediante el conector del grupo de SQL dedicado de Synapse en runtime de Spark 3.4 Resuelto Octubre de 2024

Resumen de problemas conocidos cerrados recientemente del grupo de SQL sin servidor de Azure Synapse Analytics

Se produce un error en las consultas que usan la autenticación de Microsoft Entra después de 1 hora

Las conexiones SQL que usan la autenticación de Microsoft Entra y permanezcan activas durante más de 1 hora comienzan a generar un error. Esto incluye consultar el almacenamiento mediante la autenticación transferida e instrucciones de Microsoft Entra que interactúan con Microsoft Entra ID, como CREATE EXTERNAL PROVIDER. Esto afecta a todas las herramientas que mantienen las conexiones activas, como el editor de consultas de SSMS y ADS. Las herramientas que abren una conexión nueva para ejecutar consultas no se ven afectadas, como Synapse Studio.

Estado: Resuelto

Errores de consulta al leer datos de Azure Cosmos DB mediante OPENROWSET

Las consultas del grupo de SQL sin servidor al almacén de análisis de Cosmos DB mediante OPENROWSET producen el siguiente mensaje de error:

Resolving CosmosDB path has failed with error 'bad allocation'.

Estado: resuelto

Resumen de problemas conocidos cerrados recientemente del grupo de Apache Spark de Azure Synapse Analytics

No se pudo escribir en el grupo dedicado de SQL desde Synapse Spark mediante el conector de grupo de SQL dedicado de Azure Synapse para Apache Spark al usar cuadernos en canalizaciones

Al usar el conector de grupo de SQL dedicado de Azure Synapse para Apache Spark para escribir en el grupo dedicado de Azure Synapse mediante cuadernos en canalizaciones, se vería un mensaje de error:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.

Estado: resuelto

Un trabajo o una tarea determinados de Spark generan un error demasiado rápido con el código de error 503 debido al límite de la cuenta de almacenamiento

Entre el 3 de octubre de 2023 y el 16 de noviembre de 2023, algunos grupos de Apache Spark de Azure Synapse Analytics podrían haber experimentado errores de trabajo y tareas de Spark al superarse el umbral de límite de API de almacenamiento.

Estado: resuelto

Error de consulta con una cláusula LIKE mediante el conector del grupo de SQL dedicado de Synapse en runtime de Spark 3.4

El código abierto Apache Spark 3.4 ha introducido un problema, que escapa a caracteres especiales, pero Synapse SQL no admite la palabra clave escape. Cuando los clientes usan el conector de grupo de SQL dedicado de Azure Synapse para Apache Spark, puede generar una consulta SQL no válida para Synapse SQL y el trabajo por lotes o cuaderno de Synapse Spark produciría un error similar al siguiente:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''

Estado: resuelto