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

Quando abre um perfil do Azure Synapse Link, poderá ver um erro com uma mensagem e ligação para este artigo. Além disso, os utilizadores também poderão ver o estado de Erro junto de tabelas que já estão num perfil do Azure Synapse Link. Use este guia de resolução de problemas para diagnosticar e corrigir condições de erro com o Azure Synapse Link para Dataverse.

Mensagem de erro Causa Resolução
MSI-801: o Azure Synapse Link não consegue aceder à conta de armazenamento protegida através de MSI. As atualizações de dados são colocadas em pausa. Ativou a MSI (Managed Services Identify) para a conta de armazenamento selecionada para este perfil do Azure Synapse Link.
O serviço Azure Synapse Link não tem acesso à conta de armazenamento devido a problemas de configuração de MSI e o serviço foi colocado em pausa.
Voltar a consultar e verificar a configuração de MSI
Verifique se a política de MSI não foi eliminada.
Valide se a MSI recebeu os privilégios de acesso necessários.
Mais informações: Configuração de MSI
Assim que o acesso necessário for concedido, o serviço será retomado.
ADLS-802: o Azure Synapse Link não consegue aceder à conta de armazenamento. As atualizações de dados são colocadas em pausa. O serviço Azure Synapse Link não pode aceder à conta de armazenamento e o serviço foi colocado em pausa.
As permissões associadas à conta de armazenamento atribuídas ao perfil do Azure Synapse Link 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 Synapse Link 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 controlo de alterações da versão de linha desativado no ambiente associado. As atualizações de dados em algumas tabelas podem ser colocadas em pausa. O serviço Azure Synapse Link requer que ative o controlo de alterações de versões de linhas da chave de configuração no ambiente de aplicações de finanças e operações associado. Esta chave de configuração está desativada no ambiente associado e o serviço colocou em pausa as tabelas de aplicações de finanças e operações do ambiente associado.
É possível que uma operação de restauração de base de dados tenha causado a reversão da configuração.
Ative a chave de configuração e remova e leia as tabelas de aplicações de finanças e operações para retomar. As tabelas afetadas são inicializadas para refletir novos dados.
O seu administrador tem de reativar a chave de configuração de aplicações de finanças e operações.
Mais informações: Adicionar configurações num ambiente de aplicações de finanças e operações
O serviço é retomado quando a chave de configuração é reativada.
DV-804: este ambiente está no modo de administrador e o serviço está em pausa. Quando um ambiente do Power Platform está no modo de administração, todos os serviços, incluindo o serviço Azure Synapse Link, são temporariamente colocados em pausa.
Quando o Modo de administrador for Desativado, os serviços são retomados.
Verifique com o seu administrador de ambiente e certifique-se de que o ambiente está operacional.
Verifique também se a definição de ambiente Operações de fundo está Ativada depois de o Modo de administrador ser Desativado.
O serviço Azure Synapse Link é retomado quando o ambiente fica operacional.
SYN-805: o Espaço de trabalho do Synapse não está acessível. O serviço Azure Synapse Link não pode aceder ao Espaço de Trabalho do Synapse associado a este perfil.
As tabelas do Synapse podem não ser criadas imediatamente quando resolver este 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 da área de trabalho do Synapse, ative a opção Permitir que os serviços e recursos do Azure acedam a esta área de trabalho.
Outras configurações de rede também podem bloquear o acesso do serviço Azure Synapse Link ao espaço de trabalho. Verifique com o seu administrador que uma rede virtual gerida, uma regra de firewall IP ou uma restrição de acesso à rede pública não está a bloquear o acesso ao espaço de trabalho. Mais informações: Configurar regras de firewall IP e definições de conectividade do Azure Synapse Analytics
SYN-806: o contentor de armazenamento predefinido no Espaço de trabalho do Synapse não está acessível. O Espaço de trabalho do Synapse associado a este perfil do Azure Synapse Link não contém um sistema de ficheiros do Azure Data Lake Storage Gen2 primário. O contentor de armazenamento predefinido pode ser eliminado ou o contentor de armazenamento predefinido não está acessível.
Um contentor de armazenamento predefinido é usado pela área de trabalho do Synapse como armazenamento temporário na criação do sistema de ficheiros. Tem de ser fornecido um contentor de armazenamento predefinido ao criar uma área de trabalho do Synapse.
É possível que este contentor de armazenamento tenha sido eliminado ou já não esteja acessível.
Peça ao seu administrador para inicializar o Espaço de trabalho do Synapse e verifique o nome do sistema de ficheiros do Azure Data Lake Storage Gen2 primário.
Verifique também se existe um contentor de armazenamento do Azure Data Lake Storage Gen2 com esse nome na mesma subscrição.
Se o contentor de armazenamento estiver em falta, crie um contentor de armazenamento com o mesmo nome.
SYN-809: o Espaço de Trabalho do Synapse {nome} tem políticas de transferência de dados não autorizada ativadas. Precisa de escolher outra área de trabalho. Os perfis do Synapse Link com a opção de conversão Delta requerem espaços de trabalho do Synapse sem políticas de transferência de dados não autorizada. Provavelmente, escolheu um Espaço de Trabalho do Synapse com políticas de transferência de dados não autorizada, que se liga a serviços de computação do Synapse Link. Peça ao administrador para fornecer um Espaço de Trabalho do Synapse onde as políticas de transferência de dados não autorizada não estão ativadas. Também pode considerar utilizar a ligação do Fabric como uma alternativa ao Synapse Link.
SYN-810: o contentor de armazenamento predefinido associado ao Espaço de Trabalho do Synapse é restrito à rede. Os perfis do Synapse Link com a opção de conversão Delta requerem espaços de trabalho do Synapse com um contentor de armazenamento predefinido. Se o contentor de armazenamento predefinido associado à seleção do Espaço de Trabalho do Synapse tiver restrições de rede aplicadas, os serviços de computação do Synapse Link não conseguirão efetuar as atualizações necessárias. Peça ao administrador para remover as restrições de rede associadas ao contentor de armazenamento predefinido associado ao Espaço de Trabalho do Synapse escolhido ou selecione outro Espaço de Trabalho do Synapse.
SPARK-807: o conjunto de computação do Spark {nome} em {Espaço de trabalho do Synapse} já não está disponível. As atualizações de dados são colocadas em pausa. O serviço Azure Synapse Link requer um conjunto do Spark para processar dados para o formato delta. O conjunto do Spark fornecido com este perfil do Azure Synapse Link foi eliminado ou já não está disponível.
Também é possível que o acesso à área de trabalho do Synapse tenha sido restringido.
Depois de resolver o problema, o serviço Azure Synapse Link retoma as atualizações de dados quando os dados são alterados.
Verifique se o conjunto do Spark com o nome escolhido existe. Se esse conjunto do Spark foi eliminado por si ou por alguém, crie o conjunto do Spark com o mesmo nome.
SPARK-808: o conjunto de computação do Spark {nome} em {Espaço de trabalho do Synapse} é insuficiente. Uma ou mais tabelas não puderam ser atualizadas. O serviço Azure Synapse Link usa o conjunto do Spark fornecido na configuração para converter ficheiros para o formato Delta parquet à medida que os dados são atualizados.
Quando um lote grande de dados está disponível para atualização, o tamanho do conjunto do Spark fornecido no perfil do Azure Synapse Link poderá não fornecer poder de computação suficiente.
Isto pode acontecer especialmente quando adiciona tabelas grandes, uma vez que o processo de inicialização cria um lote de dados grande.
Isto também pode resultar no caso de ter subscrições "pay as you go" com capacidade limitada. Os conjuntos do Spark dentro destes tipos de subscrições têm capacidade limitada.
Aumente o número de núcleos no conjunto do Spark atribuído.
O sistema consome a capacidade aumentada em caso de cargas de trabalho maiores e reduz verticalmente conforme necessário.
Mais Informações: Tamanhos recomendados de conjuntos do Spark para conversão Delta
CT-809: propriedade de controlo de alterações da versão de linha desativada na tabela. As atualizações de dados são colocadas em pausa. O serviço Azure Synapse Link requer a ativação da propriedade de metadados Controlo de alterações de versões de linhas. Esta propriedade está desativada para a tabela e a tabela deixa de ser atualizada.
A atualização desta propriedade de metadados em finanças e operações requer a intervenção do programador. É possível que a propriedade tenha sido desativada após a criação do perfil do Azure Synapse Link.
Reative a propriedade de metadados do Controlo de alterações da versão de linha para retomar esta tabela.
Talvez precise que um administrador ou programador reative a propriedade através das ferramentas de programação. Mais informações: Ativar o controlo de alterações da versão de linha para tabelas para detalhes.
CT-810: a propriedade Permitir o controlo de alterações das versões de Linha desta tabela está definida como Não. O serviço Azure Synapse Link requer que a ativação da propriedade de metadados Permitir o controlo de alterações de versões de linhas seja definida como Sim.
A atualização desta propriedade de metadados em finanças e operações requer a intervenção do programador. É possível que a propriedade tenha sido desativada após a criação do perfil Synapse Link.
Reative a propriedade de metadados do Controlo de alterações da versão de linha para retomar esta tabela.
Talvez precise que um administrador ou programador reative a propriedade através das ferramentas de programação. Mais informações: Ativar o controlo de alterações da versão de linha para tabelas para detalhes.
FnO-810: o ambiente associado de finanças e operações não está disponível ou está em pausa. O ambiente de aplicações de finanças e operações associado a este perfil do Azure Synapse Link não está disponível ou está no modo de manutenção. O serviço Azure Synapse Link não consegue contactar o ambiente e o serviço colocou em pausa tabelas provenientes de aplicações de finanças e operações.
No caso de ambientes alojados na cloud, é possível que o ambiente esteja em estado de pausa.
Verifique com o seu administrador se o ambiente associado não está em pausa e se não está em modo de manutenção.
O serviço Azure Synapse Link é retomado quando o ambiente fica no modo operacional.
FnO-811: o ambiente de finanças e operações associado precisa de ser atualizado. O ambiente de aplicações de finanças e operações associado a este perfil do Azure Synapse Link precisa de ser atualizado para a versão mais recente.
Se estiver, atualmente, nas versões de finanças e operações PU60, PU61 ou PU62, tem de 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 obrigatórias estão incluídas na atualização cumulativa 10.0.39 (PU63)
Entre em contacto com o seu administrador de aplicações de finanças e operações e aplique as atualizações de versão mais recentes ao seu ambiente.
FnO-812: precisa de criar índices adicionais no seu ambiente de finanças e operações. Quando seleciona tabelas a partir de um ambiente de aplicações de finanças e operações, o sistema cria índices adicionais na base de dados para permitir a inicialização e atualizações de dados com bom desempenho. Este erro indica que faltam índices para tabelas. Isto pode dever-se a várias razões.

Se estiver a receber este erro de um Ambiente Alojado na Cloud (CHE), tem de ativar testes piloto específicos e índices, conforme descrito na documentação.

Se estiver a receber este erro a partir de uma sandbox ou ambiente de produção, a criação do índice poderá sofrer atrasos devido a operações pesadas da base de dados.
Se este for um ambiente CHE, contacte o proprietário do ambiente.

Se for uma sandbox ou ambiente de produção, nenhuma ação será necessária. O sistema permite índices na 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. Este erro é o resultado de um problema de dados encontrado pelo serviço durante a transferência de dados de aplicações de finanças e operações. O serviço de finanças e operações não permite valores NULOS em campos de dados. Portanto, um valor NULL é inesperado pelo serviço. Um caráter de espaço representa a ausência de um valor nas aplicações 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. Pode examinar a tabela utilizando a interface de utilizador da aplicação de finanças e operações ou utilizando uma ferramenta para resolver o problema.

O sistema é retomado assim que o problema de dados for resolvido. Não precisa de reiniciar a tabela.
As seguintes aplicações não estavam presentes no seu inquilino:...: o Azure Synapse Link não consegue obter todas as permissões de aplicação necessárias para criar o perfil. O ID da Aplicação em Falta apareceu na mensagem de erro da IU. Eis a lista completa de permissões de aplicação necessárias:
  • Exportar para data lake: 7f15f9d9-cad0-44f1-bbba-d36650e07765
  • Common Data Service - Armazenamento Azure Data Lake: 546068c3-99b1-4890-8e93-c8aeadcfe56a
  • Insights Apps Platform Prod: 99ff962b-6252-4b98-8478-0c65a3ea1925
Peça ao seu Administrador para adicionar as permissões em falta no seu inquilino do Azure seguindo estes passos:
  • Abra o PowerShell e ligue-se ao Azure com uma conta autenticada utilizando o comando: Connect-AzAccount
  • Adicione o principal executando o seguinte comando para o ID da aplicação: New-AzADServicePrincipal -ApplicationId ‘7f15f9d9-cad0-44f1-bbba-d36650e07765’