Partilhar via


Problemas conhecidos do Azure Synapse Analytics

Esta página lista os problemas conhecidos no Azure Synapse Analytics e sua data de resolução ou possível solução alternativa. Antes de enviar uma solicitação de suporte do Azure, revise essa lista para ver se o problema que você está enfrentando já é conhecido e está sendo resolvido.

Para saber mais sobre o Azure Synapse Analytics, consulte Visão geral do Azure Synapse Analytics e O que há de novo no Azure Synapse Analytics?

Problemas conhecidos ativos

Componente Sinapse do Azure Status Problema
Azure Synapse pool SQL dedicado Os clientes não conseguem monitorar o uso do pool SQL dedicado usando métricas Tem solução alternativa
Azure Synapse pool SQL dedicado Falha de consulta ao ingerir um arquivo parquet em uma tabela com AUTO_CREATE_TABLE='ON' Tem solução alternativa
Azure Synapse pool SQL dedicado Consultas com falha com erro de exfiltração de dados Tem solução alternativa
Azure Synapse pool SQL dedicado A instrução UPDATE STATISTICS falha com erro: "O fluxo de estatísticas fornecido está corrompido." Tem solução alternativa
Azure Synapse serverless SQL pool Falhas de consulta do pool SQL sem servidor para o repositório analítico do Azure Cosmos DB Tem solução alternativa
Azure Synapse serverless SQL pool A exibição do repositório analítico do Azure Cosmos DB propaga atributos errados na coluna Tem solução alternativa
Azure Synapse serverless SQL pool Falhas de consulta em pools SQL sem servidor Tem solução alternativa
Azure Synapse serverless SQL pool Problemas de acesso ao armazenamento devido ao cabeçalho de autorização ser muito longo Tem solução alternativa
Azure Synapse serverless SQL pool Consultar uma vista mostra resultados inesperados Tem solução alternativa
Azure Synapse Workspace O serviço vinculado de armazenamento de Blob com UAMI (User Assigned Managed Identity) não está sendo listado Tem solução alternativa
Azure Synapse Workspace Falha ao excluir o espaço de trabalho Synapse & Não é possível excluir a rede virtual Tem solução alternativa
Azure Synapse Workspace Falha nas operações REST API PUT ou modelos ARM/Bicep para atualizar as configurações de rede Tem solução alternativa
Azure Synapse Workspace Problema conhecido ao incorporar colchetes [] no valor de Tags Tem solução alternativa
Azure Synapse Workspace Falhas de implantação no Synapse Workspace usando Synapse-workspace-deployment v1.8.0 em ações do GitHub com modelos ARM Tem solução alternativa
Azure Synapse Workspace Nenhuma GET operação de API dedicada à Microsoft.Synapse/workspaces/trustedServiceBypassEnabled configuração Tem solução alternativa

Resumo de problemas conhecidos ativos do pool SQL dedicado do Azure Synapse Analytics

Os clientes não conseguem monitorar o uso do pool SQL dedicado usando métricas

Uma atualização interna de nossa lógica de emissão de telemetria, destinada a melhorar o desempenho e a confiabilidade de nossos dados de telemetria, causou um problema inesperado que afetou a capacidade de alguns clientes de monitorar seu pool tempdbSQL dedicado e métricas de E/S de dados do Data Warehouse.

Solução alternativa: Ao identificar o problema, nossa equipe tomou medidas para identificar a causa raiz e atualizar a configuração em nosso sistema. Os clientes podem corrigir o problema pausando e retomando sua instância, o que restaurará o estado normal da instância e o fluxo de dados de telemetria.

Falha de consulta ao ingerir um arquivo parquet em uma tabela com AUTO_CREATE_TABLE='ON'

Os clientes que tentam ingerir um arquivo parquet em uma tabela distribuída por hash podem AUTO_CREATE_TABLE='ON' receber o seguinte erro:

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

Não há suporte para ingestão em uma tabela distribuída por hash criada automaticamente usando AUTO_CREATE_TABLE. Os clientes que carregaram anteriormente usando esse cenário sem suporte devem CTAS seus dados em uma nova tabela e usá-los no lugar da tabela antiga.

Consultas com falha com erro de exfiltração de dados

Espaços de trabalho Synapse criados a partir de um pool SQL dedicado existente relatam falha de consulta relacionada à Proteção de Exfiltração de Dados com mensagem de erro genérica enquanto a Proteção de Exfiltração de Dados está desativada no Synapse Analytics:

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

Solução alternativa: Se você encontrou um erro semelhante, entre em contato com a Equipe de Suporte da Microsoft para obter assistência.

FALHA NAS ESTATÍSTICAS DE ATUALIZAÇÃO

Alguns pools SQL dedicados podem encontrar uma exceção ao executar uma UPDATE STATISTICS instrução. O comando resulta na mensagem "O fluxo de estatísticas fornecido está corrompido" e não consegue atualizar suas estatísticas.

Quando uma nova restrição é adicionada a uma tabela, uma estatística relacionada é criada nas distribuições. Se um índice clusterizado também for criado na tabela, ele deverá incluir as mesmas colunas (na mesma ordem) que a restrição, caso contrário UPDATE STATISTICS , os comandos nessas colunas poderão falhar.

Solução alternativa: identifique se existe uma restrição e um índice clusterizado na tabela. Em caso afirmativo, DESCARTE a restrição e o índice clusterizado. Depois disso, recrie o índice clusterizado e, em seguida, a restrição garantindo que ambos incluam as mesmas colunas na mesma ordem. Se a tabela não tiver uma restrição e um índice clusterizado, ou se a etapa acima resultar no mesmo erro, contate a Equipe de Suporte da Microsoft para obter assistência.

As atualizações de tags parecem falhar

Ao fazer uma alteração nas marcas de um pool SQL dedicado por meio do portal do Azure ou de outros métodos, uma mensagem de erro pode aparecer mesmo que a alteração seja feita com êxito.

Solução alternativa: você pode confirmar que a alteração nas tags foi bem-sucedida e ignorar/suprimir a mensagem de erro conforme necessário.

Resumo de problemas conhecidos ativos do espaço de trabalho do Azure Synapse

A seguir estão problemas conhecidos com o espaço de trabalho Sinapse.

O serviço vinculado de armazenamento de Blob com UAMI (User Assigned Managed Identity) não está sendo listado

O serviço vinculado pode não estar visível no Data Hub ->Linked ->Azure Blob Storage depois de configurar o serviço vinculado de armazenamento de blob para usar a autenticação "User Assigned Managed Identity" no Azure Synapse Analytics.

Solução alternativa: A equipe de engenharia está atualmente ciente desse comportamento e trabalhando em uma correção. Como alternativa, use o método de autenticação "System Assigned Managed Identity" em vez de "User Assigned Managed Identity".

Falha ao excluir o espaço de trabalho Synapse & Não é possível excluir a rede virtual

A exclusão de um espaço de trabalho Synapse falha com a mensagem de erro:

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

Solução alternativa: O problema pode ser atenuado tentando novamente a operação de exclusão. A equipe de engenharia está ciente desse comportamento e trabalhando em uma correção.

Falha nas operações REST API PUT ou modelos ARM/Bicep para atualizar as configurações de rede

Ao usar um modelo ARM, modelo Bicep ou operação direta REST API PUT para alterar as configurações de acesso à rede pública e/ou regras de firewall para um espaço de trabalho Synapse, a operação pode falhar.

Solução alternativa: o problema pode ser atenuado usando uma operação REST API PATCH ou a interface do usuário do portal do Azure para reverter e repetir as alterações de configuração desejadas. A equipe de engenharia está ciente desse comportamento e trabalhando em uma correção.

Problema conhecido ao incorporar colchetes [] no valor de Tags

No contexto da atualização de valores de marca em um espaço de trabalho do Azure Synapse, a inclusão de colchetes ([]) resultará em uma operação de atualização malsucedida.

Solução alternativa: A solução atual é abster-se de usar os colchetes ([]) nos valores de marca do espaço de trabalho Sinapse do Azure.

Falhas de implantação no Synapse Workspace usando Synapse-workspace-deployment v1.8.0 em ações do GitHub com modelos ARM

A falha ocorre durante a implantação na produção e está relacionada a um gatilho que contém um nome de host com uma barra invertida dupla.

A mensagem de erro exibida é Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.

Solução alternativa: As seguintes ações podem ser tomadas como atenuação rápida:

  • Remover caracteres de escape: remova manualmente todos os caracteres de escape (\) do arquivo de parâmetros antes da implantação. Isso significa editar o arquivo para eliminar esses caracteres que poderiam estar causando problemas durante o estágio de análise ou processamento da implantação.
  • Substitua os caracteres de escape por barras para frente: substitua os caracteres de escape (\) por barras/ (). Isso pode ser particularmente útil em caminhos de arquivo, onde muitos sistemas aceitam barras para frente como separadores de caminho válidos. Essa substituição pode ajudar a contornar o problema com caracteres de escape, permitindo que o processo de implantação seja bem-sucedido.

Depois de aplicar qualquer uma dessas soluções alternativas e implantar com êxito, atualize manualmente as configurações necessárias no espaço de trabalho para garantir que tudo esteja configurado corretamente. Isso pode envolver a edição de arquivos de configuração, o ajuste de configurações ou a execução de outras tarefas relevantes para o ambiente ou aplicativo específico que está sendo implantado.

Nenhuma operação de API 'GET' dedicada à configuração "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled"

Resumo do problema: No Azure Synapse Analytics, não há nenhuma operação de API 'GET' dedicada para recuperar o estado da configuração "trustedServiceBypassEnabled" no escopo do recurso "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". Embora os usuários possam definir essa configuração, eles não podem recuperar diretamente seu estado por meio desse escopo de recurso específico.

Impacto: essa limitação afeta as definições da Política do Azure, pois elas não podem impor um estado específico para a configuração "trustedServiceBypassEnabled". Os clientes não podem usar a Política do Azure para negar ou gerenciar essa configuração.

Solução alternativa: não há nenhuma solução alternativa disponível na Política do Azure para impor o estado de configuração desejado para essa propriedade. No entanto, os usuários podem usar a operação do espaço de trabalho 'GET' para auditar o estado de configuração para fins de relatório.
Esta operação de espaço de trabalho 'GET' é mapeada para o Alias de Política do Azure 'Microsoft.Synapse/workspaces/trustedServiceBypassEnabled'.

O Alias de Política do Azure pode ser usado para gerenciar essa propriedade com um Efeito de Política do Azure Negar se a operação for uma solicitação PUT no recurso Microsoft.Synapse/workspace, mas só funcionará para fins de Auditoria se a solicitação PUT estiver sendo enviada diretamente para o recurso filho Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. O recurso pai tem uma propriedade [properties.trustedServiceBypassEnabled] que mapeia a configuração do recurso filho e é por isso que ele ainda pode ser auditado por meio do Alias de Política do Azure do recurso pai.

Como o recurso filho Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration não tem nenhuma operação GET disponível, a Política do Azure não pode gerenciar essas solicitações e a Política do Azure não pode gerar um Alias de Política do Azure para ela.

Recurso pai: Microsoft.Synapse/workspaces

Recurso filho: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

O portal do Azure faz a solicitação PUT diretamente para a API PUT para o recurso filho e, portanto, o portal do Azure, juntamente com quaisquer outras solicitações de API feitas fora das APIs pai Microsoft.Synapse/workspaces, não pode ser gerenciado pela Política do Azure por meio de um Deny ou outro Efeito de Política do Azure acionável.

Resumo de problemas conhecidos ativos do pool SQL sem servidor do Azure Synapse Analytics

Falhas de consulta do pool SQL sem servidor para o repositório analítico do Azure Cosmos DB

As consultas de um conjunto de SQL sem servidor para o arquivo analítico do Azure Cosmos DB podem falhar com uma das seguintes mensagens de erro:

  • 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 confirmar este problema, as seguintes condições têm de ser verdadeiras:

  1. A ligação ao arquivo analítico do Azure Cosmos DB utiliza um ponto final privado.
  2. A repetição da consulta resulta.

Solução alternativa: A equipe de engenharia está ciente desse comportamento e as seguintes ações podem ser tomadas como mitigação rápida:

  1. Repita a consulta falhada. A repetição atualizará automaticamente o token expirado.
  2. Desative o ponto final privado. Antes de aplicar, confirme junto da sua equipa de segurança que esta alteração cumpre as políticas de segurança da sua empresa.

A exibição do repositório analítico do Azure Cosmos DB propaga atributos errados na coluna

Ao usar modos de exibição no pool sem servidor do Azure Synapse no repositório analítico do Cosmos DB, se houver uma alteração nos arquivos no repositório analítico do Cosmos DB, a alteração não será propagada corretamente para as instruções SELECT, o cliente está usando na exibição. Como resultado, os atributos são mapeados incorretamente para uma coluna diferente nos resultados.

Solução alternativa: A equipe de engenharia está ciente desse comportamento e as seguintes ações podem ser tomadas como mitigação rápida:

  1. Recrie o modo de exibição renomeando as colunas.
  2. Evite usar modos de exibição, se possível.

Alterar credencial com escopo de banco de dados falhará se a credencial tiver sido usada

Às vezes, talvez não seja possível executar a ALTER DATABASE SCOPED CREDENTIAL consulta. A causa raiz desse problema é que a credencial foi armazenada em cache após seu primeiro uso, tornando-a inacessível para alteração. O erro retornado é:

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

Solução alternativa: A equipe de engenharia está ciente desse comportamento e está trabalhando em uma correção. Como solução alternativa, você pode SOLTAR e CRIAR as credenciais, o que também significaria recriar tabelas externas usando as credenciais. Como alternativa, você pode contratar a Equipe de Suporte da Microsoft para obter assistência.

Falhas de consulta em pools SQL sem servidor

A expiração do token pode levar a erros durante a execução da consulta, apesar de ter as permissões necessárias para o usuário no armazenamento. Essas mensagens de erro também podem ocorrer devido a erros comuns do usuário, como quando funções RBAC (controle de acesso baseado em função) não são atribuídas à conta de armazenamento.

Exemplo de mensagens de erro:

  • 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.

Solução:

A resolução é diferente dependendo da autenticação, do Microsoft Entra (anteriormente Azure Ative Directory) ou da identidade de serviço gerenciado (MSI):

Para expiração do token Microsoft Entra:

Para expiração do token MSI:

  • Desative e ative o pool para limpar o cache de tokens. Contacte a Equipa de Suporte da Microsoft para obter assistência.

Problemas de acesso ao armazenamento devido ao cabeçalho de autorização ser muito longo

Exemplo de mensagens de erro em pools SQL sem 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}

Esses erros genéricos de acesso ao armazenamento aparecem ao executar uma consulta. O problema pode ocorrer para um usuário em um espaço de trabalho, mas funcionaria corretamente em outros espaços de trabalho. Esse comportamento é esperado devido ao tamanho do token.

Verifique o comprimento do token do Microsoft Entra executando o seguinte comando no PowerShell. O valor do -ResourceUrl parâmetro será diferente para nuvens não públicas. Se o comprimento do token estiver próximo de 11000 ou mais, consulte a seção Mitigação .

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

Solução:

As soluções alternativas sugeridas são:

  • Mude para a autorização de armazenamento de Identidade Gerenciada conforme descrito no controle de acesso de armazenamento.
  • Diminua o número de grupos de segurança (ter 90 ou menos resultados de grupos de segurança com um token de comprimento compatível).
  • Aumente o número de grupos de segurança acima de 200 (como isso altera a forma como o token é construído, ele conterá um URI da API do MS Graph em vez de uma lista completa de grupos). Isso poderia ser alcançado adicionando grupos fictícios/artificiais seguindo grupos gerenciados, depois que você precisaria adicionar usuários a grupos recém-criados.

Consultar uma vista mostra resultados inesperados

Quando você consulta o modo de exibição para o qual o esquema subjacente foi alterado depois que o modo de exibição foi criado, você pode encontrar resultados inesperados. Isso significa que o modo de exibição faz referência a colunas ou objetos que foram modificados ou não existem mais. Para superar isso, você precisa ajustar manualmente a definição de exibição para alinhar com as alterações de esquema subjacentes.

Solução alternativa: ajuste manualmente a definição de exibição.

Problemas conhecidos recentemente encerrados

Componente Sinapse Problema Status Data de resolução
Azure Synapse serverless SQL pool Consultas usando a autenticação do Microsoft Entra falham após 1 hora Resolvido Agosto de 2023
Azure Synapse serverless SQL pool Falhas de consulta durante a leitura de dados do Cosmos DB usando OPENROWSET Resolvido Março de 2023
Azure Synapse Apache Spark pool Falha ao gravar no Pool Dedicado SQL do Synapse Spark usando o Conector do pool SQL dedicado do Azure Synapse para Apache Spark ao usar blocos de anotações em pipelines Resolvido Junho de 2023
Azure Synapse Apache Spark pool Determinado trabalho ou tarefa de faísca falha muito cedo com o Código de erro 503 devido à limitação da conta de armazenamento Resolvido Novembro de 2023
Azure Synapse Apache Spark pool Falha de consulta com uma cláusula LIKE usando o Synapse Dedicated SQL Pool Connector no tempo de execução do Spark 3.4 Resolvido Outubro de 2024

Azure Synapse Analytics serverless SQL pool recentemente fechado resumo de problemas conhecidos

Consultas usando a autenticação do Microsoft Entra falham após 1 hora

As conexões SQL usando a autenticação do Microsoft Entra que permanecem ativas por mais de 1 hora começam a falhar. Isso inclui consultar o armazenamento usando a autenticação de passagem do Microsoft Entra e instruções que interagem com o ID do Microsoft Entra, como CREATE EXTERNAL PROVIDER. Isso afeta todas as ferramentas que mantêm as conexões ativas, como o editor de consultas no SSMS e no ADS. Ferramentas que abrem nova conexão para executar consultas não são afetadas, como o Synapse Studio.

Estado: Resolvido

Falhas de consulta ao ler dados do Azure Cosmos DB usando OPENROWSET

Consultas do pool SQL sem servidor para o Cosmos DB Analytical Store usando OPENROWSET falham com a seguinte mensagem de erro:

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

Estado: Resolvido

Azure Synapse Analytics Apache Spark pool recentemente fechado resumo de problemas conhecidos

Falha ao gravar no Pool Dedicado SQL do Synapse Spark usando o conector do pool SQL dedicado do Azure Synapse para Apache Spark ao usar blocos de anotações em pipelines

Ao usar o Azure Synapse dedicado SQL pool Connector for Apache Spark para escrever o pool dedicado do Azure Synapse usando Notebooks em pipelines, veríamos uma mensagem de erro:

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: Resolvido

Determinado trabalho ou tarefa de faísca falha muito cedo com o Código de erro 503 devido à limitação da conta de armazenamento

Entre 3 de outubro de 2023 e 16 de novembro de 2023, alguns pools do Apache Spark do Azure Synapse Analytics podem ter sofrido falhas de trabalho/tarefa de faísca devido ao limite da API de armazenamento ter sido excedido.

Estado: Resolvido

Falha de consulta com uma cláusula LIKE usando o Synapse Dedicated SQL Pool Connector no tempo de execução do Spark 3.4

O código aberto Apache Spark 3.4 introduziu um problema, que escapa de caracteres especiais, mas Synapse SQL não suporta a palavra-chave escape. Quando os clientes usam o Azure Synapse Dedicated SQL Pool Connector for Apache Spark, ele pode gerar uma consulta SQL inválida para Synapse SQL e o bloco de anotações Synapse Spark ou trabalho em lote lançaria um erro semelhante a:

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

Estado: Resolvido