Compartilhar via


Solucionar problemas de bancos de dados espelhados do Fabric

Cenários, resoluções e soluções alternativas para bancos de dados espelhados do Microsoft Fabric.

Recursos

Revise a seção de solução de problemas das perguntas frequentes para cada fonte de dados:

Revise a documentação de limitações para cada fonte de dados:

Parar replicação

Quando você seleciona Parar duplicação, os arquivos do OneLake permanecem como estão, mas a duplicação incremental é interrompida. É possível reiniciar a duplicação a qualquer momento selecionando Iniciar duplicação. Você pode desejar parar ou reiniciar a duplicação ao restaurar o estado da duplicaçã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 utilize usando a mesma lógica no ponto de extremidade de análise SQL, notebooks Spark, modelos semânticos e outras referências ao dado.

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 em 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. 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 desse recurso habilitado, para incluir colunas com caractere especial em nomes, você precisa atualizar as configurações do banco de dados espelhado removendo e adicionando novamente 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.

Solucionar problemas

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

Não é possível se conectar com um banco de dados de origem

  1. Verifique se os detalhes da conexão estão corretos, nome do servidor, nome do banco de dados, nome de usuário e senha.
  2. Verifique se o servidor não está atrás de um firewall ou de uma rede virtual privada. Abra as portas de firewall apropriadas.

Nenhum modo de exibição é duplicado

Atualmente, não há suporte para visualizações. Apenas a duplicação de tabelas regulares tem suporte.

Nenhuma tabela está sendo duplicada

  1. Verifique o status do monitoramento para verificar o status das tabelas. Para obter mais informações, consulte Monitorar a replicação de banco de dados espelho do Fabric.
  2. Selecione o botão Configurar duplicação. Verifique se as tabelas estão presentes na lista de tabelas ou se há Alertas em cada detalhe da tabela.

Colunas estão ausentes da tabela de destino

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

Alguns dos dados na minha coluna parecem estar truncados

O warehouse do Fabric não oferece suporte para VARCHAR(max). No momento, ele é compatível somente com VARCHAR(8000).

Os dados não parecem estar duplicando

Na página Monitoramento, a data exibida é a última vez que os dados foram duplicados com êxito.

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 espelho.

Mensagens de erro relacionadas a limites

Estas mensagens de erro frequentes incluem explicações e mitigações:

Mensagem de erro Razão Atenuação
“A duplicação está sofrendo limitação devido ao limite de espaço no destino.” Existe um limite máximo de 10 TB de espaço de armazenamento no destino por banco de dados espelhado. A duplicação está sofrendo limitação devido ao limite de espaço no destino. No banco de dados de origem, descarte as tabelas, remova os dados ou faça uma fragmentação.
“A quantidade de tabelas pode exceder o limite, o que pode resultar na ausência de algumas tabelas.” Existe uma quantidade máxima de 500 tabelas. No banco de dados de origem, descarte ou filtre as tabelas. Se a nova tabela for a 500.ª tabela, não é necessário realizar nenhuma ação de mitigação.
“A duplicação está sofrendo uma limitação e espera-se que continue em AAAA-MM-DDTHH:MM:ss.” Existe um tamanho máximo de 1 TB de dados de alterações capturados por banco de dados espelhado por dia. Aguarde o término da limitação.