Use o Data Transmission Service (DTS) para migrar totalmente os dados de um banco de dados MongoDB standalone para uma instância do MongoDB de qualquer arquitetura.
Bancos de dados de origem e de destino suportados
|
Banco de dados de origem |
Banco de dados de destino |
|
ApsaraDB for MongoDB |
ApsaraDB for MongoDB |
|
Banco de dados autogerenciado em uma instância ECS |
Banco de dados autogerenciado em uma instância ECS |
|
Banco de dados autogerenciado conectado via Express Connect, VPN Gateway ou Smart Access Gateway |
Banco de dados autogerenciado conectado via Express Connect, VPN Gateway ou Smart Access Gateway |
|
Banco de dados autogerenciado com um endereço IP público |
Banco de dados autogerenciado com um endereço IP público |
Este exemplo demonstra a migração de uma instância standalone do ApsaraDB for MongoDB para uma instância do ApsaraDB for MongoDB de qualquer arquitetura.
Pré-requisitos
-
Você criou a instância standalone do ApsaraDB for MongoDB de origem e a instância do ApsaraDB for MongoDB de destino. Para mais informações, consulte crie uma instância standalone, crie uma instância de conjunto de réplicas e crie uma instância de cluster fragmentado.
NotaPara obter informações sobre as versões suportadas, consulte Migration solutions.
A instância do ApsaraDB for MongoDB de destino deve ter pelo menos 10% a mais de espaço de armazenamento do que o utilizado pela instância do ApsaraDB for MongoDB de origem.
-
Se a instância do ApsaraDB for MongoDB de destino usar uma arquitetura de cluster com sharding, crie os bancos de dados e as coleções a serem fragmentados, configure o sharding, ative o balanceador e execute o pré-sharding na instância do ApsaraDB for MongoDB de destino de acordo com os requisitos do seu negócio. Para mais informações, consulte Configure sharding to maximize shard performance e How do I handle uneven data distribution in a MongoDB sharded cluster?.
NotaConfigurar o sharding impede que todos os dados sejam migrados para um único shard, o que degradaria o desempenho do cluster. Ativar o balanceador e executar o pré-sharding ajuda a evitar a distorção de dados.
Limitações
Tipo | Descrição |
Limitações do banco de dados de origem |
|
Outras limitações |
|
Caso especial | Se a origem for um banco de dados MongoDB autogerenciado, um failover primário/secundário durante a migração causará a falha da tarefa. |
Faturamento
|
Tipo de migração |
Taxa de configuração da instância |
Taxa de tráfego de Internet |
|
Migração de esquema e migração total de dados |
Gratuito. |
Quando o parâmetro Access Method do banco de dados de destino está definido como Public IP Address, você é cobrado pelo tráfego de Internet. Para mais informações, consulte Billing overview. |
Tipos de migração
|
Tipo de migração |
Descrição |
|
Migração de esquema |
Migra esquemas de objetos da instância do ApsaraDB for MongoDB de origem para a instância do ApsaraDB for MongoDB de destino. Nota
O DTS suporta migração de esquema para objetos DATABASE, COLLECTION e INDEX. |
|
Migração total de dados |
Migra todos os dados existentes da instância do ApsaraDB for MongoDB de origem para a instância do ApsaraDB for MongoDB de destino. Nota
O DTS suporta migração total de dados para dados em objetos DATABASE e COLLECTION. |
Permissões necessárias para contas de banco de dados
|
Banco de dados |
Migração de esquema |
Migração total de dados |
|
Instância do ApsaraDB for MongoDB de origem |
A permissão de leitura nos bancos de dados a serem migrados e no banco de dados config. |
|
|
Instância do ApsaraDB for MongoDB de destino |
A permissão dbAdminAnyDatabase, a permissão readWrite nos bancos de dados de destino e a permissão de leitura no banco de dados local. |
|
Para obter informações sobre como criar e autorizar uma conta de banco de dados para uma instância do ApsaraDB for MongoDB, consulte gerencie usuários de banco de dados MongoDB no DMS.
Procedimento
-
Para começar, acesse a página da lista de tarefas de migração para a região de destino usando um dos seguintes métodos.
A partir do console do DTS
Faça login no Data Transmission Service (DTS) console.
No painel de navegação à esquerda, clique em Data Migration.
No canto superior esquerdo da página, selecione a região onde a instância de migração está localizada.
A partir do console do DMS
NotaAs operações reais podem variar com base no modo e no layout do console do DMS. Para mais informações, consulte Simple mode console e Customize the layout and style of the DMS console.
Faça login no Data Management (DMS) console.
Na barra de menu superior, escolha .
À direita de Data Migration Tasks, selecione a região onde a instância de migração está localizada.
Clique em Create Task para acessar a página de configuração da tarefa.
-
Configure os bancos de dados de origem e de destino.
AvisoApós selecionar as instâncias de origem e de destino, recomendamos que você leia atentamente os limites exibidos na parte superior da página. Caso contrário, a tarefa poderá falhar ou poderá ocorrer inconsistência de dados.
Seção
Parâmetro
Descrição
N/D
Task Name
O DTS gera automaticamente um nome de tarefa. Recomendamos que você especifique um nome descritivo para facilitar a identificação. O nome não precisa ser exclusivo.
Source Database
Select Existing Connection
Para usar uma instância de banco de dados que foi added to the system (criada ou salva), selecione a instância de banco de dados desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente.
NotaNo console do DMS, este parâmetro é nomeado como Select a DMS database instance..
Se você não registrou a instância do banco de dados no sistema, ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
Database Type
Selecione MongoDB.
Access Method
Selecione Cloud instance.
Instance Region
Selecione a região onde a instância do ApsaraDB for MongoDB de origem reside.
Replicate Data Across Alibaba Cloud Accounts
Neste exemplo, é usada uma instância de banco de dados sob a conta atual da Alibaba Cloud. Selecione No.
Architecture
Embora a origem seja uma instância standalone, selecione Replica Set para a configuração de Architecture.
-
Replica Set: fornece alta disponibilidade e divisão de leitura/gravação através da implantação de vários tipos de nós. Para mais informações, consulte Replica set architecture.
-
Sharded Cluster: consiste nos componentes mongos, shard e ConfigServer. Você pode personalizar o número e as configurações dos nós mongos e shard. Para mais informações, consulte Sharded cluster architecture.
Migration Method
Uma instância de origem standalone não suporta migração incremental. Deixe o Migration Method definido como o padrão, Oplog, pois essa configuração é exigida pelo DTS mesmo para origens standalone.
Instance ID
Selecione o ID da instância do ApsaraDB for MongoDB de origem.
Authentication Database
Por favor, insira o nome do banco de dados de autenticação para a instância do ApsaraDB for MongoDB de origem. O padrão é admin.
Database Account
Por favor, insira a conta do banco de dados da instância do ApsaraDB for MongoDB de origem. Para requisitos de permissão, consulte Permissions required for database accounts.
Database Password
Por favor, insira a senha da conta do banco de dados.
Encryption
O DTS suporta três métodos de conexão: Non-encrypted, SSL-encrypted e Mongo Atlas SSL. As opções de Encryption variam com base no Access Method e na Architecture selecionados. As opções exibidas no console prevalecem.
Nota-
Um banco de dados MongoDB onde a Architecture é Sharded Cluster e o Migration Method é Oplog não suporta SSL-encrypted.
-
Se a origem for um banco de dados MongoDB autogerenciado (o Access Method não é Alibaba Cloud Instance) com uma arquitetura Replica Set, e você selecionar SSL-encrypted, o DTS também permitirá que você faça upload de um certificado CA e verifique a conexão.
Destination Database
Select Existing Connection
Para usar uma instância de banco de dados que foi added to the system (criada ou salva), selecione a instância de banco de dados desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente.
NotaNo console do DMS, este parâmetro é nomeado como Select a DMS database instance..
Se você não registrou a instância do banco de dados no sistema, ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
Database Type
Selecione MongoDB.
Access Method
Selecione Cloud instance.
Instance Region
Selecione a região onde a instância do ApsaraDB for MongoDB de destino reside.
Replicate Data Across Alibaba Cloud Accounts
Neste exemplo, é usada uma instância de banco de dados sob a conta atual da Alibaba Cloud. Selecione No.
Architecture
Selecione uma arquitetura com base nos requisitos do seu negócio:
-
Replica Set: fornece alta disponibilidade e divisão de leitura/gravação através da implantação de vários tipos de nós. Para mais informações, consulte Replica set architecture.
-
Sharded Cluster: consiste nos componentes mongos, shard e ConfigServer. Você pode personalizar o número e as configurações dos nós mongos e shard. Para mais informações, consulte Sharded cluster architecture.
Instance ID
Selecione o ID da instância do ApsaraDB for MongoDB de destino.
Authentication Database
Por favor, insira o nome do banco de dados de autenticação para a instância do ApsaraDB for MongoDB de destino. O padrão é admin.
Database Account
Por favor, insira a conta do banco de dados da instância do ApsaraDB for MongoDB de destino. Para requisitos de permissão, consulte Permissions required for database accounts.
Database Password
Por favor, insira a senha da conta do banco de dados.
Encryption
O DTS suporta três métodos de conexão: Non-encrypted, SSL-encrypted e Mongo Atlas SSL. As opções de Encryption variam com base no Access Method e na Architecture selecionados. As opções exibidas no console prevalecem.
Nota-
Bancos de dados MongoDB com uma Architecture de Sharded Cluster não suportam SSL-encrypted.
-
Se o destino for um banco de dados MongoDB autogerenciado (o Access Method não é Alibaba Cloud Instance) com um Replica Set, e você selecionar SSL-encrypted, o DTS também permitirá que você faça upload de um certificado CA e verifique a conexão.
-
Após concluir a configuração, clique em Test Connectivity and Proceed na parte inferior da página.
NotaCertifique-se de que o segmento de endereço IP do service DTS seja adicionado automática ou manualmente às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso a partir dos servidores do DTS. Para mais informações, consulte Add DTS server IP addresses to a whitelist.
Se o banco de dados de origem ou de destino for um banco de dados autogerenciado (o Access Method não é Alibaba Cloud Instance), você também deve clicar em Test Connectivity na caixa de diálogo CIDR Blocks of DTS Servers que aparece.
-
Configure os objetos da tarefa.
-
Na página Configure Objects, configure os objetos que você deseja migrar.
Parâmetro
Descrição
Migration Types
Selecione tanto Schema Migration quanto Full Data Migration.
NotaEste cenário não suporta migração incremental. Para garantir a consistência dos dados, não grave novos dados na instância de origem durante a migração de dados.
Para mais informações, consulte Migration types.
Processing Mode of Conflicting Tables
Precheck and Report Errors: verifica se existem coleções com os mesmos nomes no banco de dados de destino. Se não existirem coleções com os mesmos nomes, a pré-verificação é aprovada. Se existirem coleções com os mesmos nomes, um erro é relatado durante a pré-verificação e a tarefa de migração de dados não é iniciada.
NotaSe uma coleção no banco de dados de destino tiver o mesmo nome, mas não puder ser facilmente excluída ou renomeada, você poderá alterar o nome da coleção no banco de dados de destino. Para mais informações, consulte Object name mapping.
Ignore Errors and Proceed: ignora a verificação de coleções com os mesmos nomes.
AvisoSelecionar Ignore Errors and Proceed pode causar inconsistência de dados e riscos ao negócio. Por exemplo:
Se um registro no banco de dados de destino tiver o mesmo valor de chave primária que um registro no banco de dados de origem, o registro no banco de dados de destino será mantido. O registro do banco de dados de origem não será migrado para o banco de dados de destino.
A inicialização de dados pode falhar, apenas alguns dados podem ser migrados ou a migração pode falhar.
Capitalization of Object Names in Destination Instance
Configure a diferenciação de maiúsculas e minúsculas dos nomes de bancos de dados e coleções na instância de destino. Por padrão, DTS default policy está selecionado. Você também pode alinhar com a política padrão da origem ou do destino. Para mais informações, consulte Case sensitivity of object names in the destination instance.
Source Objects
Na caixa Source Objects, clique nos objetos a serem migrados e, em seguida, clique em
para movê-los para a caixa Selected Objects.NotaSelecione objetos no nível do banco de dados ou da coleção.
Selected Objects
Para definir o nome de um objeto de migração na instância de destino, ou para especificar o objeto que recebe dados na instância de destino, clique com o botão direito do mouse no objeto de migração na caixa Selected Objects para fazer alterações. Para mais informações, consulte Object name mapping.
Para remover um objeto de migração selecionado, clique no objeto na caixa Selected Objects e, em seguida, clique em
para movê-lo para a caixa Source Objects.
Nota-
Para filtrar dados com base em condições, o que é suportado durante a migração total de dados, clique com o botão direito do mouse em uma coleção na caixa Selected Objects e configure o filtro na caixa de diálogo que aparece. Para mais informações, consulte Set filter conditions.
-
Redirecionar um banco de dados ou coleção com mapeamento de nome de objeto pode causar falha em objetos dependentes durante a migração.
-
Clique em Next: Advanced Settings para configurar parâmetros avançados.
Parâmetro
Descrição
Dedicated Cluster for Task Scheduling
Por padrão, o DTS agenda tarefas em um cluster compartilhado. Você não precisa selecionar um. Se desejar tarefas mais estáveis, você pode comprar um dedicated cluster para executar tarefas de migração do DTS.
Retry Time for Failed Connections
Após o início da tarefa de migração, se a conexão com o banco de dados de origem ou de destino falhar, o DTS relatará um erro e começará imediatamente a tentar reconectar. A duração padrão de nova tentativa é de 720 minutos. Você pode personalizar o tempo de nova tentativa para um valor de 10 a 1440 minutos. Recomendamos que você defina a duração para mais de 30 minutos. Se o DTS reconectar aos bancos de dados de origem e de destino dentro da duração especificada, a tarefa de migração será retomada automaticamente. Caso contrário, a tarefa falhará.
NotaPara várias instâncias do DTS que compartilham a mesma origem ou destino, o tempo de nova tentativa de rede é determinado pela configuração da última tarefa criada.
Como você é cobrado pela tarefa durante o período de nova tentativa de conexão, recomendamos que você personalize o tempo de nova tentativa com base nas necessidades do seu negócio, ou libere a instância do DTS o mais rápido possível após as instâncias de banco de dados de origem e de destino serem liberadas.
Retry Time for Other Issues
Após o início da tarefa de migração, se ocorrer um problema não relacionado à conectividade, como uma exceção de execução DDL ou DML, no banco de dados de origem ou de destino, o DTS relatará um erro e começará imediatamente a tentar repetir a operação. A duração padrão de nova tentativa é de 10 minutos. Você pode personalizar o tempo de nova tentativa para um valor de 1 a 1440 minutos. Recomendamos que você defina a duração para mais de 10 minutos. Se as operações relacionadas forem bem-sucedidas dentro da duração de nova tentativa especificada, a tarefa de migração será retomada automaticamente. Caso contrário, a tarefa falhará.
ImportanteO valor de Retry Time for Other Issues deve ser menor que o valor de Retry Time for Failed Connections.
Enable Throttling for Full Data Migration
Durante a migração total, o DTS consome recursos de leitura e gravação nos bancos de dados de origem e de destino, o que pode aumentar a carga do banco de dados. Se necessário, você pode ativar o limitador para a tarefa de migração total. Você pode definir Queries per second (QPS) to the source database, RPS of Full Data Migration e Data migration speed for full migration (MB/s) para reduzir a carga no banco de dados de destino.
NotaEste item de configuração está disponível apenas se você selecionar Full Data Migration para Migration Types.
Você também pode adjust the full migration speed após a instância de migração estar em execução.
Only one data type for primary key _id in a table of the data to be synchronized
Nos dados a serem migrados, o tipo de dados da chave primária
_idé uniforme dentro de uma única coleção?Importante-
Selecione uma opção com base nos seus requisitos. Caso contrário, poderá ocorrer perda de dados.
-
Este parâmetro está disponível apenas se você selecionar Full Data Migration para Migration Types.
-
Yes: o tipo de dados é único. Durante a migração total de dados, o DTS não verifica os tipos de dados das chaves primárias nos dados de origem. Para uma única coleção, o DTS migra apenas os dados correspondentes a um tipo de dados de chave primária.
-
No: o tipo de dados não é único. Durante a migração total de dados, o DTS verifica os tipos de dados das chaves primárias nos dados de origem e migra todos os dados.
Environment Tag
Opcionalmente, selecione uma tag de ambiente para identificar a instância.
Configure ETL
Com base nas necessidades do seu negócio, selecione se deseja configurar o ETL feature para processar dados.
Yes: configura o recurso ETL. Você também deve inserir data processing statements na caixa de texto.
No: não configura o recurso ETL.
Monitoring and Alerting
Selecione se deseja definir alertas e receber notificações de alerta com base nas necessidades do seu negócio.
No: não define um alerta.
Yes: configure alertas definindo um alert threshold e um notificações de alerta. Se uma migração falhar ou a latência exceder o limiar, o sistema enviará uma notificação de alerta.
-
Clique em Next: Data Validation para configurar uma tarefa de validação de dados.
Para mais informações sobre o recurso de validação de dados, consulte Configure data validation.
-
-
Por favor, salve a tarefa e execute uma pré-verificação.
visualize os parâmetros de configuração desta instância ao chamar a operação da API, movendo o ponteiro sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica que aparece.
Se você não precisar visualizar ou já terminou de visualizar os parâmetros da API, clique em Next: Save Task Settings and Precheck na parte inferior da página.
NotaAntes do início da tarefa de migração, o DTS executa uma pré-verificação. A tarefa só é iniciada após ser aprovada na pré-verificação.
Se a pré-verificação falhar, clique em View Details ao lado do item de verificação com falha, corrija o problema com base no aviso e, em seguida, execute a pré-verificação novamente.
-
Se um aviso for relatado durante a pré-verificação:
Para itens de verificação que não podem ser ignorados, clique em View Details ao lado do item com falha, corrija o problema com base no aviso e, em seguida, execute a pré-verificação novamente.
Para itens de verificação que podem ser ignorados, você pode clicar em Confirm Alert Details, Ignore, OK e Precheck Again para pular o item de alerta e executar a pré-verificação novamente. Se você optar por ignorar um aviso, isso poderá causar problemas como inconsistência de dados e representar riscos para o seu negócio.
-
Compre a instância.
Quando a Success Rate for 100%, clique em Next: Purchase Instance.
-
Na página Purchase, selecione a especificação de link para a instância de migração de dados. Para mais informações, consulte a tabela a seguir.
Categoria
Parâmetro
Descrição
New Instance Class
Resource Group Settings
Selecione o grupo de recursos ao qual a instância pertence. O valor padrão é default resource group. Para mais informações, consulte What is resource management?
Instance Class
O DTS fornece especificações de migração com diferentes níveis de desempenho. A especificação do link afeta a velocidade da migração. Você pode selecionar uma especificação com base no cenário do seu negócio. Para mais informações, consulte Data migration link specifications.
Após concluir a configuração, leia e selecione Data Transmission Service (Pay-as-you-go) Service Terms.
-
Clique em Buy and Start. Na caixa de diálogo OK que aparece, clique em OK.
Você pode visualizar o progresso da tarefa de migração na página de lista Data Migration Tasks.
NotaSe a tarefa de migração não incluir migração incremental, ela será interrompida automaticamente após a conclusão da migração total. Após a interrupção da tarefa, seu Status muda para Completed.
Se a tarefa de migração incluir migração incremental, ela não será interrompida automaticamente. A tarefa de migração incremental continua em execução. Enquanto a tarefa de migração incremental estiver em execução, o Status da tarefa será Running.