mongodump

Definição

mongodump é um utilitário que cria uma exportação binária do conteúdo de um banco de dados. mongodump pode exportar dados de:

• Sistemas autônomos

• Conjuntos de réplicas

• Clusters fragmentados

• Clusters flexíveis

Você pode usar as Ferramentas de Banco de Dados MongoDB para migrar de um sistema auto-hospedado para o MongoDB Atlas. MongoDB Atlas é o serviço totalmente gerenciado para sistemas MongoDB na nuvem. Para saber mais, consulte Seed com mongorestore.

Para saber todas as maneiras de migrar para o MongoDB Atlas, consulte Migrar ou importar dados.

mongodump pode se conectar a mongod instâncias mongos e .

Você pode restaurar os arquivos BSON gerados do mongodump para implantações do MongoDB que estejam executando a mesma versão principal ou versão de compatibilidade de recursos da implantação de origem.

Execute mongodump na linha de comando do sistema, não no mongo shell.

Se você estiver arquivando dados obsoletos para economizar nos custos de armazenamento, considere o Online Archive no MongoDB Atlas. O Online Archive arquiva automaticamente dados acessados com pouca frequência em buckets S3 totalmente gerenciados para uma divisão econômica dos dados em níveis.

mongodump despejos:

• Documentos, metadados e opções da coleção.

• Definições de índice.

• Gravações que ocorrem durante a exportação, se executadas com a mongodump --oplog opção.

mongodump despeja dados em um diretório ou arquivo binário.

dump
├── easternSalesDatabase
│    ├── sales.bson
│    ├── sales.metadata.json
│    └── salesByMonthView.metadata.json
├── westernSalesDatabase
│    ├── sales.bson
│    ├── sales.metadata.json
│    └── salesByMonthView.metadata.json
└── oplog.bson

Sintaxe

mongodump sintaxe:

mongodump <options> <connection-string>

mongodump

Opções

--help

Retorna informações sobre as opções e uso de mongodump.

--verbose, -v

Aumenta a quantidade de relatórios internos retornados no resultado padrão ou em arquivos de log. Aumente a verbosidade com a forma -v incluindo a opção várias vezes. Por exemplo: -vvvvv.

--quiet

Executa mongodump em um modo silencioso que tenta limitar a quantidade de resultado.

Esta opção suprime:

• Saída de comandos do banco de dados

• atividade de replicação

• Conexão aceita e eventos fechados

• Todos os registros, incluindo mensagens de erro, exceto aqueles que ocorrem ao analisar opções

--version

Retorna o número de versão mongodump.

--config=<filename>

Novidades na versão 100.3.0.

Especifica o caminho completo para um arquivo de configuração YAML que contém valores confidenciais para as opções de mongodump seguintes:

• --password

• --uri

• --sslPEMKeyPassword

Esta é a maneira recomendada de especificar uma senha para mongodump, além de especificá-la por meio de um prompt de senha. Você pode usar qualquer combinação dos argumentos no arquivo.

O arquivo de configuração recebe o seguinte formulário:

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

Se você especificar a opção password sem especificar uri, poderá definir os outros componentes da string de conexão usando as opções de linha de comando mongodump, como --username e --host.

Certifique-se de proteger este arquivo com permissões de sistema de arquivos apropriadas.

Importante

Ao usar a opção --config, tenha em mente as seguintes limitações e comportamentos:

• Se você fornecer o campo password e uma string de conexão no campo uri com uma senha conflitante, a mongorestore emitirá um erro.

• Se você especificar um arquivo de configuração com --config e também utilizar as opções de linha de comando --password, --uri ou --sslPEMKeyPassword mongodump, a opção de linha de comando substituirá a opção de arquivo de configuração correspondente.

--uri=<connectionString>

Especifica a string de conexão resolvível da implantação do MongoDB, entre aspas:

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

A partir da versão 100.0 mongodumpde, a string de conexão pode ser fornecida como um parâmetro posicional, sem usar a --uri opção:

mongodump mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

Como parâmetro posicional, a connection string pode ser especificada em qualquer ponto da linha de comando, desde que comece com mongodb:// ou mongodb+srv://. Por exemplo:

mongodump --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

Somente uma string de conexão pode ser fornecida. A tentativa de incluir mais de uma, seja usando a opção --uri ou como um argumento posicional, resultará em um erro.

Para obter informações sobre os componentes da string de conexão, consulte a documentação Formato de URI da string de conexão .

Observação

Como alternativa, alguns componentes da connection string podem ser especificados usando suas próprias opções explícitas de linha de comando, como --username e --password. Fornecer uma connection string e, ao mesmo tempo, usar uma opção explícita e especificar informações conflitantes resultará em um erro.

Observação

Se estiver usando mongodump no Ubuntu,18.04 você pode enfrentar uma cannot unmarshal DNS mensagem de erro ao usar connection strings SRV (no mongodb+srv:// formato) com a opção. Nesse caso, use uma das seguintes --uri opções:

• a opção --uri com uma string de conexão não SRV (no mongodb:// formato)

• a opção --host para especificar o host e conectar diretamente

Aviso

Em alguns sistemas, uma senha fornecida em uma string de conexão com a opção --uri pode ser visível para programas de status do sistema como ps que podem ser invocados por outros usuários. Em vez disso, considere:

• omitindo a senha na cadeia de conexão para receber um prompt de senha interativo , ou

• utilizando a opção --config para especificar um arquivo de configuração que contém a senha.

--host=<hostname><:port>, -h=<hostname><:port>

Padrão: localhost:27017

Especifica o nome de host resolvível do sistema MongoDB. Por padrão, mongodump tenta se conectar a uma instância do MongoDB em execução no host local na porta número 27017.

Para se conectar a um conjunto de réplicas, especifique o replSetName e uma lista de sementes de membros do conjunto, como a seguir:

--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

Ao definir o formato da lista de conjuntos de réplicas, mongodump sempre se conecta ao primary.

Você também pode se conectar a qualquer membro da réplica definida especificando o host e a porta de apenas esse membro:

--host=<hostname1><:port>

Se você usar IPv6 e o formato <address>:<port>, deverá incluir a parte da combinação de endereço e porta entre colchetes. Por exemplo: [<address>].

Outra opção é especificar o nome do host diretamente no URI connection string. Fornecer uma string de conexão ao mesmo tempo em que usa --host e especificar informações conflitantes resultará em um erro.

--port=<port>

Padrão: 27017

Especifica a porta TCP na qual a instância do MongoDB escuta conexões de cliente.

Alternativamente, você também pode especificar a porta diretamente no URI connection string. Fornecer uma string de conexão e, ao mesmo tempo, usar --port e especificar informações conflitantes resultará em um erro.

--ssl

Habilita uma conexão para um mongod ou mongos que tenha suporte a TLS/SSL habilitado.

Alternativamente, você também pode configurar o suporte de TLS/SSL diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --ssl e especificar informações conflitantes resultará em um erro.

--sslCAFile=<filename>

Especifica o arquivo .pem que contém a sequência de certificados raiz da autoridade de certificação. Especifique o nome do arquivo .pem usando caminhos relativos ou absolutos.

Alternativamente, você também pode especificar o .pem arquivo diretamente no. Fornecer uma string de conexão e,URI connection string ao mesmo tempo,--sslCAFile usar e especificar informações conflitantes resultará em um erro.

--sslPEMKeyFile=<filename>

Especifica o arquivo .pem que contém o certificado e a chave TLS/SSL. Especifique o nome do arquivo .pem usando caminhos relativos ou absolutos.

Esta opção é exigida ao utilizar a --ssl opção para conectar a um mongod ou mongos que tem CAFile habilitado allowConnectionsWithoutCertificatessem.

Alternativamente, você também pode especificar o .pem arquivo diretamente no. Fornecer uma string de conexão e,URI connection string ao mesmo tempo,--sslPEMKeyFile usar e especificar informações conflitantes resultará em um erro.

--sslPEMKeyPassword=<value>

Especifica a senha para descriptografar o arquivo de chave de certificado (ou seja, --sslPEMKeyFile). Utilize a opção `--sslPEMKeyPassword somente se o arquivo da chave de certificado for codificado. A opção mongodump sempre omitirá a senha de todos os resultados de registros e relatórios.

Se a chave privada no arquivo PEM estiver criptografada e você não especificar a opção --sslPEMKeyPassword, mongodump solicitará uma senha. Consulte Senha do Certificado TLS/SSL.

Como alternativa, você também pode especificar a senha diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --sslPEMKeyPassword e especificar informações conflitantes resultará em um erro.

Aviso

Em alguns sistemas, uma senha fornecida diretamente utilizando a opção --sslPEMKeyPassword pode ser 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.

--sslCRLFile=<filename>

Especifica o arquivo .pem que contém a lista de certificados revogados. Especifique o nome do arquivo .pem usando caminhos relativos ou absolutos.

--sslAllowInvalidCertificates

Ignora as verificações de validação de certificados de servidor e permite o uso de certificados inválidos. Ao usar a configuração, o MongoDB registra como aviso o uso do certificado allowInvalidCertificates inválido.

Aviso

Embora disponível, evite utilizar a opção --sslAllowInvalidCertificates se possível. Se o uso do --sslAllowInvalidCertificates for necessário, use a opção somente em sistemas em que a intrusão não seja possível.

Conectar-se a uma instância mongod ou sem validar os certificados do servidor é um risco potencial à segurança. Se você só precisar desabilitar a validação do nome de host nos certificados TLS/SSL,mongos --sslAllowInvalidHostnames consulte.

Como alternativa, você também pode desativar a validação do certificado diretamente no URI connection string. Fornecer uma string de conexão e, ao mesmo tempo, usar --sslAllowInvalidCertificates e especificar informações conflitantes resultará em um erro.

--sslAllowInvalidHostnames

Desabilita a validação dos nomes de host em certificados TLS/SSL. Permite que o mongodump se conecte às instâncias do MongoDB mesmo que o nome do host em seus certificados não corresponda ao nome de host especificado.

Alternativamente, você também pode desabilitar a validação do nome de host diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --sslAllowInvalidHostnames e especificar informações conflitantes resultará em um erro.

--username=<username>, -u=<username>

Especifica um nome de usuário com o qual autenticar em um banco de dados MongoDB que usa autenticação. Use em conjunto com as opções --password <mongodump --password> e --authenticationDatabase <mongodump --authenticationDatabase>.

Alternativamente, você também pode especificar o nome de usuário diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --username e especificar informações conflitantes resultará em um erro.

Se estiver se conectando a um cluster MongoDB Atlas usando MONGODB-AWS authentication mechanism o, você pode especificar seu ID de chave de acesso do AWS em:

• esse campo,

• connection stringo, ou

• a variável de ambiente AWS_ACCESS_KEY_ID.

Consulte Conecte-se a um cluster do MongoDB Atlas usando as credenciais AWS IAM para ver um exemplo de cada um.

--password=<password>, -p=<password>

Especifica uma senha com a qual autenticar em um banco de dados MongoDB que usa autenticação. Use em conjunto com as opções --username <mongodump --username> e --authenticationDatabase <mongodump --authenticationDatabase>.

Para solicitar a senha do usuário, passe a opção --username <mongodump --username> sem --password <mongodump --password> ou especifique uma string vazia como o valor --password <mongodump --password>, como em --password "".

Como alternativa, você também pode especificar a senha diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --password e especificar informações conflitantes resultará em um erro.

Se estiver se conectando a um cluster do MongoDB Atlas usando MONGODB-AWS authentication mechanism o, você poderá especificar sua chave de acesso secreta da AWS em:

• esse campo,

• connection stringo, ou

• a variável de ambiente AWS_SECRET_ACCESS_KEY.

Consulte Conecte-se a um cluster do MongoDB Atlas usando as credenciais AWS IAM para ver um exemplo de cada um.

Aviso

Em alguns sistemas, uma senha fornecida diretamente utilizando a opção --password pode ser visível para programas de status do sistema como ps que podem ser invocados por outros usuários. Em vez disso, considere:

• omitir a opção --password para receber uma solicitação de senha interativa ou

• utilizando a opção --config para especificar um arquivo de configuração que contém a senha.

--awsSessionToken=<AWS Session Token>

Se estiver se conectando a um cluster do MongoDB Atlas usando o MONGODB-AWS authentication mechanism e usando tokens de sessão além do ID da chave de acesso da AWS e da chave de acesso secreta, você poderá especificar o token de sessão da AWS em:

• esse campo,

• o AWS_SESSION_TOKEN authMechanismProperties parâmetro para o,connection string ou

• a variável de ambiente AWS_SESSION_TOKEN.

Consulte Conecte-se a um cluster do MongoDB Atlas usando as credenciais AWS IAM para ver um exemplo de cada um.

Válido somente ao usar o MONGODB-AWS authentication mechanism.

--authenticationDatabase=<dbname>

Especifica o banco de dados de autenticação onde o --username <mongodump --username> especificado foi criado. Consulte o Banco de dados de autenticação.

Se você não especificar um banco de dados de autenticação, o mongodump assumirá que o banco de dados especificado para exportar mantém as credenciais do usuário.

Se você não especificar um banco de dados de autenticação ou um banco de dados para exportar, o mongodump presumirá que o banco de dados admin contém as credenciais do usuário.

Se você usar GSSAPI (Kerberos), PLAIN (LDAP SASL) ou MONGODB-AWS authentication mechanisms, você deverá definir --authenticationDatabase como $external.

Alternativamente, você também pode especificar o banco de dados de autenticação diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --authenticationDatabase e especificar informações conflitantes resultará em um erro.

--authenticationMechanism=<name>

Padrão: SCRAM-SHA-1

Especifica o mecanismo de autenticação que a instância do mongodump utiliza para autenticar no mongod ou mongos.

Alterado na versão 100.1.0:

A partir da versão 100.1.0, o mongodump oferece suporte ao mecanismo de autenticação MONGODB-AWS ao se conectar a um cluster MongoDB Atlas.

Valor	Descrição
SCRAM-SHA-1	RFC 5802 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a1 função de hash SHA-.
SCRAM-SHA-256	RFC 7677 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a256 função de hash SHA-. Exige featureCompatibilityVersion definido para 4.0.
MONGODB-X.509	Autenticação de certificado TLS/SSL do MongoDB.
MONGODB-AWS	Autenticação externa usando credenciais AWS IAM para uso na conexão com um cluster do MongoDB Atlas . Consulte Conectar-se a um cluster do MongoDB Atlas usando Credenciais AWS IAM. Novidades na versão 100.1.0.
GSSAPI (Kerberos)	Autenticação externa usando Kerberos. Esse mecanismo está disponível somente no MongoDB Enterprise.
PLAIN (LDAP SASL)	Autenticação externa usando LDAP. Você também pode utilizar o PLAIN para autenticar usuários de banco de dados. PLAIN transmite senhas em texto simples. Esse mecanismo está disponível somente no MongoDB Enterprise.

Alternativamente, você também pode especificar o mecanismo de autenticação diretamente no URI connection string. Fornecer uma string de conexão e, ao mesmo tempo, usar --authenticationMechanism e especificar informações conflitantes resultará em um erro.

--gssapiServiceName

Especifique o nome do serviço utilizando GSSAPI/Kerberos. Obrigatório apenas se o serviço não usar o nome mongodb padrão.

Esta opção está disponível apenas no MongoDB Enterprise.

Alternativamente, você também pode especificar o nome do serviço diretamente URI connection string no. Fornecer uma string de conexão e, ao mesmo tempo,--gssapiServiceName usar e especificar informações conflitantes resultará em um erro.

--gssapiHostName

Especifique o nome de host de um serviço utilizando GSSAPI/Kerberos </core/kerberos>. Somente necessário se o nome do host de uma máquina não coincidir com o nome do host resolvido pelo DNS.

Esta opção está disponível apenas no MongoDB Enterprise.

--db=<database>, -d=<database>

Especifica um banco de dados para backup. Se você não especificar um banco de dados, mongodump copiará todos os bancos de dados nesta instância para os arquivos de despejo.

Alternativamente, você também pode especificar o banco de dados diretamente no URI connection string. Fornecer uma connection string e, ao mesmo tempo, usar --db e especificar informações conflitantes resultará em um erro.

--collection=<collection>, -c=<collection>

Especifica uma coleção para backup. Se você não especificar uma coleção, esta opção copiará todas as coleções no banco de dados especificado ou instância para os arquivos de dump.

--query=<json>, -q=<json>

Fornece um documento JSON como uma query que opcionalmente limita os documentos incluídos na saída mongodump de. Para usar a --query opção, você também deve especificar a --collection <mongodump --collection> opção.

Você deve colocar o documento de query entre aspas simples ('{ ... }') para garantir que ele não interaja com seu ambiente de shell.

A query deve estar no formato JSON2 Estendido v ( modo relaxado ou canônico/estrito), incluindo os nomes de campo e operadores entre aspas. Por exemplo:

mongodump -d=test -c=records -q='{ "a": { "$gte": 3 }, "date": { "$lt": { "$date": "2016-01-01T00:00:00.000Z" } } }'

Para utilizar $regex mongodumpo com, utilize a seguinte sintaxe:

mongodump -d=sample_mflix -c=movies -q='{ "year": { "$regex": "20" } }'

A partir do MongoDB 9.0, o servidor corresponde caminhos de campo pontilhados ao null de forma diferente quando um componente intermediário do caminho é uma array de valores escalares. Essa alteração afeta os operadores $eq, $ne, $in e $nin.

Por exemplo, considere uma coleção que tenha o documento { "a": [ 1 ] }. O caminho a.b não existe nesse documento.

• No MongoDB 8.x e anteriores, o predicado { "a.b": { "$ne": null } } corresponde ao documento.

• A partir do MongoDB 9.0, o mesmo predicado não corresponde ao documento, e o predicado { "a.b": { "$eq": null } } corresponde a ele.

Se sua query usar esse predicado, o mesmo valor --query selecionará um conjunto diferente de documentos no MongoDB 9.0 do que nas versões anteriores. Uma operação que filtra em { "$ne": null } retorna menos documentos. Revise qualquer query que compare um caminho pontilhado com null antes de fazer dump ou exportar dados de uma implantação do MongoDB 9.0. Confirme se a query ainda seleciona os documentos que você espera.

Observação

Ao usar a --query opção em uma coleção de séries temporais, você só pode consultar o campo especificado metaField como.

--queryFile=<path>

Especifica o caminho para um arquivo contendo um documento JSON como um filtro de consulta que limita os documentos incluídos na saída de mongodump. --queryFile permite que você crie filtros de consulta que são grandes demais para caber no buffer do terminal.

Observação

Ao usar a opção --queryFile em uma coleção de séries temporais, só é possível executar uma query no campo especificado como metaField.

--readPreference=<string|document>

Padrão: primary

Especifica a preferência de leitura mongodump para. A --readPreference opção pode levar:

• Uma string se especificar apenas o modo de read preference:

  --readPreference=secondary

• Um documento com aspas para especificar o modo, os conjuntos de tags de preferência de leitura opcionais e o maxStalenessSeconds: opcional

  --readPreference='{mode: "secondary", tagSets: [ { "region": "east" } ], maxStalenessSeconds: 120}'

  Se especificar maxStalenessSeconds, o valor deve ser maior ou igual 90 a.

mongodump primary tem como padrão a preferência de leitura.

Se a preferência de leitura também for incluída no --uri connection string <--uri>, a linha de comando --readPreference substituirá a preferência de leitura definida na string URI.

--gzip

Compacta a saída. Se mongodump tiver o diretório de despejo como saída, o novo recurso compactará os arquivos individuais. Os arquivos apresentam o sufixo .gz.

Se mongodump gera um arquivo de arquivamento ou a saída padrão, o novo recurso comprime o arquivo de arquivamento ou os dados de saída para o fluxo.

--out=<path>, -o=<path>

Especifica o diretório em que mongodump gravará arquivos BSON para os bancos de dados despejados. Por padrão, omongodump salva os arquivos de saída em um diretório denominado dump no diretório de trabalho atual.

Para enviar o despejo do banco de dados para a saída padrão, especifique "-" em vez de um caminho. Grave na saída padrão se quiser processar a saída antes de salvá-la, como usar gzip para compactar o despejo. Ao gravar a saída padrão, mongodump não grava os metadados gravados em um arquivo <dbname>.metadata.json ao gravar diretamente nos arquivos.

Você não pode utilizar a opção --archive com a opção --out.

--archive=<file>

Grava a saída em um arquivo especificado ou, se o arquivo não for especificado, grava na saída padrão (stdout). Um arquivo morto é uma alternativa de arquivo único a vários arquivos BSON.

• Para produzir o dump para um arquivo, execute mongodump com a opção --archive <mongodump --archive> e o nome do arquivo.

  mongodump --archive=<file>

• Para emitir o despejo no fluxo de saída padrão e direcionar para outro processo, execute o mongodump com a opção --archive <mongodump --archive>, mas omita o nome do arquivo.

  mongodump --archive

Você não pode utilizar a opção --archive <mongodump --archive> com a opção --out <mongodump --out>.

Observação

Se o escrever em um arquivo compactado,mongodump omongodump desempenho do poderá melhorar. Para obter mais informações sobre mongodump os impactos no desempenho, consulte Considerações sobre o formato de saída.

--oplog

Captura todas as entradas do oplog que ocorrem durante a operação mongodump para que o despejo reflita um único momento no tempo.

Onde mongodump coloca os dados de oplog depende do destino de saída:

• Para um despejo de diretório, mongodump grava as entradas de oplog em um arquivo oplog.bson no nível superior do diretório de saída.

• Para um despejo de arquivo, o arquivo inclui as entradas de oplog.

Ao restaurar, reproduza as entradas do oplog com mongorestore --oplogReplay. Você pode usar mongodump --oplog junto com mongorestore --oplogReplay para garantir que os dados estejam atuais e incluam todas as gravações que ocorreram durante o despejo.

Sem --oplog, se houver operações de gravação durante a operação de despejo, o despejo não refletirá um único momento no tempo. As alterações feitas no banco de dados durante o processo de atualização podem afetar a saída do backup.

Para fazer backup de conjuntos de réplicas individuais e, ao mesmo tempo, aceitar gravações, use --oplog.

Importante

Um mongodump em execução com --oplog falhará se um cliente emitir qualquer uma das operações listadas durante o processo de despejo.

• renameCollection

• db.collection.renameCollection()

• db.collection.aggregate() com $out

• mapReduce (esta operação renomeia implicitamente uma coleção)

• Operações que criam ou modificam usuários, funções ou privilégios

• setDefaultRWConcern e outros comandos que modificam as configurações de todo o cluster

--oplog não tem efeito ao executar mongodump em uma instância mongos para despejar todo o conteúdo de um cluster fragmentado.

--oplog só funciona com nós que mantêm um oplog. Isso inclui todos os membros de um conjunto de réplicas.

--oplog não faz dump da coleção oplog.

Você não pode executar mongodump com --oplog em um cluster fragmentado. Para fazer backup de clusters fragmentados com mongodump, consulte Fazer backup de um cluster fragmentado autogerenciado com um dump de banco de dados.

Observação

Para usar mongodump --oplogcom, você deve criar um dump completo de um membro do conjunto de réplicas. mongodump com --oplog falha se você usar qualquer uma das seguintes opções para limitar os dados a serem despejados:

• --db

• --collection

• --dumpDbUsersAndRoles

• --query

Aviso

Não altere a versão de compatibilidade do recurso (FCV) entre o MongoDB 8.x e o MongoDB 9.0 enquanto o mongodump --oplog estiver em execução em uma implantação que tenha coleções de séries temporais. O dump resultante abrange uma conversão de formato de série temporal, que mongorestore --oplogReplay não pode reproduzir.

A partir do Database Tools 100.18.0, mongodump falha em vez de produzir um dump que você não pode restaurar. Para saber mais, consulte reprodução de Oplog em uma conversão de formato de série temporal.

Para obter um exemplo de ponta a ponta do uso de mongodump --oplog junto com mongorestore --oplogReplay para criar um backup consistente enquanto aceita gravações, consulte Criar e restaurar arquivos de backup consistentes.

--dumpDbUsersAndRoles

Inclui definições de usuário e função no diretório de despejo do banco de dados na execução do mongodump em um banco de dados específico. Essa opção se aplica somente quando você especifica um banco de dados na opção --db. O MongoDB sempre inclui as definições de usuário e função quando mongodump se aplica a uma instância inteira e não apenas a um banco de dados específico.

--excludeCollection=<string>

Exclui a coleção especificada da saída mongodump. Para excluir várias coleções, especifique o --excludeCollection várias vezes.

Para usar a --excludeCollection opção, você deve especificar um banco de dados. Você pode especificar um banco de dados com a opção --db --uri ou na string de conexão.

--excludeCollectionsWithPrefix=<string>

Exclui das saídas de mongodump todas as coleções que tenham o prefixo especificado. Para especificar vários prefixos, insira --excludeCollectionsWithPrefix várias vezes.

Para usar a --excludeCollectionsWithPrefix opção, você deve especificar um banco de dados. Você pode especificar um banco de dados com a opção --db --uri ou na string de conexão.

--numParallelCollections=<int>, -j=<int>

Padrão: 4

O número de coleções que o mongodump deve exportar em paralelo.

--viewsAsCollections

Quando especificado, o mongodump exporta visualizações como coleções.

Observação

Somente visualizações são exportadas. Por padrão, mongodump exporta apenas os metadados de uma visualização. Para exportar os documentos em uma exibição, use a opção --viewsAsCollections.

Para cada visualização, mongodump cria um arquivo BSON contendo os documentos na visualização. Se você utilizar o mongorestore com um arquivo BSON criado pelo mongodump, a visualização será restaurada como uma coleção.

Se você não incluir --viewsAsCollections, o mongodump capturará os metadados de cada visualização. Se você incluir um arquivo de metadados de visualização em uma operação do mongorestore, a visualização será recriada.

--compressors=<string>

Especifica o algoritmo de compactação que mongodump utiliza para a comunicação de rede entre o cliente mongodump e o servidor MongoDB. Você pode usar um ou mais desses valores para a opção --compressors:

• snappy

• zlib

• zstd

Se você especificar vários algoritmos de compressão, o mongodump utilizará o primeiro na lista suportado pelo seu sistema do MongoDB .

Para obter mais informações sobre compressores, consulte a documentação sobre compactação de rede do driver Go.

Saiba mais

Para obter mais informações sobre mongodump, consulte:

• compatibilidade e instalação do mongodump

• Comportamento, acesso e uso do mongodump

• Exemplos do mongodump

Para ver um tutorial, consulte Fazer backup de um cluster fragmentado autogerenciado com um dump de banco de dados.

Para obter mais informações sobre TLS/SSL e MongoDB, consulte Configurar mongod e mongos para TLS/SSL e Configuração TLS/SSL para clientes.