MongoDB.local SF, Jan 15: See the speaker lineup & ship your AI vision faster. Use WEB50 to save 50%
Find out more >
Menu Docs
Página inicial do Docs
/
MongoDB Mongosync
/
Referência
Página inicial do Docs
/
MongoDB Mongosync
/
Referência
Página inicial do Docs
/
MongoDB Mongosync
/
Referência

mongosync Binário

Definição

O binário mongosync é o processo primário usado no Cluster-to-Cluster Sync. mongosync migra dados de um cluster para outro e pode manter os clusters em sincronização contínua.

Você pode utilizar o mongosync para criar clusters de análise, desenvolvimento ou teste dedicados que espelham seu ambiente de produção. Os clusters sincronizados também podem oferecer suporte aos requisitos de localidade para conformidade de auditoria e residência de dados.

Além da sincronização de dados contínua, o mongosync também pode facilitar uma migração de dados única entre clusters.

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

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

Compatibilidade

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

    Você pode migrar dados em clusters (origem) com versões do MongoDB inferiores 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

Opções globais

--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 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 mais informações, consulte Coleta de Dados do Usuário.

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

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.

--logPath <DIR>

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.

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

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

--version, -v

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

Comportamento

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

Saiba mais

Voltar

Referência

Próximo

Comportamento

Nesta página