Carregar dados em um cluster infinito do Atlas

Configure um usuário de banco de dados na implantação de origem.

Se a implantação de origem impuser autenticação, o mongodump deverá se autenticar como um usuário de banco de dados que possa ler todos os bancos de dados que você migrar. A função backup no banco de dados admin concede esses privilégios.

Se esse usuário não existir em sua implantação de origem, crie um. Para aprender como criar e gerenciar usuários de banco de dados, consulte a página a seguir para seu tipo de implantação:

• Para clusters gerenciados pelo Atlas, consulte Configurar usuários de banco de dados.

• Para implantações autogerenciadas, consulte Gerenciar usuários e funções em implantações autogerenciadas.

Configure um usuário de banco de dados no cluster Atlas Infinite de destino.

mongorestore deve se autenticar como um usuários de banco de dados que pode gravar em todos os banco de dados que você migrar. A função Atlas admin no cluster Atlas Infinite de destino concede esses privilégios.

Se esse usuário não existir no seu cluster Atlas Infinite de destino, crie um. Para aprender como criar e gerenciar usuários de banco de dados no Atlas, consulte Configurar usuários de banco de dados.

Conceda acesso à sua rede hospedar às implantações de origem e destino.

Certifique-se de que o hospedar onde você executa mongodump e mongorestore possa alcançar ambas as implantações:

• Adicione o hospedar à lista de acesso IP do projeto que contém seu cluster Atlas Infinite de destino. Para aprender como adicionar um hospedar a uma lista de acesso IP, consulte Configurar entradas de lista de acesso IP.

• Se sua implantação de origem for um cluster do Atlas Core em um projeto diferente, adicione o hospedar à lista de acesso IP desse projeto também. Se sua implantação de origem for autogerenciada, configure seu firewall para aceitar conexões do hospedar. Para aprender mais, consulte Proteção de rede e configuração.

Se você configurar o emparelhamento da VPC, você pode adicionar o bloco CIDR da VPC do peer ou uma sub-rede, ou o grupo de segurança da VPC do peer à lista de acesso IP. Para saber mais, consulte Lista de acesso IP.

Execute mongodump.

1. Montar o comando mongodump.

   O seguinte modelo de comando mongodump conecta-se a um conjunto de réplicas de origem ou cluster autônomo usando sua string de conexão e gera um arquivo do dump para um arquivo.

   Copie o modelo no seu editor de texto preferido e substitua o placeholder <connectionString> pela string de conexão da sua implantação de origem, e o <fileName> pelo nome do arquivo a ser criado.

   mongodump --uri "<connectionString>" --archive=<fileName>.archive

   Para aprender como construir uma string de conexão para sua implantação de origem, consulte string de conexão.

   Observação

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

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

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

2. Execute o comando concluído a partir de um terminal ou prompt de comando em um host que tenha acesso de rede à sua implantação de origem.

   Exemplo

   O comando mongodump a seguir conecta-se a um cluster Atlas Core de origem usando uma string de conexão SRV, que contém o nome de usuário (mySourceUsername) e a senha (mySourcePassword) de um usuário de banco de dados com a função backup no banco de dados admin. O comando gera um arquivo do dump para um arquivo chamado mongodump.archive no diretório de trabalho atual.

   mongodump --uri "mongodb+srv://mySourceUsername:mySourcePassword@cluster0.example.mongodb.net" \          --archive="mongodump.archive"

Execute mongorestore.

1. Montar o comando mongorestore.

   O modelo de comando mongorestore a seguir conecta-se ao seu cluster Atlas Infinite de destino usando sua string de conexão e restaura o arquivo criado por mongodump. Ele usa --nsExclude para excluir os bancos de dados admin e config, que o Atlas gerencia.

   Copie o modelo para o editor de texto de sua preferência e substitua os seguintes espaços reservados pelos valores apropriados:

   • <connectionString>: substitua por a string de conexão SRV para o seu cluster Atlas Infinite de destino. Para recuperar ou construir uma string de conexão para o seu cluster de destino, consulte Cadeias de conexão.

     Inclua o nome de usuário e a senha de um usuário de banco de dados com a função Atlas admin na string de conexão.

   • <filePath>: substitua isso pelo caminho para o arquivo morto criado por mongodump.

   Observação

   Se o nome de usuário ou senha incluir os seguintes caracteres, esses caracteres deverão ser convertidos usando a codificação percentual:

   $ : / ? # [ ] @

   mongorestore --uri "<connectionString>" \             --archive="<filePath>" \             --nsExclude "admin.*" \             --nsExclude "config.*"

2. Execute o comando concluído a partir de um terminal ou prompt de comando em um hospedar que tenha acesso ao arquivo criado por mongodump.

   Exemplo

   O seguinte comando mongorestore conecta-se a um cluster Atlas Infinite usando uma string de conexão SRV, que contém o nome de usuário (myDestinationUsername) e a senha (myDestinationPassword) para um usuário de banco de dados com a função Atlas admin. O comando restaura o arquivo em mongodump.archive criado por mongodump, excluindo os bancos de dados admin e config.

   mongorestore --uri "mongodb+srv://myDestinationUsername:myDestinationPassword@cluster0.example.mongodb.net" \          --archive="mongodump.archive" \          --nsExclude "admin.*" \          --nsExclude "config.*"

Verifique a migração.

Após a conclusão da migração, conecte-se ao seu cluster Atlas Infinite e verifique se os dados foram migrados com sucesso. Você pode executar query para verificar a presença de suas coleção e documento no cluster de destino.

Atualize seus aplicativos para apontar para o cluster Atlas Infinite.

Após verificar a migração, atualize seus aplicativo para se conectar ao cluster Atlas Infinite em vez da implantação de origem. Certifique-se de usar a string de conexão e as credenciais corretas para o cluster Atlas Infinite.

No Atlas, vá para a página Database & Network Access do seu projeto.

1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

3. Na barra lateral, clique em Database & Network Access sob o título Security.

A página Acesso ao banco de dados e à rede é exibida após a conclusão das etapas anteriores.

Configure um usuário de banco de dados no cluster do Atlas de destino.

Para executar mongoimport para gravar em um cluster do Atlas, você deve especificar um usuário de banco de dados que tenha privilégios de readWrite no banco de dados para o qual importar dados. Por exemplo, um usuário com a função Atlas admin fornece esses privilégios.

Se esse usuário não existir, crie o usuário:

1. Se ainda não estiver sendo exibido, clique na aba Database Users.

2. Clique em Add New Database User.

3. Adicione um usuário Atlas admin .

No Atlas, vá para a página Clusters do seu projeto.

1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

3. Na barra lateral, clique em Clusters sob o título Database.

A página Clusters é exibida.

Clique em Connect.

Clique em Connect para o cluster do Atlas para o qual você deseja migrar os dados.

Atualizar Lista de Acesso IP.

Se o host onde você executar mongoimport não estiver na Lista de acesso IP, atualize a lista. Você pode especificar:

• O endereço IP público do servidor no qual o mongoimport será executado, ou

• Para o emparelhamento VPC, você pode definir o bloco VPC CIDR do peer (ou uma sub-rede) ou o Grupo de Segurança do peer VPC, se você escolher a AWS como seu fornecedor de serviço em nuvem.

Copie as informações do hospedar / URI do cluster de destino.

Você pode se conectar ao cluster do Atlas usando sua URI de string de conexão. Na caixa de diálogo de conexão, execute as seguintes etapas:

1. Clique em Drivers.

2. Copie a cadeia de conexão localizada na etapa 1.

3. Substitua SENHA pela senha do usuário root e DATABASE pelo nome do banco de dados ao qual você deseja se conectar.

   Importante

   Você deve trocar quaisquer instâncias do caractere @ no <PASSWORD> fornecido. Por exemplo, p@ssword deve ser p%40ssword.

Essa string de conexão é especificada para mongoimport na opção --uri.

Ao utilizar o --host, se o Atlas cluster for um conjunto de réplicas, você também deverá recuperar o nome do conjunto de réplicas. Por exemplo:

myAtlasRS/atlas-host1:27017,atlas-host2:27017,atlas-host3:27017

Execute o mongoimport.

Conecte-se ao seu cluster Atlas Infinite.

Para executar as operações de gravar em massa neste procedimento, conecte-se ao seu cluster com mongosh. Para aprender como, consulte Conectar a um cluster do Atlas.

Você também pode executar operações de gravação em massa a partir do código do aplicativo com um driver do MongoDB, da IU do Atlas ou de qualquer outra interface que se conecte ao seu cluster. Para aprender sobre as operações equivalentes em cada interface, consulte Operações de gravação em massa.

Execute a operação de gravar em massa.

Para gravar em uma única coleção, execute bulkWrite(). Para saber mais sobre os tipos de operação de gravação e as opções de gravação em massa, consulte bulkWrite().

Por exemplo, o comando a seguir insere dois documentos na coleção inventory:

db.inventory.bulkWrite( [   { insertOne: { document: {      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f1"),      item: "notebook",      qty: 50   } } },   { insertOne: { document: {      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f2"),      item: "pencil",      qty: 100   } } }] )

Para gravar em várias coleções ou bancos de dados em uma solicitação, execute bulkWrite() e especifique o namespace para cada operação. Por exemplo, o comando a seguir insere um documento na coleção sales.inventory e um documento na coleção supplies.inventory:

db.getMongo().bulkWrite( [   {      namespace: "sales.inventory",      name: "insertOne",      document: { item: "notebook", qty: 50 }   },   {      namespace: "supplies.inventory",      name: "insertOne",      document: { item: "pencil", qty: 100 }   }] )

Por padrão, as operações de gravar em massa são executadas em ordem e param no primeiro erro. Para aprender como configurar a ordem de executar, consulte Execução de Operações.

Verifique os resultados.

Revisar as contagens que a operação retorna e confirmar a contagem de documentos em cada coleção de destino. Para aprender mais, consulte Saída.

Para aprender como lidar com erros em operações de gravação em massa, consulte Tratamento de erros.