

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á.

# Migração para o Amazon DocumentDB usando o AWS Database Migration Service (DMS): guia de início rápido
<a name="migration-quick-start"></a>

**Topics**
+ [Preparação do arquivo de origem](#migrate-qs-dma-source)
+ [Configuração do DMS](#migrate-qs-dms-setup)
+ [Habilitação da compactação do DocumentDB](#migrate-qs-comp)
+ [Criação de uma tarefa de replicação](#migrate-qs-create)
+ [Monitorar o andamento](#migrate-qs-monitor)
+ [Mais informações](#migrate-qs-info)

## Preparação do arquivo de origem
<a name="migrate-qs-dma-source"></a>

Consulte [Ativar fluxos de alterações](change_streams.md#change_streams-enabling) para habilitar fluxos de alterações do DocumentDB ou para habilitar o MongoDB Oplog para oferecer suporte à captura de dados de alteração (CDC) do DMS.
+ A fonte do DMS deve reter todas as alterações em andamento até que a carga total do DMS seja concluída para todas as coleções incluídas.
+ Os fluxos de alterações do DocumentDB são baseados no tempo. Certifique-se de que sua configuração `change_stream_log_retention_duration` seja grande o suficiente para cobrir o tempo necessário para concluir a carga completa.
+ O MongoDB Oplog tem um tamanho fixo. Certifique-se de que ele seja dimensionado para comportar todas as operações durante a carga total.

## Configuração do DMS
<a name="migrate-qs-dms-setup"></a>

Crie endpoints de instância, origem e destino do DMS e teste cada endpoint.

## Habilitação da compactação do DocumentDB
<a name="migrate-qs-comp"></a>

Habilite a compactação anexando um grupo de parâmetros personalizado ao seu cluster do DocumentDB e atualizando o parâmetro default\$1collection\$1compression para habilitado. Consulte [Gerenciamento da compactação de documentos a nível de coleção](doc-compression.md) para obter mais informações.

## Criação de uma tarefa de replicação
<a name="migrate-qs-create"></a>

1. No console do DMS, no painel de navegação, escolha **Migrar ou replicar** e, em seguida, escolha **Tarefas**.

1. Escolha **Criar tarefa**.

1. Na página **Criar tarefa**, na seção **Configuração da tarefa**:
   + Insira um **Identificador de tarefa** exclusivo e significativo (por exemplo, “mongodb-docdb-replication”).
   + Escolha o endpoint de origem que você criou anteriormente no menu suspenso **Endpoint de banco de dados de origem**.
   + Escolha o endpoint de destino que você criou anteriormente no menu suspenso **Endpoint de banco de dados de destino**.
   + Em **Tipo de tarefa**, escolha **Migrar e replicar**.

1. Na seção **Configurações**:
   + Em **Logs de tarefas**, marque a caixa **Ativar logs do CloudWatch**.
   + Em **Modo de edição** (na parte superior da seção), escolha **Editor JSON** e defina os atributos a seguir:
     + Defina `ParallelApplyThreads` como 5 (em `TargetMetadata`). Isso permite aproximadamente 1000 operações de inserção/atualização/exclusão por segundo no CDC.
     + Defina `MaxFullLoadSubTasks` como 16 (em `FullLoadSettings`). Considere aumentar isso dependendo do tamanho da sua instância.
     + Para coleções grandes (acima de 100 GB), habilite a partição automática (em Mapeamento de tabelas e sob o atributo `parallel-load`):
       + "type": "partitions-auto"
       + "number-of-partitions": 16

## Monitorar o andamento
<a name="migrate-qs-monitor"></a>

Use o console do AWS DMS ou crie um painel personalizado ([ferramenta de painel](https://github.com/awslabs/amazon-documentdb-tools/tree/master/monitoring/docdb-dashboarder)) para rastrear a migração. Concentre-se nas métricas a seguir:
+ **FullloadThroughputBandwidthTarget**: mede a largura de banda da rede (em KB/segundo) usada pelo DMS ao transferir dados para o banco de dados de destino durante a fase de carga total da migração.
+ **CDCLatencyTarget**: mede o tempo de atraso (em segundos) entre a ocorrência de uma alteração no banco de dados de origem e o momento em que essa alteração é aplicada ao banco de dados de destino.
+ **CDCThroughputRowsTarget**: mede o número de linhas por segundo que o DMS está aplicando ao banco de dados de destino durante a fase de replicação contínua da migração.

## Mais informações
<a name="migrate-qs-info"></a>

Para obter mais informações sobre o Amazon DocumentDB e o AWS DMS, consulte para obter mais informações.
+ [Runbook de migração do Amazon DocumentDB](docdb-migration-runbook.md)
+ [Migração do MongoDB para o Amazon DocumentDB](https://docs.aws.amazon.com/dms/latest/sbs/chap-mongodb2documentdb.html)