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

# Migre para o Amazon DocumentDB usando AWS Serviço de migração de banco de dados (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>

**Amazon DocumentDB 5.0: ** ative a compactação anexando um grupo de parâmetros personalizado ao seu cluster do Amazon DocumentDB e definindo o `default_collection_compression` parâmetro como. `enabled` Consulte [Gerenciamento da compactação de documentos a nível de coleção](doc-compression.md) para obter mais informações.

**Amazon DocumentDB 8.0: a compactação ** Zstd é habilitada por padrão. Consulte [Gerenciando a compactação baseada em dicionário no Amazon DocumentDB 8.0](dict-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**:
   + Para registros de ** tarefas**, marque a caixa ** Ativar CloudWatch ** registros.
   + 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 insert/update de 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 AWS DMS console ou crie um painel personalizado (ferramenta de [ painel](https://github.com/awslabs/amazon-documentdb-tools/tree/master/monitoring/docdb-dashboarder)) para acompanhar a migração. Concentre-se nas métricas a seguir:
+ **FullLoadThroughputBandwidthTarget**— Mede a largura de banda de rede (in KB/second) usada pelo DMS ao transferir dados para o banco de dados de destino durante a fase de carregamento 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 contínua de replicação da migração.

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

Para obter mais informações sobre o Amazon DocumentDB e AWS DMS, consulte:
+ [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)