Carregar dados em um Atlas cluster infinito

Configure um usuário de banco de dados no sistema de origem.

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

Se esse usuário não existir em seu sistema de origem, crie um. Para saber como criar e gerenciar usuários do banco de dados , consulte a seguinte página para seu tipo de sistema:

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

• Para sistemas autogerenciados, consulte Gerenciar usuários e roles em sistemas autogerenciados.

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

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

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

Conceda ao seu host acesso aos sistemas de origem e destino.

Certifique-se de que o host em que você executa mongodump e mongorestore possa acessar ambos os sistemas:

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

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

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

Execute mongodump.

1. Montar o comando mongodump.

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

   Copie o modelo no editor de texto de sua preferência e substitua o espaço reservado <connectionString> pela string de conexão para seu sistema de origem, e <fileName> pelo nome do arquivo compactado a ser criado.

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

   Para saber como construir uma string de conexão para seu sistema de origem, consulte Connection strings.

   Observação

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

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

   • 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 ao seu sistema de origem.

   Exemplo

   O comando mongodump a seguir se conecta a um cluster de origem Atlas Core 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 na admin banco de dados. O comando gera um arquivo do despejo 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 se conecta ao 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 no editor de texto de sua preferência e substitua os seguintes espaços reservados pelos valores apropriados:

   • <connectionString>: substitua isso pela string de conexão SRV para seu cluster Atlas Infinite de destino. Para recuperar ou construir uma string de conexão para o cluster de destino, consulte Connection strings.

     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 criado por mongodump.

   Observação

   Se o nome de usuário ou senha incluir os seguintes caracteres, esses caracteres deverão ser convertidos usando 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 host que tenha acesso ao arquivo criado por mongodump.

   Exemplo

   O comando mongorestore a seguir se conecta a um Atlas Infinite cluster usando uma string de conexão SRV, que contém o nome de usuário (myDestinationUsername) e a senha (myDestinationPassword) de 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 migração ser concluída, conecte-se ao cluster do Atlas Infinite e verifique se os dados foram migrados com sucesso. Você pode executar queries para verificar a presença de suas coleções e documentos no cluster de destino.

Atualize seus aplicativos para ponto para o cluster Atlas Infinite.

Depois de verificar a migração, atualize seus aplicativos para se conectar ao Atlas Infinite cluster em vez do sistema de origem. Certifique-se de utilizar a string de conexão e 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.

O banco de dados & A página Acesso à rede é exibida depois de concluir as etapas anteriores.

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

Para executar mongoimport para gravar em um Atlas cluster, é necessário especificar um usuário de banco de dados que tenha privilégios de leitura e gravação no banco de dados para o qual os dados serão importados. Por exemplo, um usuário com papel Atlas admin fornece estes 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á não mongoimport 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 host / URI do cluster de destino.

Você pode se conectar ao cluster do Atlas usando sua cadeia de conexão URI. 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 --uri opção.

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 gravação em massa neste procedimento, conecte-se ao cluster com mongosh. Para saber como, consulte Conectar a um Atlas cluster.

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

Execute a operação de gravação em massa.

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

Por exemplo, o seguinte comando insere dois documentos na collection inventory:

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

Para escrever em várias collections 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 gravação em massa são executadas em ordem e param no primeiro erro. Para saber como configurar a ordem de execução, consulte Execução de operações.

Verifique os resultados.

Revise as contagens que a operação retorna e confirme a contagem de documento em cada coleção de destino. Para saber mais,consulte Saída.

Para saber como lidar com erros em operações de escrita em massa, consulte Tratamento de erros.