Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

mongosync Binário

O binário mongosync é o processo primário usado no Mongosync. mongosync migra dados de um cluster de origem para um cluster de destino até que você finalize a sincronização.

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 Perguntas Frequentes (FAQ) aborda as perguntas que os usuários fizeram sobre mongosync.

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

    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 independentes não são suportadas. Converta a instância autônomo para um conjunto de réplica antes de usar Mongosync.

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

  • Para obter uma lista completa de limitações, consulte Limitações do Mongosync.

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 usando 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>

Sets the connection URI for the first cluster. The first cluster can serve as either the source or the destination in the sync process. Designate the source and destination clusters in the call to the start API endpoint.

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 usar a opção para especificar um arquivo de configuração contendo a --config 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 destino na chamada para o start ponto de extremidade da API.

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 usar a opção para especificar um arquivo de configuração contendo a --config 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, veja Reconfigurar mongosync Durante a Sincronização.

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 desativar a coleção 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, o mongosync 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 no arquivo de configuração, consulte a configuração disableVerification.

Novidades 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 shard, use o listShards comando.

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

Novidades na versão 1.4.

--logPath <directory>

Define o caminho para o diretório de logs. O Mongosync grava registros 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 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 do Mongosync.

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

Para mudar a porta durante uma migração, veja Reconfigurar mongosync Durante a Sincronização.

--verbosity <level>

Padrão: DEBUG

Define o nível de verbosidade a ser usado em mensagens de registro. O Mongosync registra todas as mensagens no nível especificado e quaisquer 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 detalhamento durante uma migração, veja Reconfigurar mongosync Durante a Sincronização.

--version, -v

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

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