Guia de solução de problemas do Link do Azure Synapse para Dataverse

Ao abrir um perfil do Azure Link do Synapse, você pode ver um erro com uma mensagem e um link para este artigo. Além disso, os usuários também podem ver o status de Erro ao lado de tabelas que já estão em um perfil do Azure Link do Synapse. Use este guia de solução de problemas para diagnosticar e corrigir condições de erro com Azure Link do Synapse para Dataverse.

Mensagem de erro Causa Resolução
MSI-801: Azure Link do Synapse não consegue acessar a conta de armazenamento protegida via MSI. As atualizações de dados estão pausadas. Você habilitou a MSI (identidade de serviços gerenciados) para a conta de armazenamento selecionada para este perfil do Azure Link do Synapse.
O serviço do Azure Link do Synapse não tem acesso à conta de armazenamento devido a problemas de configuração MSI e o serviço foi pausado.
Revisitar e verificar a configuração MSI
Verifique se a política MSI não foi excluída.
Valide se a MSI recebeu os privilégios de acesso necessários.
Mais informações: configuração MSI
Assim que o acesso necessário for concedido, o serviço será retomado.
ADLS-802: o Azure Link do Synapse não consegue acessar a conta de armazenamento. As atualizações de dados estão pausadas. O serviço Azure Link do Synapse não pode acessar a conta de armazenamento e o serviço foi pausado.
As permissões associadas à conta de armazenamento atribuída ao perfil do Azure Link do Synapse podem ter sido alteradas ou a conta de armazenamento não existe.
Verifique se a conta de armazenamento existe e se o serviço Azure Link do Synapse tem acesso de proprietário à conta de armazenamento.
Mais informações: Pré-requisitos
Assim que o acesso necessário for concedido, o serviço será retomado.
CT-803: Chave de configuração do rastreamento de alterações de versão de linha desabilitada em ambiente vinculado. As atualizações de dados em algumas tabelas podem ser pausadas. O serviço Link do Azure Synapse requer que a chave de configuração habilitar controle de alterações da versão da linha esteja habilitada no ambiente de aplicativos de finanças e operações vinculado. Essa chave de configuração está desabilitada no ambiente vinculado e o serviço pausou as tabelas de aplicativos de finanças e operações do ambiente vinculado.
É possível que uma operação de restauração do banco de dados tenha causado a reversão da configuração.
Habilite a chave de configuração e remova as tabelas de aplicativos de finanças e operações para continuar. As tabelas afetadas são inicializadas para refletir novos dados.
Seu administrador deve reativar a chave de configuração dos aplicativos de Finanças e Operações.
Mais informações: Adicionar configurações em um ambiente de aplicativos de finanças e operações
O serviço é retomado quando a chave de configuração é reativada.
DV-804: este ambiente está em modo admin, e o serviço está pausado. Quando um ambiente do Power Platform está no modo de administração, todos os serviços, incluindo o serviço Azure Synapse, são pausados temporariamente.
Quando Modo de administração está Desabilitado, os serviços são retomados.
Consulte o administrador de ambiente e verifique se o ambiente está operacional.
Verifique também se a configuração do ambiente Operações em segundo plano está Habilitada depois que Modo de administração está Desabilitado.
O serviço Azure Link do Synapse é retomado quando o ambiente estiver funcionando.
SYN-805: O espaço de trabalho do Synapse não está acessível. O serviço Azure Link do Synapse não pode acessar o espaço de trabalho Synapse associado a esse perfil.
As tabelas do Synapse podem não ser criadas imediatamente quando você resolve o problema. O sistema cria tabelas no espaço de trabalho do Synapse quando os dados são atualizados no Dataverse.
Na configuração de rede do espaço de trabalho do Synapse, habilite a opção Permitir que serviços e recursos do Azure acessem este espaço de trabalho.
Outras configurações de rede também podem impedir que o serviço de Link do Synapse do Azure chegue ao workspace. Verifique com o administrador se uma rede virtual gerenciada, uma regra de firewall de IP ou uma restrição de acesso à rede pública não está bloqueando o acesso ao workspace. Mais informações: Definir regras de firewall de IP e configurações de conectividade Azure Synapse Analytics
SYN-806: O contêiner de armazenamento padrão no espaço de trabalho do Synapse não está acessível. O espaço de trabalho do Synapse associado a esse perfil do Azure Link do Synapse não contém um sistema de arquivos primário do Azure Data Lake Storage Gen2. O contêiner de armazenamento padrão pode ser excluído ou não está acessível.
Um contêiner de armazenamento padrão é usado pelo espaço de trabalho do Synapse como armazenamento temporário na criação do sistema de arquivos. Um contêiner de armazenamento padrão deve ser fornecido durante a criação de um espaço de trabalho do Synapse.
É possível que esse contêiner de armazenamento tenha sido excluído ou não esteja mais acessível.
Peça ao administrador para abrir o workspace do Synapse e verificar o nome do sistema de arquivos primário do Azure Data Lake Storage Gen2.
Verifique também se existe um contêiner de armazenamento do Azure Data Lake Storage Gen2 com esse nome na mesma assinatura.
Se o contêiner de armazenamento não for encontrado, crie um contêiner de armazenamento com o mesmo nome.
SYN-809: o espaço de trabalho {name} do Synapse tem políticas de exfiltração de dados habilitadas. Você precisa escolher outro espaço de trabalho. Os perfis do Link do Synapse com a opção de conversão para Delta requerem espaços de trabalho do Synapse sem políticas de exfiltração de dados. Você provavelmente escolheu um espaço de trabalho do Synapse com políticas de exfiltração de dados, que interfere com os serviços de computação Link do Synapse. Peça ao administrador para fornecer um espaço de trabalho do Synapse onde as políticas de exfiltração de dados não estejam habilitadas. Você também pode considerar o uso do link Fabric como uma alternativa ao Link do Synapse.
SYN-810: o contêiner de armazenamento padrão associado ao espaço de trabalho do Synapse é restrito à rede. Os perfis do Link do Synapse com a opção de conversão para Delta requerem espaços de trabalho do Synapse com um contêiner de armazenamento padrão. Se o contêiner de armazenamento padrão associado ao espaço de trabalho Synapse selecionado tiver restrições de rede aplicadas, os serviços de computação Link do Synapse não poderão executar as atualizações necessárias. Peça ao administrador para remover as restrições de rede associadas ao contêiner de armazenamento padrão associado ao espaço de trabalho Synapse escolhido ou escolha outro espaço de trabalho do Synapse.
SPARK-807: o pool de computação do Spark {name} em {espaço de trabalho do Synapse} não está mais disponível. As atualizações de dados estão pausadas. O serviço do Azure Link do Synapse requer um pool do Spark para processar dados no formato delta. O pool do Spark fornecido com este perfil do Azure Link do Synapse é excluído ou não está mais disponível.
Também é possível que o acesso ao espaço de trabalho do Synapse tenha sido restrito.
Depois de resolver o problema, o serviço do Azure Link do Synapse retoma as atualizações de dados quando os dados são alterados.
Verifique se o pool do Spark com o nome escolhido existe. Se você ou alguém excluiu esse pool do Spark, crie o pool do Spark com o mesmo nome.
SPARK-808: o pool de computação do Spark {name} em {espaço de trabalho do Synapse} é insuficiente. Não foi possível atualizar uma ou mais tabelas. O serviço Azure Link do Synapse usa o pool de Spark fornecido na configuração para converter arquivos para o formato Delta Parquet sempre que os dados são atualizados.
Quando um grande lote de dados está disponível para atualização, o tamanho do pool do Spark fornecido no perfil do Azure Link do Synapse pode não fornecer poder de computação suficiente.
Isso pode acontecer especialmente quando você adiciona tabelas grandes, pois o processo de inicialização cria um lote de dados grande.
Isso também pode acontecer caso você tenha assinaturas "pré-pagas" com capacidade limitada. Os pools do Spark dentro desses tipos de assinaturas têm capacidade limitada.
Aumente o número de cores no pool do Spark atribuído a você.
O sistema utiliza a capacidade adicional no caso de cargas de trabalho maiores e reduz a escala conforme necessário.
Mais informações: Tamanhos de pool do Spark recomendados para conversão Delta
CT-809: Propriedade de rastreamento de alterações da versão de linha desabilitada na tabela. As atualizações de dados estão pausadas. O serviço Azure Link do Synapse exige a habilitação da propriedade de metadados rastreamento de alterações da versão da linha. Essa propriedade permanece desabilitada para a tabela, e a tabela não é mais atualizada.
A atualização dessa propriedade de metadados em finanças e operações exige a intervenção do desenvolvedor. É possível que a propriedade tenha sido desabilitada depois que o perfil do Azure Link do Synapse foi criado.
Reabilite a propriedade de metadados do controle de alterações da versão da linha para retomar a tabela.
Talvez você precise de um administrador ou desenvolvedor para reabilitar a propriedade usando ferramentas de desenvolvedor. Mais informações: Habilitar o controle de alterações da versão da linha para tabelas para obter detalhes.
CT-810: a propriedade Permitir controle de alterações da versão de linha desta tabela está definida como Não. O serviço do Azure Link do Synapse requer que a habilitação da propriedade de metadados Permitir o controle de alterações da versão de linha seja definida como Sim.
A atualização dessa propriedade de metadados em finanças e operações exige a intervenção do desenvolvedor. É possível que a propriedade tenha sido desativada após a criação do perfil do Link do Synapse.
Reabilite a propriedade de metadados do controle de alterações da versão da linha para retomar a tabela.
Talvez você precise de um administrador ou desenvolvedor para reabilitar a propriedade usando ferramentas de desenvolvedor. Mais informações: Habilitar o controle de alterações da versão da linha para tabelas para obter detalhes.
FnO-810: o ambiente de finanças e operações vinculado não está disponível ou está pausado. Ambiente de aplicativos de finanças e operações vinculado a este perfil do Azure Link do Synapse não está disponível ou em modo de manutenção. O serviço do Azure Link do Synapse não consegue entrar em contato com o ambiente e o serviço pausou tabelas originadas de aplicativos de finanças e operações.
No caso de ambientes hospedados em nuvem, é possível que o ambiente esteja em estado pausado.
Consulte o administrador se o ambiente vinculado não está pausado e não está em modo de manutenção.
O serviço Azure Link do Synapse é retomado quando o ambiente estiver funcionando.
FnO-811: o ambiente de finanças e operações vinculado precisa ser atualizado. O ambiente de aplicativos de finanças e operações vinculado a este perfil do Azure Link do Synapse precisa ser atualizado para a versão mais recente.
Se estiver atualmente em versões de finanças e operações PU60, PU61 ou PU62, você deverá atualizar para as atualizações cumulativas mais recentes
10.0.36 (PU 60) - 7.0.7036.133 ou posterior
10.0.37 (PU 61) - 7.0.7068.109 ou posterior
10.0.38 (PU 62) - 7.0.7120.59 ou posterior
As atualizações necessárias estão incluídas na atualização cumulativa 10.0.39 (PU63)
Entre em contato com o administrador dos aplicativos de finanças e operações e aplique as atualizações da versão mais recentes ao ambiente.
FnO-812: É necessário criar índices adicionais no ambiente de finanças e operações. Quando você seleciona tabelas de um ambiente de aplicativos de finanças e operações, o sistema cria índices adicionais no banco de dados para permitir a inicialização e as atualizações de dados mais eficientes. Esse erro indica que os índices estão ausentes para as tabelas. Isso pode ser devido a vários motivos.

Se você estiver recebendo esse erro em um Ambiente Hospedado na Nuvem (CHE), precisará habilitar flights e índices específicos, como descrito na documentação.

Se você estiver recebendo esse erro de um ambiente de sandbox ou de produção, a criação do índice pode sofrer atraso devido a operações intensivas no banco de dados.
Se este for um ambiente de CHE, contate o proprietário do ambiente.

Se este for um ambiente sandbox ou de produção, nenhuma ação é necessária. O sistema habilita a indexação após a conclusão de cargas de trabalho de pico em finanças e operações.
FnO-813: há um valor NULL inesperado no campo <...>. Verifique os dados na tabela e corrija os valores, conforme necessário. Esse erro é o resultado de um problema de dados encontrado pelo serviço ao transferir dados de aplicativos de finanças e operações. O serviço de finanças e operações não permite valores NULL em campos de dados. Portanto, um valor NULL é inesperado pelo serviço. Um caractere de espaço representa a ausência de um valor em aplicativos de finanças e operações. No entanto, durante a migração de dados, especialmente usando ferramentas externas, um valor NULL pode ter sido inserido em um campo de dados. Você pode examinar a tabela usando a interface de usuário do aplicativo de finanças e operações ou usando uma ferramenta para resolver o problema.

O sistema é retomado assim que o problema de dados é resolvido. Não é necessário reinicializar a tabela.
Os seguintes aplicativos não estavam presentes em seu locatário:...: o Azure Link do Synapse não pode obter todas as permissões de aplicativo necessárias para criar o perfil. A ID do aplicativo ausente apareceu na mensagem de erro da interface do usuário. Veja a lista completa das permissões de aplicativo necessárias:
  • Exportar para o data lake: 7f15f9d9-cad0-44f1-bbba-d36650e07765
  • Common Data Service – Azure Data Lake Storage: 546068c3-99b1-4890-8e93-c8aeadcfe56a
  • Plataforma de Aplicativos de Insights Prod: 99ff962b-6252-4b98-8478-0c65a3ea1925
Peça ao administrador para adicionar as permissões ausentes em seu locatário do Azure seguindo estas etapas:
  • Abra o PowerShell e conecte-se ao Azure com uma conta autenticada usando o comando: Connect-AzAccount
  • Adicione a entidade de segurança executando o seguinte comando para a ID do aplicativo: New-AzADServicePrincipal -ApplicationId ‘7f15f9d9-cad0-44f1-bbba-d36650e07765’