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 Sem Servidor
**Topics**
+ [Migração de clusters do DocumentDB existentes para a tecnologia sem servidor](#w2aac41c19b5)
+ [Migração do MongoDB para o DocumentDB Sem Servidor](#w2aac41c19b7)
## Migração de clusters do DocumentDB existentes para a tecnologia sem servidor
### Atualização da versão de mecanismo do cluster
Se o cluster provisionado estiver executando uma versão anterior do mecanismo que não ofereça suporte ao DocumentDB Sem Servidor, você precisará primeiro atualizar o cluster para uma versão do mecanismo com suporte. Para obter mais informações, consulte [Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md).
### Migração de um cluster provisionado para o DocumentDB Sem Servidor
Para alternar um cluster provisionado para usar o DocumentDB Sem Servidor, siga estas etapas:
1. Verifique se a versão do mecanismo do cluster provisionado precisa ser atualizada para ser usada com o DocumentDB Sem Servidor. Consulte [Requisitos e limitações do DocumentDB Sem Servidor](docdb-serverless-limitations.md).
**nota**
Se o cluster provisionado estiver executando uma versão do mecanismo que não esteja disponível para o DocumentDB Sem Servidor, atualize a versão do mecanismo do cluster. Consulte [Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md).
1. Defina a configuração de escalabilidade do cluster. Para obter detalhes sobre como escolher a configuração de escalabilidade, consulte [Escolha do intervalo de capacidade de escalabilidade para um cluster do DocumentDB Sem Servidor](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Para modificar a configuração de escalabilidade de um cluster, consulte [Visualização e modificação da configuração do intervalo de capacidade de escalabilidade de um cluster](docdb-serverless-managing.md#docdb-serverless-range-config).
1. Configure todas as outras propriedades do cluster para considerar os requisitos e limitações do DocumentDB Sem Servidor em [Requisitos e limitações do DocumentDB Sem Servidor](docdb-serverless-limitations.md).
1. Adicione uma ou mais instâncias do DocumentDB Sem Servidor ao cluster. Siga o procedimento em [Adição de uma instância do Amazon DocumentDB Sem Servidor](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**nota**
Em alguns casos, talvez você já tenha uma ou mais instâncias do leitor provisionadas no cluster. Se esse for o caso, será possível optar por converter um dos leitores em uma instância do DocumentDB Sem Servidor em vez de criar outra instância. Para fazer isso, siga o procedimento em [Alterar a classe de uma instância](db-instance-classes.md#db-instance-class-changing).
1. (Opcional) Execute uma operação de failover para transformar uma instância do DocumentDB Sem Servidor no gravador do cluster. Consulte [Failover do Amazon DocumentDB](failover.md).
1. (Opcional) Converta todas as instâncias provisionadas restantes do Amazon DocumentDB em instâncias do DocumentDB Sem Servidor (consulte [Alterar a classe de uma instância](db-instance-classes.md#db-instance-class-changing)) ou as remova do cluster (consulte [Excluir uma instância do Amazon DocumentDB](db-instance-delete.md)).
------
#### [ Using the Console de gerenciamento da AWS ]
O exemplo de Console de gerenciamento da AWS configuração a seguir mostra o processo de migração usando um cluster provisionado do Amazon DocumentDB que está executando o Amazon DocumentDB 5.0.0, que não exige um upgrade da versão do mecanismo para começar a usar o DocumentDB sem servidor. O cluster é nomeado como `sample` e começa com três instâncias provisionadas chamadas de `sample`, `sample2` e `sample3`. Neste exemplo, essas três instâncias serão substituídas por três instâncias com tecnologia sem servidor.
1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) e abra o console do Amazon DocumentDB.
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
A tabela **Clusters** será exibida.
1. Na tabela **Clusters**, marque a caixa de seleção do cluster ao qual você deseja adicionar uma instância com tecnologia sem servidor.
1. Escolha **Actions (Ações)** e escolha **Add instances (Adicionar instâncias)**.
1. Na caixa de diálogo **Adicionar instâncias**, selecione **Tecnologia sem servidor** na seção **Classe de instância** de banco de dados para cada nova instância sem servidor que você deseja criar.
1. Em **Configurações de capacidade de tecnologia sem servidor**, defina a configuração de escalabilidade com base na descrição da capacidade na caixa de diálogo.
1. (Opcional) Para adicionar outra instância, escolha **Adicionar instância**. Continue a adicionar instâncias até atingir o número desejado de novas instâncias.
Neste exemplo, três novas instâncias com tecnologia sem servidor são criadas.
1. Escolha **Criar**.
Leva alguns minutos para criar uma instância. Você pode usar o console ou o AWS CLI para ver o status da instância. Para obter mais informações, consulte [Monitoramento do status de cluster do Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
1. Voltando à tabela **Clusters**, marque as caixas de seleção de todas as três instâncias provisionadas originais.
1. Escolha **Ações** e, em seguida, escolha **Excluir**.
Durante a exclusão, uma operação de failover é executada automaticamente para promover uma das instâncias restantes a gravador. Após alguns minutos, o processo de exclusão se concluirá. O cluster existente agora contém três instâncias do DocumentDB Sem Servidor (conforme definido na coluna **Tamanho**).
------
#### [ Using the AWS CLI ]
O exemplo de AWS CLI configuração a seguir mostra o processo de migração usando um cluster provisionado do Amazon DocumentDB que está executando o Amazon DocumentDB 5.0.0, que não exige um upgrade da versão do mecanismo para começar a usar o DocumentDB sem servidor. O cluster é nomeado como `sample` e começa com três instâncias provisionadas chamadas de `sample`, `sample2` e `sample3`. Neste exemplo, essas três instâncias serão substituídas por três instâncias com tecnologia sem servidor. O cluster é chamado de `sample-cluster`, e começa com duas instâncias provisionadas chamadas de `sample-provisioned-instance-1` e `sample-provisioned-instance-2`, uma instância de gravador e uma instâmcia de leitor.
No exemplo a seguir, substitua cada um *user input placeholder* por suas próprias informações ou parâmetros de configuração.
Use a operação `aws docdb describe-db-clusters` para determinar o status de um cluster. O código a seguir descobre o status do cluster `sample-cluster` e exibe os resultados em uma tabela:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Adicione a configuração de escalabilidade do cluster:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
Adicione as instâncias com tecnologia sem servidor. Neste exemplo, novas instâncias com tecnologia sem servidor chamadas de `sample-serverless-instance-1` e `sample-serverless-instance-2` são adicionadas:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-1 \
--db-instance-class db.serverless \
--engine docdb
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-2 \
--db-instance-class db.serverless \
--engine docdb
```
Insira o comando a seguir para esperar que as instâncias com tecnologia sem servidor estejam disponíveis antes de continuar:
```
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-1
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-2
```
Realize uma operação de failover para tornar a nova instância `sample-serverless-instance-1` o gravador do cluster.
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
O failover leva alguns segundos para ser concluído, após o qual sample-serverless-instance -1 se torna o gravador do cluster. Verifique isso com a entrada a seguir:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | False | 1 |
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Para finalizar, exclua as instâncias provisionadas originais:
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## Migração do MongoDB para o DocumentDB Sem Servidor
É possível migrar seus bancos de dados do MongoDB para o DocumentDB Sem Servidor, da mesma forma que com o Amazon DocumentDB provisionado. Para obter mais informações, consulte [Migrar para o Amazon DocumentDB](docdb-migration.md).