Menu Docs
Página inicial do Docs
/
Sincronização de Cluster-to-Cluster do MongoDB
/

mongosync

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Opções de linha de comando
  • Opções globais
  • Comportamento
  • Saiba mais

O mongosync binário é o processo primário usado no Cluster-to-Cluster Sync. mongosync migra dados de um cluster de origem para um cluster de destino e mantém os clusters em sincronização contínua até que você finalize a sincronização. Além da sincronização de dados contínua, omongosync também pode executar uma migração de dados única entre clusters.

Para uma visão geral do processo mongosync, consulte Sobre mongosync.

Para começar a utilizar o mongosync, consulte o Guia de Início Rápido.

A página de Perguntas Frequentes (FAQ) aborda perguntas que os usuários fizeram mongosync sobre.

  • A partir da versão,1.10 omongosync suporta migrações para clusters de destino que utilizam MongoDB.8.0 A origem deve ser um8.0 cluster pré-. Para migrar de 8.0 clusters de origem, consulte Sincronizar dados entre dois 8 0 clusters. .

  • As versões mínimas de servidor suportadas do MongoDB são 6.0.16 e 7.0.9.

    Você pode migrar dados em clusters (fonte) com versões do MongoDB anteriores a 6.0 para um cluster do Atlas (destino). A migração de clusters com versão inferior requer preparação e configuração adicionais nos clusters com a versão inferior. {Entre em contato com a equipe da sua conta para obter informações sobre o Professional Services.

  • mongosync suporta conjuntos de réplicas e clusters fragmentados.

  • Instâncias MongoDB autônomos não são suportadas. Converta a instância autônoma em um conjunto de réplicas antes de usar o Cluster-to-Cluster Sync.

  • mongosync não suporta clusters compartilhados do Atlas ou instâncias sem servidor.

  • Para obter uma lista completa de limitações, consulte Limitações de Sincronização de Cluster para Cluster.

O layout de comando mongosync abaixo é modificado para exibição. Para conectar cluster0 a cluster1 com mongosync, digite o seguinte comando em uma linha:

mongosync \
--cluster0 "<cluster0_connection_string>" \
--cluster1 "<cluster1_connection_string>"

Para obter mais informações sobre como formatar suas strings de conexão, consulte Conectar mongosync.

Você pode configurar as seguintes opções mongosync utilizando a linha de comando.

Para configurar mongosync a partir de um arquivo de configuração, consulte Arquivo de Configuração.

--acceptDisclaimer

Aceita isenções de responsabilidade para o verificador incorporado.

Quando o processo mongosync começa sem essa opção, o usuário é solicitado a aceitar cada termo de responsabilidade.

Esta opção permite que os usuários que já leram e aceitaram isenções de responsabilidade aceitem o aviso e iniciem o processo mongosync .

Para definir a opção --acceptDisclaimer a partir de um arquivo de configuração, consulte a configuração acceptDisclaimer.

Novidades na versão 1.9.

--cluster0 <uri>

Define o URI de conexão para o primeiro cluster. O primeiro cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API start.

Para obter mais informações sobre como conectar o mongosync, consulte Conexões.

Para definir a opção --cluster0 a partir de um arquivo de configuração, consulte a configuração cluster0.

Aviso

Em alguns sistemas, fornecer uma senha em uma string de conexão com as opções --cluster0 ou --cluster1 pode tornar a senha visível para programas de status do sistema, como ps, que podem ser invocados por outros usuários.

Considere utilizar a opção --config para especificar um arquivo de configuração contendo a senha.

--cluster1 <uri>

Define o URI de conexão para o segundo cluster. O segundo cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API start.

Para obter mais informações sobre como conectar o mongosync, consulte Conexões.

Para definir a opção --cluster1 a partir de um arquivo de configuração, consulte a configuração cluster1.

Aviso

Em alguns sistemas, fornecer uma senha em uma string de conexão com as opções --cluster0 ou --cluster1 pode tornar a senha visível para programas de status do sistema, como ps, que podem ser invocados por outros usuários.

Considere utilizar a opção --config para especificar um arquivo de configuração contendo a senha.

--config <filename>

Define o caminho para o arquivo de configuração.

Para definir o caminho do arquivo de configuração durante uma migração, consulte Reconfigurar o durante a sincronização.mongosync

Para obter mais informações, consulte Arquivo de configuração.

--disableTelemetry

Novidades na versão 1,4,0.

Desabilita a collection de dados de telemetria para mongosync.

Por padrão, o mongosync coleta dados de uso agregados e anônimos para melhorar os produtos MongoDB. Ao executar mongosync, você pode desabilitar a coleta desses dados de telemetria.

Para definir a opção --disableTelemetry a partir de um arquivo de configuração, consulte a configuração disableTelemetry.

Para desabilitar a coleta de dados de telemetria durante uma migração, consulte Reconfigurar mongosync durante a sincronização.

Para mais informações, consulte Coleta de Dados do Usuário.

--disableVerification

Desabilita o Verificador incorporado. Quando desabilitado, omongosync não verifica a migração. Para métodos de verificação alternativos, consulte Verificar transferência de dados.

Essa opção fornece uma solução alternativa para clientes que sofrem OOM kills ao executar mongosync com verificação e não podem alocar mais recursos ou tolerar reiniciar a verificação. Ele permite que a migração seja concluída com a verificação desativada. A verificação permanece desativada para reinicializações e reversões subsequentes.

Esta opção não deve ser utilizada quando mongosync for iniciado inicialmente. Em vez disso, desabilite a verificação com o parâmetro de solicitação /start, verification.enabled: false pois a verificação está ativada por padrão.

Para desabilitar a verificação do arquivo de configuração, consulte a configuração disableVerification do.

Novidade na versão 1.10.

--help, -h

Imprime informações de uso em stdout.

--id <id>

Define um identificador para a instância mongosync.

Use esta opção ao executar múltiplas instâncias de mongosync em um cluster fragmentado, para sincronizar os fragmentos individualmente.

O valor do identificador para esta opção deve corresponder ao ID de fragmento do fragmento que ele sincroniza. Para localizar o ID de fragmento, utilize o comando listShards.

Para definir a opção --id a partir de um arquivo de configuração, consulte a configuração id.

--loadLevel <level>

Tipo: inteiro

Padrão: 3

Define o nível de volume de trabalho do cluster para sincronizar dados entre os clusters de origem e destino:

  • 4, a configuração mais alta, maximiza a carga de trabalho do cluster e sincroniza os dados mais rapidamente.

  • 1, a configuração mais baixa, minimiza o volume de trabalho do cluster e sincroniza os dados de forma mais lenta.

Para definir a opção --loadLevel a partir de um arquivo de configuração, consulte a configuração loadLevel.

Para alterar o nível de carga durante uma migração, consulte Reconfigurar o mongosync durante a sincronização.

Aviso

Configurar loadLevel maior que o padrão de 3 pode afetar negativamente o desempenho do cluster de destino.

Se houver gargalos de leitura no cluster de origem ou se houver gargalos de gravação no cluster de destino, diminuir loadLevel poderá melhorar o desempenho.

Novidade na versão 1.4.

--logPath <directory>

Define o caminho para o diretório de logs. A sincronização de cluster para cluster grava logs em arquivos neste diretório.

Para obter mais informações, consulte Registro de log.

Para definir a opção --logPath a partir de um arquivo de configuração, consulte a configuração logPath.

Para alterar o caminho para o diretório de registros durante uma migração, consulte Reconfigurar o mongosync durante a sincronização.

Observação

Se você iniciar o mongosync com a opção --logPath , você poderá enviar um sinal do USR1 para o processo do mongosync para girar seu arquivo de log:

kill -s USR1 $mongosync_pid

$mongosync_pid é o ID do processo mongosync .

--port

Padrão: 27182

Define a porta usada pelo servidor HTTP para a API HTTP de Cluster-to-Cluster Sync.

Para definir a opção --port a partir de um arquivo de configuração, consulte a configuração port.

Para alterar a porta durante uma migração, consulte Reconfigurar o mongosync durante a sincronização.

--verbosity <level>

Padrão: DEBUG

Define o nível de verbosidade a ser usado em mensagens de registro. A sincronização de cluster para cluster registra todas as mensagens no nível especificado e todas as mensagens em níveis inferiores.

A opção --verbosity suporta os seguintes valores:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

Para definir a opção --verbosity a partir de um arquivo de configuração, consulte a configuração verbosity.

Para alterar o nível de verbosidade durante uma migração, consulte Reconfigurar o mongosync durante a sincronização.

--version, -v

Imprime informações da versão mongosync em stdout.

Para obter mais informações, consulte mongosync Comportamento.

Voltar

Referência