Use o Data Transmission Service (DTS) para migrar uma implantação standalone autogerenciada do MongoDB para o ApsaraDB for MongoDB com tempo de inatividade mínimo.
Para migrar usando as ferramentas nativas do MongoDB, consulte Migrar um banco de dados autogerenciado para uma instância standalone usando ferramentas do MongoDB.
Para uma visão geral completa das opções de migração, consulte Migração e sincronização de dados.
Pré-requisitos
Antes de começar, certifique-se de ter:
Verifique a compatibilidade de versões entre o seu banco de dados MongoDB autogerenciado e o ApsaraDB for MongoDB. Consulte Visão geral das soluções de migração
Provisionado uma instância do ApsaraDB for MongoDB com pelo menos 10% a mais de espaço de armazenamento do que o banco de dados de origem utiliza atualmente
Convertido a instância standalone para um replica set de nó único — necessário para ativar o oplog, que o DTS utiliza para a migração incremental
Concedido as permissões necessárias para a conta do banco de dados. Consulte Permissões necessárias para contas de banco de dados
Adicionado os blocos CIDR dos servidores DTS às configurações de segurança dos bancos de dados de origem e de destino. Consulte Adicionar endereços ip de servidores DTS a uma lista de permissões
Limitações
O banco de dados config é um banco de dados interno do sistema. Não migre este banco de dados a menos que seja necessário. Os bancos de dados admin e local não podem ser usados como origem ou destino
A instância de destino do ApsaraDB for MongoDB não deve conter documentos com a mesma chave primária (
_id) da origem. Se existirem conflitos, exclua esses documentos do destino antes de iniciar — caso contrário, ocorrerá perda de dadosO DTS grava dados de forma simultânea, portanto, o banco de dados de destino pode usar de 5% a 10% a mais de espaço de armazenamento do que a origem
Para versões e mecanismos de armazenamento suportados, consulte Versões e mecanismos de armazenamento. Verifique a compatibilidade antes de migrar entre versões ou mecanismos de armazenamento diferentes
Agende a migração durante horários de baixa demanda para minimizar o impacto em seus serviços
Faturamento
| Tipo de migração | Taxas de configuração de link | Custo de transferência de dados |
|---|---|---|
| Migração completa de dados | Gratuito | Cobrado ao transferir dados para fora da Alibaba Cloud pela Internet. Consulte Visão geral do faturamento |
Tipos de migração
-
Migração completa de dados: migra todos os dados históricos dos objetos de migração selecionados do banco de dados MongoDB de origem para o banco de dados MongoDB de destino.
NotaHá suporte para a migração de bancos de dados, coleções e índices.
-
Migração incremental de dados: após a migração completa, sincroniza as atualizações incrementais de dados do banco de dados MongoDB de origem para o banco de dados MongoDB de destino.
NotaHá suporte para a sincronização de operações de criação e exclusão em bancos de dados, coleções e índices.
Há suporte para a sincronização de operações de criação, exclusão e atualização em documentos.
Permissões necessárias para contas de banco de dados
|
Banco de dados |
Permissão necessária |
|
MongoDB autogerenciado (origem) |
|
|
ApsaraDB for MongoDB (destino) |
|
Crie contas e conceda permissões:
MongoDB autogerenciado: consulte a documentação de criação de usuário do MongoDB
ApsaraDB for MongoDB: consulte Gerencie usuários de banco de dados MongoDB usando o DMS
Migrar o banco de dados
Etapa 1: Abrir a página Data Migration
acesse a lista de tarefas de migração usando um destes pontos de entrada:
Pelo console do DTS
Faça login no console do Data Transmission Service (DTS).
No painel de navegação à esquerda, clique em Data Migration.
No canto superior esquerdo, selecione a região onde a instância de migração estará localizada.
Pelo console do DMS
Nota
As operações reais podem variar com base no modo e no layout do console do DMS. Para mais informações, consulte Console do modo simples e Personalizar o layout e o estilo do console do DMS.
Faça login no console do Data Management (DMS).
Na barra de menu superior, escolha Data + AI > Data Transmission (DTS) > Data Migration.
À direita de Data Migration Tasks, selecione a região de destino.
Etapa 2: Criar uma tarefa de migração
clique em Create Task para abrir a página de configuração da tarefa.
Etapa 3: Configurar os bancos de dados de origem e de destino
Após selecionar as instâncias de origem e de destino, leia atentamente os limites exibidos na parte superior da página. Ignorar esta etapa pode causar falha na tarefa ou resultar em inconsistência de dados.
configure o banco de dados de origem:
|
Parâmetro |
Valor |
|
Database type |
NoSQL Database > MongoDB |
|
Access method |
selecione com base no local de implantação do banco de dados de origem. Este guia usa Public IP Address como exemplo. Se você selecionar um método de acesso diferente, conclua primeiro os preparativos correspondentes |
|
Instance region |
selecione a região onde o banco de dados MongoDB de origem está localizado. Se a região não estiver listada, selecione a região geograficamente mais próxima |
|
Architecture |
Replica Set |
|
Migration method |
selecione o método de migração incremental de dados: Oplog (recomendado quando o oplog está ativado — menor latência, recuperação de logs mais rápida) ou ChangeStreamChange Streams (quando os change streams estão ativados). Se a origem for o Amazon DocumentDB (cluster não elástico), use apenas o ChangeStream |
|
Endpoint type |
Standalone. Este campo aparece apenas quando o Access method é Express Connect, VPN Gateway, or Smart Access Gateway, Public IP Address ou Cloud Enterprise Network (CEN) |
|
Domain name or IP |
O nome de domínio ou o endereço ip público do banco de dados MongoDB de origem |
|
Port number |
A porta de serviço do banco de dados MongoDB de origem |
|
Authentication database |
O banco de dados ao qual a conta de origem pertence. O padrão é |
|
Database account |
A conta do nó Mongos. Para acesso via Self-managed Database on ECS ou Database Gateway, insira a conta do nó shard |
|
Database password |
A senha da conta do banco de dados |
|
Encryption |
Non-encrypted, SSL-encrypted ou Mongo Atlas SSL. As opções disponíveis dependem do Access method e da Architecture selecionados. O Sharded Cluster com Oplog não oferece suporte para SSL-encrypted. Se estiver usando Replica Set com um método de acesso fora da Alibaba Cloud e SSL-encrypted, você pode fazer upload de um certificado CA |
configure o banco de dados de destino:
|
Parâmetro |
Valor |
|
Database type |
MongoDB |
|
Access method |
Alibaba Cloud Instance |
|
Instance region |
A região onde a instância de destino do ApsaraDB for MongoDB está localizada |
|
Replicate data across Alibaba Cloud accounts |
No (para migrações dentro da mesma conta) |
|
Architecture |
A arquitetura da instância de destino do ApsaraDB for MongoDB |
|
Instance ID |
O ID da instância de destino do ApsaraDB for MongoDB |
|
Authentication database |
O banco de dados ao qual a conta de destino pertence. O padrão é |
|
Database name |
O nome do banco de dados na instância de destino que receberá os dados migrados |
|
Database account |
A conta da instância de destino do ApsaraDB for MongoDB |
|
Database password |
A senha da conta do banco de dados |
|
Encryption |
Non-encrypted, SSL-encrypted ou Mongo Atlas SSL. As opções disponíveis dependem do Access method e da Architecture. O Sharded Cluster não oferece suporte para SSL-encrypted |
Etapa 4: Testar a conectividade
clique em Test Connectivity and Proceed. Na caixa de diálogo CIDR Blocks of DTS Servers, clique em Test Connectivity.
Os intervalos de endereços ip dos servidores DTS devem ser adicionados às configurações de segurança (lista de permissões) dos bancos de dados de origem e de destino antes que a conectividade possa ser estabelecida com sucesso.
Etapa 5: Configure objetos para migração
Na página Configure Objects, defina o seguinte:
| Configuração | Descrição |
|---|---|
| Migration types | selecione Schema Migration e Full Data Migration |
| Processing mode of conflicting tables | Precheck and Report Errors: verifique se há coleções com o mesmo nome no destino. Relata um erro durante a pré-verificação se existirem conflitos e a tarefa não é iniciada. Use o mapeamento de nomes de objetos para resolver conflitos sem que você exclua a coleção de destino. Ignore Errors and Proceed: ignora a verificação. Aviso
Selecione esta opção pode causar inconsistência de dados. Se um documento de destino tiver a mesma chave primária que um documento de origem, o registro de destino é mantido e o registro de origem não é migrado |
| Capitalization of object names in destination instance | Configura a sensibilidade a maiúsculas e minúsculas para os nomes dos objetos migrados (bancos de dados, coleções). O padrão é DTS default policy. Consulte Sensibilidade a maiúsculas e minúsculas de nomes de objetos no banco de dados de destino |
| Source objects | Clique em bancos de dados ou coleções a serem migrados e, em seguida, clique em  para movê-los para Selected Objects. selecione no nível do banco de dados ou da coleção |
| Selected objects | Para renomear um objeto de migração no destino, clique em ele com o botão direito em Selected Objects e configure o mapeamento. Para remover um objeto, clique em ele e, em seguida, clique em  . Para filtrar dados por condição, clique em uma coleção com o botão direito e configure o filtro. Consulte Defina condições de filtro. Se o mapeamento de nomes de objetos for usado, objetos dependentes podem falhar na migração |
Etapa 6: Configure as configurações avançadas
clique em Next: Advanced Settings e configure os seguintes parâmetros:
|
Configuração |
Descrição |
|
Dedicated cluster for task scheduling |
Por padrão, o DTS agenda tarefas em um cluster compartilhado. Para usar um cluster dedicado, compre um primeiro. Consulte O que é um cluster dedicado do DTS? |
|
Retry time for failed connections |
Por quanto tempo o DTS tenta novamente após uma falha de conexão. Padrão: 720 minutos. Intervalo: 10 a 1440 minutos. defina para mais de 30 minutos. Se o DTS reconectar dentro desta janela, a tarefa será retomada automaticamente. Nota: o DTS cobra durante o período de nova tentativa — defina isso com base em suas necessidades e libere a instância do DTS prontamente após a liberação das instâncias de origem e de destino |
|
Retry time for other issues |
Por quanto tempo o DTS tenta novamente após erros que não sejam de conectividade (como falhas de execução de DDL ou DML). Padrão: 10 minutos. Intervalo: 1 a 1440 minutos. defina para mais de 10 minutos. Deve ser menor que o Retry time for failed connections |
|
Enable throttling for full data migration |
Limita as consultas por segundo (QPS) para a origem, o RPS da Migração Completa de Dados e a velocidade de migração de dados (MB/s). Disponível apenas quando a Full Data Migration está selecionada. Você também pode ajustar o limitador após o início da tarefa |
|
Only one data type for primary key _id in a table of the data to be synchronized |
Especifica se o campo |
|
Environment tag |
Opcional. Adicione uma tag à instância para identificação |
|
Configure ETL |
ative o recurso de extração, transformação e carga (ETL) e insira instruções de processamento de dados, ou desative-o. Consulte O que é ETL? e Configure ETL em uma tarefa de migração ou sincronização de dados |
|
Monitoring and alerting |
defina um limiar de alerta e contatos de notificação. Quando uma migração falhar ou a latência exceder o limiar, um alerta será enviado |
Etapa 7: Configure a validação de dados
clique em Next: Data Validation para configurar opcionalmente uma tarefa de validação de dados. Consulte Configure validação de dados.
Etapa 8: Executar a pré-verificação
clique em Next: Save Task Settings and Precheck.
visualize os parâmetros da API para esta configuração, passe o mouse sobre o botão e clique em Preview OpenAPI parameters .
O DTS executa uma pré-verificação antes do início da migração. A tarefa só começa após a aprovação na pré-verificação.
Se a pré-verificação falhar, clique em View Details ao lado do item com falha, corrija o problema e execute a pré-verificação novamente.
-
Se um aviso for exibido:
Para itens não ignoráveis, clique em View Details, corrija o problema e execute a pré-verificação novamente.
Para itens ignoráveis, clique em Confirm Alert Details > Ignore > OK > Precheck Again. Avisos ignorados podem levar à inconsistência de dados.
Etapa 9: Comprar a instância
Quando a Success Rate atingir 100%, clique em Next: Purchase Instance.
-
Na página Purchase, selecione a classe da instância (especificação do link). A classe da instância afeta a velocidade da migração. Consulte Especificações de link de migração de dados.
Parâmetro
Descrição
Resource group settings
selecione o grupo de recursos para esta instância. O padrão é o grupo de recursos padrão. Consulte O que é o Resource Management?
Instance class
selecione uma especificação com base na velocidade de migração necessária
Leia e aceite os Data Transmission Service (Pay-as-you-go) Service Terms.
clique em Purchase And Start e, em seguida, clique em OK na caixa de diálogo de confirmação.
Verificar a migração
Após o início da tarefa, acesse a página Data Migration Tasks para monitorar o progresso. A página exibe o status atual da migração e a porcentagem de conclusão.
Próximos passos
Migração e sincronização de dados — explore outras opções de migração e sincronização
Versões e mecanismos de armazenamento — entenda a compatibilidade de versões e mecanismos de armazenamento