Solucionar problemas com a Sincronização de Dados SQL do Azure

Aplica-se a: Banco de Dados SQL do Azure

Importante

A Sincronização de Dados SQL será desativada em 30 de setembro de 2027. Considere migrar para soluções alternativas de replicação/sincronização de dados.

Esse artigo descreve como solucionar problemas conhecidos com a Sincronização de Dados SQL no Azure. Caso haja uma resolução para um problema, ela será fornecida aqui.

Para obter uma visão geral da Sincronização de Dados SQL, consulte O que é Sincronização de Dados SQL para Azure?

A Sincronização de Dados SQL não oferece suporte à Instância Gerenciada de SQL do Azure nem ao Azure Synapse Analytics.

Problemas de sincronização

Falha de sincronização na interface do usuário do portal em bancos de dados locais associados ao agente cliente

A sincronização falha na interface do usuário do portal da Sincronização de Dados SQL para bancos de dados locais associados ao agente cliente. No computador local que executa o agente, são exibidos erros System.IO.IOException no log de eventos. Os erros informam que o disco não tem espaço suficiente.

  • Causa. A unidade não tem espaço suficiente.

  • Resolução. Crie mais espaço na unidade na qual o diretório %TEMP% está localizado.

Meu grupo de sincronização está paralisado no estado de processamento

Um grupo de sincronização na Sincronização de Dados SQL esteve no estado de processamento por muito tempo. Ele não responde ao comando de parada e os logs não mostram novas entradas.

Qualquer uma das condições a seguir pode fazer com que um grupo de sincronização trave no estado de processamento:

  • Causa. O agente cliente está offline

  • Resolução. Verifique se o agente cliente está online e tente novamente.

  • Causa. O agente cliente está desinstalado ou ausente.

  • Resolução. Se o agente cliente estiver desinstalado ou de outra maneira ausente:

    1. Remova o arquivo XML do agente da pasta de instalação da Sincronização de Dados SQL caso o arquivo exista.
    2. Instale o agente em um computador local (pode ser o mesmo ou em outro computador). Em seguida, envie a chave do agente que é gerada no portal para o agente que é mostrado como offline.
  • Causa. O serviço Sincronização de Dados SQL está interrompido.

  • Resolução. Reinicie o serviço de Sincronização de Dados SQL.

    1. No menu Iniciar, pesquise por Serviços.
    2. Nos resultados da pesquisa, selecione Serviços.
    3. Localize o serviço de Sincronização de Dados SQL.
    4. Se o status do serviço for Parado, clique com o botão direito do mouse no nome do serviço e selecione Iniciar.

Observação

Se as informações anteriores não retirarem seu grupo de sincronização do estado de processamento, o Suporte da Microsoft poderá redefinir o status de seu grupo de sincronização. Para que o status do grupo de sincronização seja redefinido, na Página de perguntas de P e R da Microsoft para o Banco de Dados SQL do Azure, crie uma postagem. Na postagem, inclua sua ID de assinatura e a ID do grupo de sincronização para o grupo que precisa ser redefinido. Um engenheiro do Suporte da Microsoft responderá à sua postagem e o informará quando o status tiver sido redefinido.

Há dados incorretos em minhas tabelas

Se as tabelas com o mesmo nome, mas de esquemas de banco de dados diferente forem incluídas em uma sincronização, haverá dados incorretos nas tabelas após a sincronização.

  • Causa. O processo de provisionamento da Sincronização de Dados SQL usa as mesmas tabelas de acompanhamento para tabelas com o mesmo nome, mas que estão em esquemas diferentes. Por isso, as alterações de ambas as tabelas são refletidas na mesma tabela de rastreamento. Isso causa alterações de dados incorretas durante a sincronização.

  • Resolução. Garanta que os nomes das tabelas envolvidas na sincronização sejam diferentes, mesmo que pertençam a esquemas diferentes em um banco de dados.

Há dados de chave primária inconsistentes após uma sincronização com êxito

Uma sincronização é relatada como bem-sucedida e o log não mostra nenhuma linha com falha ou ignorada, mas você observa que os dados da chave primária são inconsistentes entre os bancos de dados no grupo de sincronização.

  • Causa. Esse resultado ocorre por design. As alterações em qualquer coluna de chave primária resultam em dados inconsistentes nas linhas nas quais a chave primária foi alterada.

  • Resolução. Para evitar esse problema, garanta que nenhum dado em uma coluna de chave primária é alterado. Para corrigir esse problema depois que ele tiver ocorrido, exclua a linha que contém dados inconsistentes de todos os pontos de extremidade no grupo de sincronização. Em seguida, reinsira a linha.

Há uma degradação significativa no desempenho

O desempenho é degradado de forma significativa, possivelmente até o ponto em que você não pode nem mesmo abrir a interface do usuário da Sincronização de Dados.

  • Causa. A causa mais provável é um loop de sincronização. Um loop de sincronização ocorre quando uma sincronização por grupo de sincronização A aciona uma sincronização por grupo de sincronização B, que dispara uma sincronização por grupo de sincronização A. A situação real pode ser mais complexa e pode envolver mais de dois grupos de sincronização no loop. O problema é que há um acionamento circular de sincronização que é causado por grupos de sincronização sobrepostos entre si.

  • Resolução. A melhor correção é a prevenção. Verifique se você não tem referências circulares nos grupos de sincronização. Nenhuma linha sincronizada por um grupo de sincronização pode ser sincronizada por outro grupo de sincronização.

Recebi essa mensagem que diz “Não é possível inserir o valor NULL na coluna <coluna>. A coluna não permite nulos." O que isso significa, e como posso corrigir?

Essa mensagem de erro indica que um dos dois problemas a seguir ocorreu:

  • Uma tabela não tem uma chave primária. Para corrigir esse problema, adicione uma chave primária a todas as tabelas que você está sincronizando.
  • Há uma cláusula WHERE na instrução CREATE INDEX. A Sincronização de Dados não lidar com essa condição. Para corrigir esse problema, remova a cláusula WHERE ou realize as alterações manualmente para todos os bancos de dados.

Como a Sincronização de Dados trata referências circulares? Ou seja, quando os mesmos dados são sincronizados em vários grupos de sincronização, fazendo com que sejam continuamente alterados?

A Sincronização de Dados não trata referências circulares. Evite usá-las.

Problemas de agente cliente

Para solucionar problemas com o agente cliente, veja Solucionar problemas do Agente de Sincronização de Dados.

Problemas de instalação e manutenção

Recebi uma mensagem que indica “Disco sem espaço”

  • Causa. A mensagem "disco sem espaço" poderá aparecer se arquivos restantes precisarem ser excluídos. Isso pode ser causado pelo software antivírus ou porque arquivos estavam abertos quando de operações de exclusão estavam sendo realizadas.

  • Resolução. Exclua manualmente os arquivos de sincronização que estão na pasta %temp% (del \*sync\* /s). Em seguida, exclua os subdiretórios na pasta %temp%.

Importante

Não exclua nenhum arquivo enquanto a sincronização estiver em andamento.

Não consigo excluir meu grupo de sincronização

Falha ao tentar excluir um grupo de sincronização. Qualquer um dos cenários a seguir pode resultar em uma falha ao excluir um grupo de sincronização:

  • Causa. O agente cliente está offline.

  • Resolução. Verifique se o agente cliente está online e tente novamente.

  • Causa. O agente cliente está desinstalado ou ausente.

  • Resolução. Se o agente cliente estiver desinstalado ou de outra maneira ausente:
    a. Remova o arquivo XML do agente da pasta de instalação da Sincronização de Dados SQL caso o arquivo exista.
    b. Instale o agente em um computador local (pode ser o mesmo ou em outro computador). Em seguida, envie a chave do agente que é gerada no portal para o agente que é mostrado como offline.

  • Causa. Um banco de dados está offline.

  • Resolução. Verifique se os bancos de dados estão todos online.

  • Causa. O grupo de sincronização está sendo provisionado ou sincronizado.

  • Resolução. Aguarde até que o processo de provisionamento ou sincronização seja concluído e tente excluir o grupo de sincronização novamente.

Não consigo cancelar o registro de um banco de dados do SQL Server

  • Causa. Muito provavelmente, você está tentando cancelar o registro de um banco de dados que já foi excluído.

  • Resolução. Para cancelar o registro de um banco de dados do SQL Server, selecione o banco de dados e selecione Forçar Exclusão.

    Se essa operação não conseguir remover o banco de dados do grupo de sincronização:

    1. Pare e, em seguida, reinicie o serviço de host do agente cliente:
      a. Selecione o menu Iniciar.
      b. Insira services.msc na caixa de pesquisa.
      c. Na seção Programas do painel de resultados da pesquisa, clique duas vezes em Serviços.
      d. Clique com o botão direito do mouse no serviço Sincronização de Dados SQL.
      e. Se o serviço estiver em execução, interrompa-o.
      f. Clique com o botão direito do mouse no serviço e, em seguida, selecione Iniciar.
      g. Verifique se o banco de dados ainda está registrado. Se ele não estiver mais registrado, você terminou. Caso contrário, continue com a próxima etapa.
    2. Abra o aplicativo do agente cliente (SqlAzureDataSyncAgent).
    3. Selecione Editar Credenciais e, em seguida, insira as credenciais para o banco de dados.
    4. Continue com o cancelamento do registro.

Não tenho privilégios suficientes para iniciar serviços do sistema

  • Causa. Esse erro ocorre em duas situações:

    • O nome de usuário e/ou a senha estão incorretos.
    • A conta de usuário especificada não tem privilégios suficientes para fazer logon como serviço.
  • Resolução. Conceda credenciais de logon como serviço à conta de usuário:

    1. Vá para iniciar>Painel de Controle>Ferramentas Administrativas>Política de Segurança Local>Diretiva Local>Gerenciamento de Direitos do Usuário.
    2. Selecione Fazer logon como um serviço.
    3. Na caixa de diálogo Propriedades, adicione a conta de usuário.
    4. Selecione Aplicar e, depois, OK.
    5. Feche todas as janelas.

Um banco de dados tem o status “Desatualizado”

  • Causa. A Sincronização de Dados SQL remove banco de dados que ficaram offline do serviço por 45 dias ou mais (contado a partir da hora em que o banco de dados ficou offline). Se um banco de dados estiver offline por 45 dias ou mais e, em seguida, voltar a ficar online, seu status será definido como Desatualizado.

  • Resolução. Evite obter o status Desatualizado garantindo que nenhum dos bancos de dados fique offline por 45 dias ou mais.

    Se o status de um banco de dados for Desatualizado:

    1. Remova o banco de dados que tem um status de Desatualizadas do grupo de sincronização.
    2. Adicione o banco de dados de volta ao grupo de sincronização.

    Aviso

    Você perderá todas as alterações feitas nesse banco de dados enquanto ele estava offline.

Um grupo de sincronização tem o status “Desatualizado”

  • Causa. Se uma ou mais alterações não puderem ser aplicadas ao período de retenção inteiro de 45 dias, um grupo de sincronização poderá ficar desatualizado.

  • Resolução. Para evitar obter um status Desatualizado, examine os resultados dos trabalhos de sincronização no visualizador de histórico regularmente. Investigue e resolva todas as alterações que não puderem ser aplicadas.

    Se o status de um grupo de sincronização for Desatualizado, exclua o grupo de sincronização e recrie-o.

Um grupo de sincronização não pode ser excluído em até três minutos após a desinstalação ou interrupção do agente

Não é possível excluir um grupo de sincronização em até três minutos após a desinstalação ou interrupção do agente cliente da Sincronização de Dados SQL associado.

  • Resolução.

    1. Remova um grupo de sincronização enquanto os agentes de sincronização associados estiverem online (recomendado).
    2. Se o agente estiver offline, mas estiver instalado, coloque-o online no computador local. Aguarde até que o status do agente seja exibido como Online no portal da Sincronização de Dados SQL. Em seguida, remova o grupo de sincronização.
    3. Se o agente estiver offline porque foi desinstalado:
      a. Remova o arquivo XML do agente da pasta de instalação da Sincronização de Dados SQL caso o arquivo exista.
      b. Instale o agente em um computador local (pode ser o mesmo ou em outro computador). Em seguida, envie a chave do agente que é gerada no portal para o agente que é mostrado como offline.
      c. Tente excluir o grupo de sincronização.

O que acontece quando eu restaurar um banco de dados perdido ou corrompido?

Se você restaurar um banco de dados perdido ou corrompido de um backup, poderá haver uma não convergência de dados nos grupos de sincronização aos quais o banco de dados pertence.

Mensagem de erro "Sync0022 O cliente não tem autorização para executar a ação 'syncGroupOperationResults/read'"

Se você receber a mensagem de erro Sync0022 Customer does not have authorization to perform action 'syncGroupOperationResults/read', a conta que está tentando a operação não terá permissões suficientes no nível da assinatura. Adicionar:

  • "Microsoft.Sql/locations/syncMemberOperationResults/read"
  • "Microsoft.Sql/locations/syncAgentOperationResults/read"
  • "Microsoft.Sql/locations/syncGroupOperationResults/read"

Para obter mais informações, confira Operações do provedor de recursos RBAC e Contas de banco de dados da Sincronização de Dados SQL com privilégios menos necessários.