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
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 tempdb
SQL 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:
- A ligação ao arquivo analítico do Azure Cosmos DB utiliza um ponto final privado.
- 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:
- Repita a consulta falhada. A repetição atualizará automaticamente o token expirado.
- 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:
- Recrie o modo de exibição renomeando as colunas.
- 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 consultas de longa duração, alterne para entidade de serviço, identidade gerenciada ou assinatura de acesso compartilhado (SAS) em vez de usar uma identidade de usuário. Para obter mais informações, consulte Controlar o acesso à conta de armazenamento para pool SQL sem servidor no Azure Synapse Analytics.
Reinicie o cliente (SSMS/ADS) para adquirir um novo token para estabelecer a conexão.
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