Problemas conhecidos do Azure Synapse Analytics

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

Para saber mais sobre o Azure Synapse Analytics, confira Visão geral do Azure Synapse Analytics e Novidades do Azure Synapse Analytics

Problemas conhecidos ativos

Resumo dos problemas conhecidos do pool de 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 da nossa lógica de emissão de telemetria, destinada a aprimorar o desempenho e a confiabilidade de nossos dados de telemetria, causou um problema inesperado que afetou a capacidade de alguns clientes de monitorar o pool de SQL dedicado, tempdbe as 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 a instância deles, o que restaurará o estado normal da instância e o fluxo de dados de telemetria.

Falha na 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 com AUTO_CREATE_TABLE='ON' podem 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 tinham carregado anteriormente usando esse cenário sem suporte devem usar CTAS para colocar seus dados em uma nova tabela e usá-la no lugar da tabela antiga.

Consultas falhando com erro de exfiltração de dados

Os espaços de trabalho do Synapse criados com um pool de SQL dedicado existente relatam falhas de consulta relacionadas à Proteção contra Exfiltração de Dados com mensagem de erro genérica enquanto a Proteção contra 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 Suporte da Microsoft Equipe para obter assistência.

Falha de ESTATÍSTICAS DE ATUALIZAÇÃO

Alguns pools de SQL dedicados podem encontrar uma exceção ao executar uma instrução UPDATE STATISTICS. O comando resulta na mensagem "O fluxo de estatísticas fornecido está corrompido" e não atualiza 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 precisará incluir as mesmas colunas (na mesma ordem) da restrição, caso contrário, os comandos UPDATE STATISTICS nessas colunas poderão falhar.

Solução alternativa: identifique se existe uma restrição e um índice clusterizado na tabela. Nesse caso, remova a restrição e o índice clusterizado. Depois disso, recrie o índice clusterizado e, em seguida, a restrição, garantindo que as duas 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, entre em contato com a Equipe de Suporte da Microsoft para obter assistência.

As atualizações de marca parecem falhar

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

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

Resumo de problemas conhecidos do workspace do Azure Synapse

A seguir estão os problemas conhecidos com o workspace do Synapse.

O serviço vinculado do armazenamento de blobs com a UAMI (Identidade Gerenciada Atribuída pelo Usuário) não está sendo listado

Talvez o serviço vinculado não esteja visível no Hub de Dados ->Vinculado ->Armazenamento de Blobs do Azure após a configuração do serviço vinculado do armazenamento de blobs para usar a autenticação da “Identidade Gerenciada Atribuída pelo Usuário” 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 "Identidade Gerenciada Atribuída pelo Sistema" em vez de "Identidade Gerenciada Atribuída pelo Usuário".

Falha ao excluir o workspace do Synapse e Não é possível excluir a rede virtual

A exclusão de um workspace do 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 repetindo a operação de exclusão. A equipe de engenharia está ciente desse comportamento e trabalhando em uma correção.

Operações PUT da API REST ou modelos ARM/Bicep para atualizar as configurações de rede falham

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

Solução alternativa: o problema pode ser mitigado com uma operação PATCH da API REST 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 Marcas

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

Solução alternativa: a solução alternativa atual é abster-se de usar os colchetes ([]) nos valores de marca de workspace do Azure Synapse.

Falhas de implantação no Workspace do Synapse com synapse-workspace-deployment v1.8.0 no GitHub Actions com modelos do ARM

A falha ocorre durante a implantação para 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 realizadas como mitigação rápida:

• Remoção dos caracteres de escape: remova manualmente todos os caracteres de escape (\) do arquivo de parâmetros antes da implantação. Isso significa a edição do arquivo para eliminar esses caracteres que podem causar problemas durante a fase de análise ou processamento da implantação.
• Substituição dos caracteres de escape por barras "/": substitua os caracteres de escape (\) por barras "/" (/). Isso pode ser particularmente útil em caminhos de arquivo, em que muitos sistemas aceitam barras "/" como separadores de caminho válidos. Essa substituição pode ajudar a ignorar o problema com caracteres de escape, permitindo que o processo de implantação tenha êxito.

Depois de aplicar uma dessas soluções alternativas e implantá-la com êxito, atualize manualmente as configurações necessárias no workspace para garantir que tudo esteja configurado de maneira correta. Isso pode envolver a edição de arquivos de configuração, o ajuste das configurações ou a execução de outras tarefas relevantes para o ambiente ou o 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á operações de API “GET” dedicadas para recuperarem 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 esse escopo de recurso específico.

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

Solução alternativa: não há soluções alternativas disponíveis no Azure Policy para imporem o estado de configuração desejado para essa propriedade. Porém, os usuários podem usar a operação do espaço de trabalho “GET” para auditarem o estado de configuração para obterem relatórios.
Essa operação do espaço de trabalho “GET” é mapeada para o Alias do Azure Policy “Microsoft.Synapse/workspaces/trustedServiceBypassEnabled”.

O Alias do Azure Policy pode ser usado para gerenciar essa propriedade com um Efeito Negar o Azure Policy se a operação for uma solicitação PUT contra o recurso Microsoft.Synapse/workspace, mas só funcionará com a auditoria se a solicitação PUT for enviada diretamente para o recurso filho Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. O recurso pai possui a propriedade [properties.trustedServiceBypassEnabled] que mapeia a configuração do recurso filho e é por isso que ele ainda pode ser auditado pelo Alias do Azure Policy do recurso pai.

Como o recurso filho Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration não possui operações GET disponíveis, o Azure Policy não pode gerenciar essas solicitações e o Azure Policy não pode gerar um Alias do Azure Policy para ele.

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 do recurso filho e, portanto, o portal do Azure, juntamente com quaisquer outras solicitações de API feitas fora das APIs pai do Microsoft.Synapse/workspaces, não podem ser gerenciadas pelo Azure Policy por uma negação ou outro efeito acionável do Azure Policy.

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

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

Consultas de um pool de SQL sem servidor para o repositório 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'

As seguintes condições devem ser verdadeiras para confirmar esse problema:

1. A conexão com o repositório analítico do Azure Cosmos DB usa um ponto de extremidade privado.
2. A nova tentativa da consulta é bem-sucedida.

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 com falha. Isso atualizará automaticamente o token expirado.
2. Desabilitar o ponto de extremidade privado Antes de aplicar essa alteração, confirme com sua equipe de segurança que ela atende às políticas de segurança da empresa.

A exibição do armazenamento analítico do Azure Cosmos DB propaga atributos incorretos na coluna

Durante o uso de exibições no pool sem servidor do Azure Synapse no armazenamento analítico do Cosmos DB, se houver uma alteração nos arquivos no armazenamento analítico do Cosmos DB, a alteração não será propagada corretamente para as instruções SELECT que o cliente estiver 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 a exibição renomeando as colunas.
2. Evite usar as exibições, se possível.

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

Às vezes, talvez você não consiga executar a consulta ALTER DATABASE SCOPED CREDENTIAL. 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á atualmente ciente desse comportamento e trabalhando em uma correção. Como alternativa, você pode REMOVER 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 de 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, por exemplo, quando as funções do 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 alternativa:

A resolução é diferente, dependendo da autenticação, Microsoft Entra (antigo Azure Active Directory) ou MSI (identidade de serviço gerenciada):

No caso de expiração do token do Microsoft Entra:

• Para consultas de longa execução, alterne para a entidade de serviço, a identidade gerenciada ou a SAS (Assinatura de Acesso Compartilhado) em vez de usar uma identidade de usuário. Para obter mais informações, confira Controlar o acesso à conta de armazenamento para pool de SQL sem servidor no Azure Synapse Analytics.

• Reinicie o cliente (SSMS/ADS) para adquirir um novo token, a fim de estabelecer a conexão.

No caso de expiração do token da MSI:

• Desative e, em seguida, ative o pool para limpar o cache de token. Entre em contato com a Equipe 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 parâmetro -ResourceUrl será diferente para nuvens não públicas. Se o comprimento do token for próximo de 11000 ou mais, consulte a seção Mitigação.

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

Solução alternativa:

As soluções alternativas sugeridas são:

• Alterne para a autorização de armazenamento do Managed Identity, conforme descrito no controle de acesso de armazenamento.
• Diminuir o número de grupos de segurança (ter 90 ou menos grupos de segurança resulta 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 exibição mostra resultados inesperados

Quando você consulta a exibição para a qual o esquema subjacente foi alterado após a criação da exibição, você pode encontrar resultados inesperados. Isso significa que a 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 se alinhar com as alterações de esquema subjacentes.

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

Problemas conhecidos fechados recentemente

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

As consultas que usam a autenticação do Microsoft Entra falham após 1 hora

As conexões SQL que usam a autenticação do Microsoft Entra e 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 Microsoft Entra ID, como CREATE EXTERNAL PROVIDER. Isso afeta todas as ferramentas que mantêm conexões ativas, como o editor de consultas no SSMS e no ADS. As ferramentas que abrem novas conexões para executar consultas, como o Synapse Studio, não são afetadas.

Status: Resolvido

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

As consultas do pool de SQL sem servidor para o Repositório Analítico do Cosmos DB usando OPENROWSET falham com a seguinte mensagem de erro:

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

Status: resolvido

Resumo de problemas fechados recentemente conhecidos do pool do Apache Spark do Azure Synapse Analytics

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

Ao usar o Conector de pool SQL dedicado do Azure Synapse para Apache Spark para escrever o pool dedicado do Azure Synapse usando Blocos de Anotações 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.

Status: resolvido

Determinado trabalho ou tarefa do Spark 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 tarefas/trabalhos do Spark devido ao limite da API de armazenamento ter sido excedido.

Status: resolvido

Falha na consulta com uma cláusula LIKE usando o Conector de Pool de SQL Dedicado do Synapse no runtime Spark 3.4

O Apache Spark 3.4 de código aberto introduziu um problema, no qual caracteres especiais são escapados, mas o Synapse SQL não dá suporte à palavra-chave de escape. Quando os clientes usam o Conector de Pool de SQL Dedicado do Azure Synapse para Apache Spark, ele pode gerar uma consulta SQL inválida para o SQL do Synapse, e o notebook Spark do Synapse ou o trabalho em lote pode gerar 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%''

Status: resolvido

Conteúdo relacionado

• Solução de problemas do Synapse Studio
• Solucionar problemas de pool de SQL sem servidor no Azure Synapse Analytics
• Práticas recomendadas para pool de SQL sem servidor no Azure Synapse Analytics
• Solucionar problemas de uma consulta lenta em um Pool de SQL dedicado