Solucionar problemas de bancos de dados espelhados do Fabric

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

Alterações na capacidade do Fabric

Os dados não parecem estar replicando

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

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

  Se você habilitar o monitoramento do workspace, poderá verificar a latência de execução de 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 de SQL do Azure e o Banco de Dados do Azure para PostgreSQL, siga as instruções específicas para também verificar 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 Spark para consultar os dados. Saiba mais sobre Explorar com blocos de anotações.

• Dados no ponto de extremidade de análise do 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 você vir um atraso, valide o status de espelhamento e os dados no OneLake, conforme mencionado acima primeiro. Se os dados aparecerem no OneLake, mas não no ponto de extremidade de análise do SQL, eles poderão ser causados por um atraso na sincronização de metadados no ponto de extremidade de análise do SQL.

  Você pode forçar manualmente uma atualização da verificação automática de metadados. Na página do ponto de extremidade de análise do 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 fazer a replicação stop/start ao redefinir o estado da replicação, após alterações no banco de dados de origem ou como uma ferramenta de solução de problemas.

Replicar hierarquia de esquema de origem

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. Ele garante que seus dados permaneçam consistentemente organizados em diferentes serviços, permitindo que você os consuma usando a mesma lógica no ponto de extremidade de análise do SQL, notebooks Spark, modelos semânticos e outras referências aos dados.

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

Se você usar a API para criar/atualizar o banco de dados espelhado, defina o valor da 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 ao mapeamento de coluna delta

O espelhamento dá suporte à replicação de colunas que contêm espaços ou caracteres especiais em nomes (como ,;{}()\n\t=) de seus bancos de dados de origem para os bancos de dados espelhados. Por trás da cena, o espelhamento grava dados no OneLake com o mapeamento de coluna Delta habilitado.

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

Assumir a propriedade de um banco de dados espelhado

Atualmente, o banco de dados espelhado não dá 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 ela não for mais válida, você precisará recriar o banco de dados espelhado.

Regiões com suporte

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, confira Disponibilidade do Fabric por região.

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, nome do servidor, nome de banco de dados, nome de usuário e senha.
2. Verifique se o servidor não está atrás de um firewall ou rede virtual privada. Abra as portas de firewall apropriadas.
   • Algumas fontes espelhadas dão suporte a gateways de dados de rede virtual ou gateways de dados locais, consulte a documentação da origem para obter suporte a esse recurso.

Nenhuma exibição é replicada

Atualmente, não há suporte para exibições. Há suporte apenas para a replicação de tabelas regulares.

Nenhuma tabela está sendo replicada

1. Verifique o status de monitoramento para verificar o status das tabelas. Para obter mais informações, consulte a 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 de tabela.

As colunas estão ausentes da tabela de destino

1. Selecione o botão Configurar replicação .
2. Selecione o ícone alerta ao lado dos detalhes da tabela se as colunas não estiverem sendo replicadas.

Alguns dos dados na minha coluna parecem estar truncados

O endpoint de análise do SQL dá suporte a varchar(max) até 16 MB.

• O limite de 16 MB se aplica a tabelas criadas após 18 de novembro de 2025 em bancos de dados espelhados, mas cada tipo de item espelhado pode ter um limite diferente e inferior. Por exemplo, o SQL Server espelhado dá suporte a até 1 MB e o Cosmos DB dá suporte a até 2 MB. Consulte a tabela a seguir.
• As tabelas existentes criadas antes de 18 de novembro de 2025 só dão suporte a varchar(8000) e precisam ser recriadas para adotar novos tipos de dados e dar suporte a dados maiores que 8 KB.

Tabela/esquema espelhado não é excluído quando é descartado no banco de dados de origem

Nível da tabela:

• Quando você opta por espelhar uma lista de tabelas seletivas e a tabela de origem é descartada, a tabela espelhada permanece e você vê o erro "A tabela de origem não existe" no monitoramento. Se você não quiser mais replicar essa tabela, atualize a configuração do banco de dados espelhado e remova-a, a tabela espelhada será excluída.
• Quando você opta por espelhar todos os dados e a tabela de origem é descartada, a tabela espelhada também é excluída.

Nível de esquema: quando o esquema é removido no banco de dados de origem, você ainda vê o esquema no Endpoint de Análise de SQL 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

Essas mensagens de erro comuns têm explicações e mitigações:

Conteúdo relacionado

• O que é Espelhamento no Tecido?
• Monitorar a replicação de banco de dados espelhado do Fabric