Migração para o Amazon DocumentDB sem servidor

Migração de clusters DocumentDB existentes para sistemas sem servidor

Atualizando a versão do mecanismo de um cluster

Se o cluster provisionado estiver executando uma versão inferior do mecanismo que não oferece suporte ao DocumentDB serverless, você precisa primeiro atualizar o cluster para uma versão de mecanismo compatível. Para obter mais informações, consulte Atualização da versão principal implementada do Amazon DocumentDB no local.

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 serverless. Consulte Requisitos e limitações do DocumentDB sem servidor.

   nota

   Se o cluster provisionado estiver executando uma versão do mecanismo que não está 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.

2. Defina a configuração de escalabilidade do cluster. Para obter detalhes sobre como escolher a configuração de escalabilidade, consulteEscolhendo a faixa de capacidade de escalabilidade para um cluster sem servidor DocumentDB. Para modificar a configuração de escalabilidade de um cluster, consulteVisualizando e modificando a configuração da faixa de capacidade de escalabilidade de um cluster.

3. Configure todas as outras propriedades do cluster para atender aos requisitos e limitações sem servidor do DocumentDB. Requisitos e limitações do DocumentDB sem servidor

4. Adicione uma ou mais instâncias sem servidor do DocumentDB ao cluster. Siga o procedimento em Adicionar uma instância sem servidor do Amazon DocumentDB.

   nota

   Em alguns casos, talvez você já tenha uma ou mais instâncias de leitura provisionadas no cluster. Nesse caso, você pode optar por converter um dos leitores em uma instância sem servidor do DocumentDB em vez de criar uma nova instância. Para fazer isso, siga o procedimento em Alterar a classe de uma instância.

5. (Opcional) Execute uma operação de failover para transformar uma instância sem servidor do DocumentDB na gravadora do cluster. Consulte Failover do Amazon DocumentDB.

6. (Opcional) Converta todas as instâncias provisionadas restantes do Amazon DocumentDB em instâncias sem servidor do DocumentDB (Alterar a classe de uma instânciaconsulte) ou remova-as do cluster (consulte). Excluir uma instância do Amazon DocumentDB

Using the AWS Management Console

O exemplo de AWS Management Console 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 sample e começa com três instâncias provisionadas chamadas samplesample2, e. sample3 Neste exemplo, essas três instâncias serão substituídas por três instâncias sem servidor.

1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB.

2. 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 () no canto superior esquerdo da página.

   A tabela Clusters é exibida.

3. Na tabela Clusters, marque a caixa de seleção do cluster ao qual você deseja adicionar uma instância sem servidor.

4. Escolha Actions (Ações) e escolha Add instances (Adicionar instâncias).

5. Na caixa de diálogo Adicionar instâncias, selecione Sem servidor na seção Classe de instância de banco de dados para cada nova instância sem servidor que você deseja criar.

6. Para configurações de capacidade sem servidor, defina a configuração de escalabilidade com base na descrição da capacidade na caixa de diálogo.

7. (Opcional) Para adicionar outra instância, escolha Adicionar instância. Continue adicionando instâncias até atingir o número desejado de novas instâncias.

   Neste exemplo, três novas instâncias sem servidor são criadas.

8. 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 Monitorando o status de um cluster do Amazon DocumentDB.

9. Voltando à tabela Clusters, marque as caixas de seleção de todas as três instâncias provisionadas originais.

10. Escolha Ações e, em seguida, escolha Excluir.

Durante a exclusão, um failover é executado automaticamente para promover que uma das instâncias restantes seja a gravadora. Depois de alguns minutos, o processo de exclusão é concluído. O cluster existente agora contém três instâncias sem servidor do DocumentDB (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 sample e começa com três instâncias provisionadas chamadas samplesample2, e. sample3 Neste exemplo, essas três instâncias serão substituídas por três instâncias sem servidor. O cluster é nomeado sample-cluster e começa com duas instâncias provisionadas chamadas sample-provisioned-instance-1 esample-provisioned-instance-2, uma instância de gravador e uma instância de leitura.

No exemplo a seguir, substitua cada um user input placeholder por suas próprias informações ou parâmetros de configuração.

Use a aws docdb describe-db-clusters operação para determinar o status de um cluster. O código a seguir encontra o status do cluster sample-cluster e gera 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 para o cluster:

aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16

Adicione as instâncias sem servidor. Neste exemplo, novas instâncias sem servidor nomeadas sample-serverless-instance-1 e sample-serverless-instance-2 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

Digite o seguinte para esperar que as instâncias 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

Execute um failover para tornar a nova sample-serverless-instance-1 instância a gravadora 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 seguinte entrada:

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             |
+--------------------------------+---------------------------------+------------------+----------------+

Por fim, 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

Você pode migrar seus bancos de dados MongoDB para o DocumentDB sem servidor, assim como com o Amazon DocumentDB provisionado. Para obter mais informações, consulte Migrar para o Amazon DocumentDB.