mongosync
Nesta página
mongosync
não são suportados nem testados para uso com sistemas não genuínas do MongoDB . Embora as ferramentas possam funcionar nessas implementações, a compatibilidade não é garantida.Definição
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.
Compatibilidade
A partir da versão,1.10 o
mongosync
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.
Sintaxe
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
.
Opções de linha de comando
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.
Opções globais
--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çãoacceptDisclaimer
.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çãocluster0
.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, comops
, 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çãocluster1
.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, comops
, 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 executarmongosync
, 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çãodisableTelemetry
.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, 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 do arquivo de configuração, consulte a configuração
disableVerification
do.Novidade na versão 1.10.
--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çãoid
.
--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çãoloadLevel
.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 de3
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çãologPath
.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 doUSR1
para o processo domongosync
para girar seu arquivo de log:kill -s USR1 $mongosync_pid $mongosync_pid
é o ID do processomongosync
.
--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çãoport
.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çãoverbosity
.Para alterar o nível de verbosidade durante uma migração, consulte Reconfigurar o
mongosync
durante a sincronização.
Comportamento
Para obter mais informações, consulte mongosync
Comportamento.