Migração para o Amazon DocumentDB Sem Servidor - Amazon DocumentDB
Migração de clusters do DocumentDB existentes para a tecnologia sem servidorMigração do MongoDB para o DocumentDB Sem Servidor

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

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.

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.

    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.

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

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

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

    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.

  5. (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.

  6. (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) ou as remova do cluster (consulte Excluir uma instância do Amazon DocumentDB).

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 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 (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

    A tabela Clusters será exibida.

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

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

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

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

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

  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 Monitoramento do status de 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, 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.