Solucionar problemas de bases de dados espelhadas em rede

Este artigo descreve os cenários, resoluções e soluções alternativas comuns para bases de dados espelhadas do Microsoft Fabric. Para cada fonte de dados, reveja também a resolução de problemas específica, as perguntas frequentes (FAQ) e as limitações.

Alterações na capacidade da malha

Os dados não parecem estar replicando

Se você observar um atraso na aparência de dados espelhados, verifique o seguinte:

• Status de espelhamento: Na página de monitorização do portal Fabric do banco de dados espelhado, verifique o status do banco de dados espelhado e de tabelas específicas e a coluna "Última conclusão" que indica a última vez que o Fabric atualiza a tabela espelhada a partir da origem. Vazio significa que a tabela ainda não está espelhada.

  Se você habilitar o monitoramento do espaço de trabalho, poderá verificar a latência de execução do espelhamento além disso, consultando o ReplicatorBatchLatency valor dos logs de operação do banco de dados espelhado.

  Para tipos de origem como o Banco de Dados SQL do Azure, a Instância Gerenciada SQL do Azure e o Banco de Dados do Azure para PostgreSQL, siga as instruções específicas para verificar também a configuração e o status do banco de dados de origem.

• Dados no OneLake: O espelhamento replica continuamente seus dados no OneLake no formato de tabela Delta Lake. Para validar se os dados chegam ao OneLake corretamente, você pode criar um atalho das tabelas espelhadas em um Lakehouse e, em seguida, criar blocos de anotações com consultas do Spark para consultar os dados. Saiba mais sobre Explorar com blocos de notas.

• Dados no ponto de extremidade de análise SQL: Você pode consultar dados espelhados por meio do ponto de extremidade de análise SQL do banco de dados espelhado ou de um Lakehouse com um atalho para os dados espelhados. Quando se deparar com um atraso, primeiro valide o estado e os dados de espelhamento no OneLake, conforme mencionado acima. Se os dados aparecerem no OneLake, mas não no ponto de extremidade da análise SQL, isso pode ser causado por um atraso na sincronização de metadados no ponto de extremidade da análise SQL.

  Você pode forçar manualmente uma atualização da verificação automática de metadados. Na página do ponto de ligação de análise SQL, selecione o botão Atualizar, conforme mostrado na imagem a seguir. Aguarde algum tempo e, em seguida, consulte os dados novamente para verificar.

  

Parar replicação

Quando você seleciona Parar replicação, os arquivos do OneLake permanecem como estão, mas a replicação incremental é interrompida. Você pode reiniciar a replicação a qualquer momento selecionando Iniciar replicação. Talvez você queira parar/iniciar a replicação ao redefinir o estado da replicação, após as alterações no banco de dados de origem ou como uma ferramenta de solução de problemas.

Replicar a hierarquia de origem do esquema

Quando você espelha dados de vários tipos de bancos de dados de origem, sua hierarquia de esquema de origem é preservada no banco de dados espelhado. Garante-se que os seus dados permaneçam consistentemente organizados em diferentes serviços, permitindo que você os utilize utilizando a mesma lógica no endpoint de análise SQL, nos Spark Notebooks, nos modelos semânticos e em outras referências aos dados.

Para bancos de dados espelhados criados antes da habilitação desse recurso, você verá que o esquema de origem está nivelado no banco de dados espelhado e o nome do esquema é codificado no nome da tabela. Se quiser reorganizar tabelas com esquemas, recrie seu banco de dados espelhado.

Se você usar a API para criar/atualizar o banco de dados espelhado, defina o valor para a propriedade defaultSchema, que indica se a hierarquia de esquema deve ser replicada do banco de dados de origem. Consulte os exemplos de definição na API REST pública de espelhamento do Microsoft Fabric.

Suporte a mapeamento de coluna delta

O espelhamento oferece suporte à replicação de colunas contendo espaços ou caracteres especiais em nomes (como ,;{}()\n\t=) dos bancos de dados de origem para os bancos de dados espelhados. Nos bastidores, o espelhamento grava dados no OneLake com o mapeamento de coluna Delta habilitado.

Para tabelas que já estão em replicação antes de esse recurso ser habilitado, para incluir colunas com caracteres especiais em nomes, você precisa atualizar as configurações do banco de dados espelhado removendo e readicionando essas tabelas ou parar e reiniciar o banco de dados espelhado.

Apropriar-se de um banco de dados espelhado

Atualmente, o banco de dados espelhado não oferece suporte à alteração de propriedade. Se um banco de dados espelhado parar de funcionar porque o proprietário do item deixou a organização ou não é mais válido, você precisará recriar o banco de dados espelhado.

Regiões suportadas

O espelhamento de banco de dados e o espelhamento aberto estão disponíveis em todas as regiões do Microsoft Fabric. Para obter mais informações, consulte Disponibilidade da região Fabric.

Troubleshoot

Esta seção contém etapas gerais de solução de problemas de espelhamento.

Não consigo me conectar a um banco de dados de origem

1. Verifique se os detalhes da conexão estão corretos, o nome do servidor, o nome do banco de dados, o nome de usuário e a senha.
2. Verifique se o servidor não está protegido por um firewall ou rede virtual privada. Abra as portas de firewall apropriadas.
   • Algumas fontes espelhadas oferecem suporte a gateway de dados de rede virtual ou gateways de dados locais, consulte a documentação da fonte para obter suporte a esse recurso.

Nenhuma exibição é replicada

Atualmente, as funções de visualização não são suportadas. Apenas a replicação de tabelas regulares é suportada.

Nenhuma tabela está sendo replicada

1. Verifique o estado do monitoramento para analisar a situação das tabelas. Para obter mais informações, consulte Replicação de banco de dados espelhado do Monitor Fabric.
2. Selecione o botão Configurar replicação . Verifique se as tabelas estão presentes na lista de tabelas ou se há alertas em cada detalhe da tabela.

Colunas estão faltando na tabela de destino

1. Selecione o botão Configurar replicação .
2. Selecione o ícone Alerta ao lado dos detalhes da tabela se alguma coluna não estiver sendo replicada.

Alguns dos dados na minha coluna parecem estar truncados

O endpoint de análise SQL suporta varchar(max) até 16 MB.

• O limite de 16 MB aplica-se a tabelas criadas após 18 de novembro de 2025 em bases de dados espelhadas, mas cada tipo de item espelhado pode ter um limite diferente e inferior. Por exemplo, o SQL Server espelhado suporta até 1 MB e o Cosmos DB suporta até 2 MB. Veja a tabela a seguir.
• As tabelas existentes criadas antes de 18 de novembro de 2025 suportam apenas varchar(8000) e precisam de ser recriadas para adotar novos tipos de dados e suportar dados superiores a 8 KB.

A tabela/esquema espelhado não é eliminada quando é colocada na base de dados de origem

Nível da tabela:

• Quando escolhe espelhar uma lista de tabelas seletivas e a tabela de origem é eliminada, a tabela espelhada mantém-se e vê o erro "A tabela de origem não existe" na monitorização. Se já não quiser replicar esta tabela, atualizar a configuração da base de dados espelhada e removê-la, então a tabela espelhada será eliminada.
• Quando escolhe espelhar todos os dados e a tabela de origem é eliminada, a tabela espelhada também é eliminada.

Nível de esquema: Quando o esquema é descartado na base de dados de origem, ainda vê o esquema no SQL Analytics Endpoint como um esquema vazio.

Não consigo alterar o banco de dados de origem

Não há suporte para alterar o banco de dados de origem. Crie um novo banco de dados espelhado.

Limita mensagens de erro

Estas mensagens de erro comuns têm explicações e atenuações:

Conteúdo relacionado

• O que é espelhamento em malha?
• Replicação espelhada do banco de dados do Monitor Fabric