View a markdown version of this page

Atualização da versão secundária do Amazon DocumentDB - Amazon DocumentDB
Antes de realizar um upgrade da versão secundáriaRealizar uma atualização da versão secundáriaVerificando a atualização da versão secundária

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

Atualização da versão secundária do Amazon DocumentDB

nota

Este tópico aborda atualizações de versões secundárias dentro da mesma versão principal (por exemplo, atualização da 5.0.0 para a 5.0.1). Para obter informações sobre a atualização para uma versão principal diferente, consulteAtualização da versão principal implementada do Amazon DocumentDB no local.

Você pode atualizar a versão secundária do mecanismo do seu cluster Amazon DocumentDB (por exemplo, de 5.0.0 para 5.0.1) modificando o cluster. Atualizações de versões menores podem ser aplicadas imediatamente ou durante a próxima janela de manutenção.

Antes de realizar um upgrade da versão secundária

Antes de realizar uma pequena atualização de versão, as seguintes ações podem ser úteis:

  • Execute a atualização durante um período de baixo tráfego para reduzir o impacto de qualquer breve tempo de inatividade.

  • Verifique se a versão secundária de destino é uma meta de atualização válida para sua versão atual usando o describe-db-engine-versions comando.

  • Para clusters globais, os clusters secundários devem ser atualizados antes do cluster primário. Para obter mais informações, consulte Correção de clusters globais.

Importante

  • Os upgrades são operações unidirecionais — você não pode fazer o downgrade após o upgrade.

  • Seu cluster passará por um breve período de inatividade durante o processo de atualização.

Realizar uma atualização da versão secundária

Using the Console de gerenciamento da AWS

Para realizar uma atualização de versão secundária usando o Console de gerenciamento da AWS:

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

  2. Na tabela Clusters, selecione o cluster que você deseja atualizar, escolha Ações e, em seguida, escolha Modificar.

  3. Na caixa de diálogo Modificar cluster, na seção Especificações do cluster, escolha a versão secundária de destino no menu suspenso Versão do mecanismo.

  4. Role para baixo e escolha Continuar.

  5. Na seção Programação de modificações, escolha aplicar a alteração imediatamente ou durante a próxima janela de manutenção.

    Depois, selecione Modify Cluster (Modificar cluster).

Using the AWS CLI

Use o comando modify-db-cluster com o parâmetro --engine-version:

aws docdb modify-db-cluster \
    --db-cluster-identifier mydocdbcluster \
    --engine-version 5.0.1 \
    --apply-immediately \
    --region us-east-1

No exemplo acima, substitua cada um user input placeholder pelas informações do seu cluster.

nota

Para aplicar a atualização durante a próxima janela de manutenção, em vez de imediatamente, use --no-apply-immediately no lugar de--apply-immediately.

Verificando a atualização da versão secundária

Depois que a atualização for concluída, verifique a versão do mecanismo usando: AWS CLI

aws docdb describe-db-clusters \
    --db-cluster-identifier mydocdbcluster \
    --query 'DBClusters[0].EngineVersion'

A saída dessa operação é semelhante à seguinte:

"5.0.1"