Compartilhar via


Microsoft Entra Connect: como se recuperar de um limite de 10 GB do LocalDB

O Microsoft Entra Connect requer um banco de dados do SQL Server para armazenar dados de identidade. Você pode usar o padrão do SQL Server 2019 Express LocalDB instalado com o Microsoft Entra Connect ou usar o seu SQL completo. O SQL Server Express impõe um limite de tamanho de 10 GB. Ao usar o LocalDB e esse limite for atingido, o Serviço de Sincronização do Microsoft Entra Connect não pode iniciar ou sincronizar corretamente. Este artigo fornece as etapas de recuperação.

Sintomas

Há dois sintomas comuns:

  • O Serviço de Sincronização do Microsoft Entra Connect está em execução, mas não consegue sincronizar com o erro "stopped-database-disk-full".

  • Não foi possível iniciar o Serviço de Sincronização do Microsoft Entra Connect. Quando você tentar iniciar o serviço, ele falha com o evento 6323 e mensagem de erro "o servidor encontrou um erro porque o SQL Server está sem espaço em disco“.

Etapas de recuperação de curto prazo

Esta seção fornece as etapas para recuperar o espaço de banco de dados necessário para que o serviço de sincronização do Microsoft Entra Connect possa retomar as operações. As etapas incluem:

  1. Determinar o status do serviço de sincronização
  2. Reduzir o banco de dados
  3. Excluir dados de histórico de execução
  4. Reduzir o período de retenção de dados de histórico de execução

Determinar o status do serviço de sincronização

Primeiro, determine se o serviço de sincronização ainda está executando ou não:

  1. Faça logon no seu servidor do Microsoft Entra Connect como administrador.

  2. Vá para Service Control Manager.

  3. Verifique o status da Sincronização do Microsoft Entra ID.

  4. Se estiver em execução, não pare nem reinicie o serviço. Ignorar a etapa Reduzir o banco de dados e acesse a etapa Excluir dados do histórico de execução.

  5. Se não estiver em execução, tente iniciar o serviço. Se o serviço foi iniciado com êxito, ignore a etapa reduzir o banco de dados e vá para a etapa excluir dados do histórico de execução. Caso contrário, prossiga com a etapa Reduzir o banco de dados.

Reduzir o banco de dados

Use a operação de redução para liberar espaço de banco de dados para iniciar o serviço de sincronização. Ele libera espaço de banco de dados, removendo os espaços em branco no banco de dados. Esta etapa é um esforço máximo, pois não há garantia de que você sempre consiga recuperar espaço. Para saber mais sobre a operação de redução, leia este artigo reduzir um banco de dados.

Importante

Ignore esta etapa se você pode obter o serviço de sincronização para execução. Não é recomendável reduzir o banco de dados SQL, pois pode levar a um mau desempenho devido à maior fragmentação.

O nome do banco de dados criado para o Microsoft Entra Connect é ADSync. Para executar uma operação de redução, você deve fazer login como administrador de sistema ou DBO do banco de dados. Durante a instalação do Microsoft Entra Connect, as contas a seguir são concedidas direitos de sysadmin:

  • Administradores Locais
  • A conta de usuário que foi usada para executar a instalação do Microsoft Entra Connect.
  • A conta do Serviço de Sincronização que é usada como o contexto operacional do Serviço de Sincronização do Microsoft Entra Connect.
  • O grupo local ADSyncAdmins criado durante a instalação.
  1. Faça o backup do banco de dados copiando os arquivos ADSync.mdf e ADSync_log.ldf localizados em %ProgramFiles%\Microsoft Azure AD Sync\Data para um local seguro.

  2. Inicie uma nova sessão do PowerShell.

  3. Navegue até a pasta %ProgramFiles%\Microsoft SQL Server\110\Tools\Binn.

  4. Iniciar sqlcmd utilitário executando o comando ./SQLCMD.EXE -S "(localdb)\.\ADSync" -U <Username> -P <Password>, usando a credencial de um administrador do sistema ou o DBO do banco de dados.

  5. Para reduzir o banco de dados, no prompt do sqlcmd (1>), digite DBCC Shrinkdatabase(ADSync,1);, seguido por GO na próxima linha.

  6. Se a operação for bem-sucedida, tente iniciar o serviço de sincronização novamente. Se você puder iniciar o serviço de sincronização, vá para a etapa excluir dados do histórico de execução. Caso contrário, contate o Suporte.

Excluir dados de histórico de execução

Por padrão, o Microsoft Entra Connect retém até sete dias de dados de histórico de execução. Nesta etapa, podemos excluir os dados do histórico de execuções para recuperar espaço de banco de dados para que o Serviço de Sincronização do Microsoft Entra Connect possa começar a sincronizar novamente.

  1. Inicie o Gerenciador de Serviço de Sincronização indo para INICIAR → Serviço de Sincronização.

  2. Vá para a guia Operações.

  3. Em Ações, selecione Limpar execuções....

  4. Você pode escolher a opção Limpar todas as execuções ou Limpar execuções antes de... <data>. É recomendável que você comece limpando os dados de histórico de execução que são mais antigos que dois dias. Se você continuar a executar o problema de tamanho do banco de dados, escolha a opção Limpar todas as execuções.

Reduzir o período de retenção de dados de histórico de execução

Essa etapa é para reduzir a probabilidade de executar o problema de limite de 10 GB após vários ciclos de sincronização.

  1. Abra uma nova sessão do PowerShell.

  2. Execute Get-ADSyncScheduler e anote a propriedade PurgeRunHistoryInterval, que especifica o período de retenção atual.

  3. Execute Set-ADSyncScheduler -PurgeRunHistoryInterval 2.00:00:00 para definir o período de retenção como dois dias. Ajuste o período de retenção, como apropriado.

Solução de longo prazo – migrar para o SQL completo

Em geral, o problema é indicativo de que o tamanho do banco de dados de 10 GB não é mais suficiente para o Microsoft Entra Connect sincronizar seu Active Directory local ao Microsoft Entra ID. É recomendável que você troque pelo uso da versão completa do SQL Server. Você não pode substituir o LocalDB de uma implantação existente do Microsoft Entra Connect diretamente com o banco de dados da versão completa do SQL. Em vez disso, você deve implantar um novo servidor do Microsoft Entra Connect com a versão completa do SQL. É recomendável que você faça uma migração swing, onde o novo servidor do Microsoft Entra Connect (com o banco de dados SQL) é implantado como um servidor de preparo, ao lado do servidor do Microsoft Entra Connect existente (com o LocalDB).

Próximas etapas

Saiba mais sobre Integrar suas identidades locais com o Microsoft Entra ID.