ApsaraDB for MongoDB:Migrar MongoDB Atlas usando ferramentas do MongoDB

Observações de uso

• As versões do mongodump e do mongorestore devem corresponder à versão do seu banco de dados MongoDB Atlas. Para obter as etapas de instalação, consulte a documentação oficial Instale o MongoDB.

• Para informações sobre as versões e mecanismos de armazenamento compatíveis com o ApsaraDB for MongoDB, consulte Versões e mecanismos de armazenamento. Verifique a compatibilidade antes de migrar dados entre versões ou mecanismos de armazenamento diferentes.

• Trata-se de uma migração completa de dados. Para garantir a consistência dos dados, interrompa as operações de gravação no banco de dados source antes de iniciar a migração.

• A execução do comando mongodump substitui os arquivos de backup existentes no diretório dump. Caso já tenha executado o mongodump no banco de dados source, mova os arquivos existentes para fora do diretório dump/@filepath e certifique-se de que o diretório dump/@filepath esteja vazio.

• Execute o mongodump e o mongorestore em um servidor onde o MongoDB esteja instalado, e não diretamente no shell mongo.

Permissões necessárias

Pré-requisitos

No console do ApsaraDB for MongoDB, conclua as seguintes etapas:

1. Crie uma instância do ApsaraDB for MongoDB. Para mais informações, consulte Criar uma instância de conjunto de réplicas ou Criar uma instância de cluster fragmentado.

   Nota

   • O espaço de armazenamento da instância do ApsaraDB for MongoDB deve ser superior ao da instância do MongoDB Atlas.

   • Para migrar dados para uma instância de cluster fragmentado, fragmente os dados primeiro. Para mais informações, consulte Ativar fragmentação.

2. Defina uma senha de banco de dados para a instância do ApsaraDB for MongoDB. Para mais informações, consulte Redefinir a senha.

   Nota

   Ignore esta etapa se você definiu uma senha de banco de dados durante a criação da instância.

No servidor local, conclua as seguintes etapas:

1. Instale o MongoDB. Para mais informações, consulte Instale o MongoDB.

   Nota

   • Este servidor atua como um intermediário temporário para o processo de backup e restauração, deixando de ser necessário após a conclusão da migração.

   • O espaço disponível em disco na partição do diretório de backup deve ser maior que o espaço de armazenamento utilizado pelo banco de dados MongoDB Atlas.

2. Adicione o endereço IP público do seu servidor local à lista de permissões da instância do ApsaraDB for MongoDB. Para mais informações, consulte Configure uma lista de permissões.

Migrar dados do MongoDB Atlas

1. Faça login no console do MongoDB Atlas.

2. Adicione o endereço IP público do seu servidor local à IP Access List da instância do MongoDB Atlas. No painel de navegação à esquerda, clique em Clusters. Na aba Security, clique em Network Access e, em seguida, clique em + ADD IP ADDRESS no canto superior direito. Na caixa de diálogo Add IP Access List Entry, insira o endereço IP público do seu servidor local e clique em Confirm.

3. Na página Clusters, clique em no nome do seu cluster.

4. Na aba Command Line Tools, clique em COPY ao lado do comando mongodump para copiar o comando com as informações de conexão do seu banco de dados MongoDB Atlas.

5. No seu servidor local, faça o backup do banco de dados MongoDB Atlas.

   1. Cole o comando mongodump que contém as informações de conexão do seu banco de dados MongoDB Atlas.

   2. Substitua <PASSWORD> pela senha do seu banco de dados e <DATABASE> pelo nome do banco de dados a ser copiado.

   3. Execute o comando e aguarde a conclusão do backup.

6. Faça login no console do ApsaraDB for MongoDB e obtenha o endpoint público da sua instância do ApsaraDB for MongoDB.

   • Para uma instância de conjunto de réplicas, obtenha o endpoint público do nó primário. Para mais informações, consulte Conectar-se a uma instância de conjunto de réplicas.

   • Para uma instância de cluster fragmentado, obtenha o endpoint público de qualquer nó mongos. Para mais informações, consulte Conectar-se a uma instância de cluster fragmentado.

   Nota

   É necessário solicitar manualmente um endpoint público antes desta etapa. Para mais informações, consulte Solicitar um endpoint público.

7. No seu servidor local, execute o seguinte comando para importar dados para a instância do ApsaraDB for MongoDB.

   mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -d <database> <database_backupfile_directory>

   Nota

   • <mongodb_host>: o endpoint público do nó primário da instância de conjunto de réplicas ou de um nó mongos da instância de cluster fragmentado.

   • <username>: a conta de banco de dados da instância do ApsaraDB for MongoDB. Por exemplo, test.

   • <database>: o banco de dados a ser restaurado. Se o backup contiver vários bancos de dados, repita esta etapa para cada um deles.

   • <database_backupfile_directory>: o diretório onde o arquivo de backup do banco de dados está localizado.

   Exemplos:

   Restaurar o banco de dados mongodbtest:

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d mongodbtest /dump/mongodbtest

   Restaurar o banco de dados test123:

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d test123 /dump/test123

8. Quando solicitado por Enter password:, insira a senha da sua instância do ApsaraDB for MongoDB e pressione Enter.

Após a conclusão da restauração, o banco de dados MongoDB Atlas terá sido migrado com sucesso para sua instância do ApsaraDB for MongoDB.