View a markdown version of this page

Usando um banco de dados compatível com MongoDB como fonte para migrações de dados homogêneas no AWS DMS - AWS Database Migration Service
Usar o MongoDB autogerenciado como origemUtilizar o Amazon DocumentDB como origemUtilizar o MongoDB como origem: RecursosUtilizar o MongoDB como origem: LimitaçõesUtilizar o MongoDB como origem: Práticas recomendadas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando um banco de dados compatível com MongoDB como fonte para migrações de dados homogêneas no AWS DMS

Você pode usar um MongoDB-compatible banco de dados como fonte para migrações de dados homogêneas no. AWS DMS Nesse caso, o provedor de dados de origem pode ser um banco de dados do Amazon EC2 para MongoDB on-premises ou um banco de dados do Amazon DocumentDB (compatível com MongoDB).

Para ver as versões de banco de dados compatíveis, consulte Provedores de dados de origem para migrações de dados homogêneas do DMS.

As seções a seguir descrevem os pré-requisitos específicos de configuração para bancos de dados MongoDB autogerenciados e AWS bancos de dados Amazon DocumentDB gerenciados.

Usando um banco de dados MongoDB autogerenciado como fonte para migrações de dados homogêneas no AWS DMS

Esta seção descreve como configurar os bancos de dados MongoDB hospedados on-premises ou em instâncias do Amazon EC2.

Verifique a versão do banco de dados MongoDB de origem. Certifique-se de que seja AWS DMS compatível com sua versão de banco de dados MongoDB de origem, conforme descrito em. Provedores de dados de origem para migrações de dados homogêneas do DMS

Para migrações de dados homogêneas com o MongoDB como origem, é possível criar uma conta de usuário com privilégios de raiz ou um usuário com permissões para migração somente no banco de dados. Para ter mais informações sobre criação de usuários, consulte Permissões necessárias ao usar o MongoDB como fonte para AWS DMS.

Para usar a replicação contínua ou CDC com o MongoDB, é AWS DMS necessário acesso ao log de operações do MongoDB (oplog). Para obter mais informações, consulte Configurar um conjunto de réplicas do MongoDB para a CDC.

Para ter informações sobre os métodos de autenticação do MongoDB, consulte Requisitos de segurança ao usar o MongoDB como fonte para AWS DMS.

Para o MongoDB como origem, as migrações de dados homogêneas são compatíveis com todos os tipos de dados compatíveis com o Amazon DocumentDB.

Para o MongoDB como origem, para armazenar as credenciais do usuário no Secrets Manager, você precisa fornecê-las em texto simples, usando segredos do tipo Outro. Para obter mais informações, consulte Usando segredos para acessar AWS Database Migration Service endpoints.

O exemplo de código a seguir demonstra como armazenar os segredos do banco de dados usando texto simples.

{
  "username": "dbuser",
  "password": "dbpassword"
}

Usando um banco de dados Amazon DocumentDB como fonte para migrações de dados homogêneas em AWS DMS

Esta seção descreve como configurar as instâncias do banco de dados Amazon DocumentDB para utilizá-lo como origem para migrações de dados homogêneas.

Use o nome de usuário principal da instância do Amazon DocumentDB como conta de usuário do provedor de dados de MongoDB-compatible origem para migrações de dados homogêneas em. AWS DMS A conta de usuário mestra tem as funções necessárias para permitir a configuração da captura de dados de alteração (CDC). Se você utilizar uma conta diferente da conta de usuário mestre, esta deverá ter o perfil raiz. Para ter mais informações sobre criação de usuários como conta raiz, consulte Definir permissões para utilizar o Amazon DocumentDB como origem.

Para ativar a replicação lógica, defina o parâmetro change_stream_log_retention_duration no grupo de parâmetros do banco de dados como uma configuração adequada à workload da transação. Para que a alteração desse parâmetro estático entre em vigor, é necessária a reinicialização da instância de banco de dados. Antes de iniciar a migração de dados para todos os tipos de tarefas, inclusive as somente de carga máxima, habilite os fluxos de alterações do Amazon DocumentDB para todas as coleções em um determinado banco de dados ou apenas para coleções específicas. Para ter mais informações sobre como habilitar os fluxos de alterações do Amazon DocumentDB, consulte Enabling Change Streams no Guia do desenvolvedor do Amazon DocumentDB.

nota

AWS DMS usa o fluxo de alterações do Amazon DocumentDB para capturar as alterações durante a replicação contínua. Se o Amazon DocumentDB eliminar os registros do fluxo de alterações antes de o DMS lê-los, haverá falha nas tarefas. Recomendamos definir o parâmetro change_stream_log_retention_duration para reter as alterações por pelo menos 24 horas.

Para usar o Amazon DocumentDB para uma migração de dados homogênea, armazene as credenciais do usuário no Secrets Manager em Credenciais para o banco de dados Amazon DocumentDB.

Recursos para usar um MongoDB-compatible banco de dados como fonte para migrações de dados homogêneas

  • Você pode migrar todos os índices secundários compatíveis com o Amazon DocumentDB durante a fase de carga máxima.

  • AWS DMS migra coleções em paralelo. As migrações de dados homogêneas calculam segmentos em tempo de execução com base no tamanho médio de cada documento na coleção para obter o máximo desempenho.

  • O DMS pode replicar os índices secundários que você cria na fase CDC. O DMS é compatível com esse recurso no MongoDB versão 6.0.

  • O DMS é compatível com documentos de nível de aninhamento maior que 97.

Limitações para usar um MongoDB-compatible banco de dados como fonte para migrações de dados homogêneas

  • Os documentos não podem ter nomes de campos com o prefixo $.

  • AWS DMS não oferece suporte à migração de coleções de séries temporais.

  • AWS DMS não oferece suporte create a drop eventos rename collection DDL durante a fase CDC.

  • AWS DMS não oferece suporte a tipos de dados inconsistentes na coleção do campo. _id Por exemplo, a coleção não compatível a seguir tem vários tipos de dados para o campo _id.

    rs0 [direct: primary] test> db.collection1.aggregate([
...   {
...     $group: {
...       _id: { $type: "$_id" },
...       count: { $sum: 1 }
...     }
...   }
... ])
[ { _id: 'string', count: 6136 }, { _id: 'objectId', count: 848033 } ]

  • Para CDC-only tarefas, suporta AWS DMS apenas o modo de immediate início.

  • AWS DMS não oferece suporte a documentos com caracteres UTF8 inválidos.

  • AWS DMS não oferece suporte a coleções fragmentadas.

Melhores práticas para usar um MongoDB-compatible banco de dados como fonte para migrações de dados homogêneas

  • Para vários bancos de dados e coleções grandes hospedados na mesma instância do MongoDB, recomendamos que você use regras de seleção para cada banco de dados e coleção para dividir a tarefa entre várias tarefas e projetos de migração de dados. Você pode ajustar suas divisões de bancos de dados e coleções para obter o máximo desempenho.