Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Migrar a API do Azure Cosmos DB para MongoDB para o Alibaba Cloud

Última atualização: Jun 26, 2026

Migre dados da API do Azure Cosmos DB para MongoDB para o ApsaraDB for MongoDB com as ferramentas nativas mongodump e mongorestore.

Precauções

  • Esta é uma migração completa. Interrompa todas as operações de gravação no banco de dados source antes de iniciar.

  • Se você já usou mongodump para fazer backup do banco de dados, mova os arquivos de backup da pasta padrão dump. Caso contrário, os arquivos existentes nessa pasta serão sobrescritos.

  • Execute os comandos mongodump e mongorestore no servidor onde o MongoDB está instalado, não no shell do mongo.

Permissões necessárias

Tipo de instância

Permissão da conta

Azure Cosmos DB

read

Instância MongoDB de destino

readWrite

Pré-requisitos

  1. Crie uma instância do ApsaraDB for MongoDB. Criar uma instância.

    Nota
    • A instância de destino deve ter mais armazenamento que os dados do Azure Cosmos DB source.

    • Selecione a versão 4.0 ou posterior do MongoDB.

  2. Defina uma senha para a instância do ApsaraDB for MongoDB. Definir uma senha.

  3. Instale o MongoDB em um servidor. Instalar o MongoDB.

    Nota
    • Instale o MongoDB 3.0 ou posterior.

    • Este servidor atua como host temporário. Desative-o após a migração.

    • A partição do diretório de backup deve ter mais espaço em disco disponível que os dados do Azure Cosmos DB source.

    As etapas a seguir usam um servidor Linux como exemplo.

Procedimento

  1. Faça logon no portal do Azure.

  2. No painel de navegação à esquerda, clique em Azure Cosmos DB.

  3. Na página Azure Cosmos DB, clique em na conta a migrar.

  4. Na página de detalhes da conta, clique em Connection String.

  5. Clique em na aba Read-only Keys.

    Figura 1. Informações de conexão do Azure. Os campos incluem HOST (xxx.documents.azure.cn), PORT (10255), USERNAME, PRIMARY PASSWORD, SECONDARY PASSWORD, PRIMARY CONNECTION STRING, SECONDARY CONNECTION STRING e SSL (true). Use apenas HOST, USERNAME e PRIMARY PASSWORD.

    Nota

    Permissões de somente leitura são suficientes para esta migração.

  6. No servidor Linux, execute o comando a seguir para fazer backup do banco de dados source.

    mongodump --host <HOST>:10255 --authenticationDatabase admin -u <USERNAME> -p <PRIMARY PASSWORD> --ssl --sslAllowInvalidCertificates
    Nota

    Substitua <HOST>, <USERNAME> e <PRIMARY PASSWORD> pelos valores das Informações de conexão do Azure.

    Aguarde a conclusão do backup. Os dados ficam salvos na pasta dump do diretório atual.

  7. Obtenha o endpoint do nó primário da instância do ApsaraDB for MongoDB. Visão geral da conexão da instância.

  8. No servidor Linux, execute o comando a seguir para restaurar os dados na instância do ApsaraDB for MongoDB.

     mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -p <password> dump
    Nota
    • <mongodb_host>: endpoint do nó primário da instância de destino.

    • <username>: nome de usuário do banco de dados da instância de destino.

    • <password>: senha do banco de dados da instância de destino.

Aguarde a conclusão da restauração.