Gerenciar atualizações do mecanismo no cluster de banco de dados do Neptune - Amazon Neptune

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

Gerenciar atualizações do mecanismo no cluster de banco de dados do Neptune

nota

As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados em todas essas instâncias, ocorrerá um tempo de inatividade de vinte ou trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados. Em raras ocasiões, um failover Multi-AZ pode ser necessário para concluir uma atualização de manutenção em uma instância.

Para atualizações de versões principais que podem levar mais tempo para serem aplicadas, você pode usar uma estratégia de implantação azul/verde para minimizar o tempo de inatividade.

Determinar qual versão do mecanismo você está usando no momento

Você pode usar o comando get-engine-status do AWS CLI para verificar qual versão do mecanismo que o cluster de banco de dados está usando atualmente:

aws neptunedata get-engine-status

A saída JSON inclui um campo "dbEngineVersion" como este:

"dbEngineVersion": "1.3.0.0",

Verifique quais atualizações estão pendentes e disponíveis

Você pode verificar as atualizações pendentes do cluster de banco de dados do usando o console do Neptune. Selecione Bancos de dados na coluna esquerda e, em seguida, o cluster de banco de dados no painel de bancos de dados. As atualizações pendentes estão listadas na coluna Manutenção. Se você selecionar Ações e, em seguida, Manutenção, você tem três opções:

  • Atualizar agora.

  • Atualizar na próxima janela.

  • Adiar atualização.

Você pode listar as atualizações pendentes do mecanismo usando a AWS CLI da seguinte forma:

aws neptune describe-pending-maintenance-actions \ --resource-identifier (ARN of your DB cluster) --region (your region) \ --engine neptune

Também é possível listar as versões do mecanismo disponíveis usando a AWS CLI da seguinte forma:

aws neptune describe-db-engine-versions \ --region (your region) \ --engine neptune

A lista de versões disponíveis do mecanismo inclui somente as versões com um número maior do que a atual e para as quais há um caminho de atualização definido.

Sempre teste antes de fazer a atualização

Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Uma atualização secundária pode introduzir novos recursos ou comportamentos que afetam o código mesmo sem nenhuma alteração significativa.

Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.

A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é usar a solução de implantação azul/verde do Neptune. Dessa forma, você pode executar aplicações e consultas na nova versão sem afetar o cluster de banco de dados de produção.

Sempre crie um snapshot manual antes de fazer a atualização

Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.

Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.

Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com preupgrade, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.

Janela de manutenção do Neptune

A janela de manutenção semanal é um período de 30 minutos durante o qual as atualizações programadas do mecanismo e outras alterações do sistema são aplicadas. A maioria dos eventos de manutenção é concluída durante a janela de 30 minutos, embora os eventos de manutenção mais longos possam levar mais tempo para serem concluídos.

Cada cluster de banco de dados tem uma janela de manutenção semanal de 30 minutos. Se você não especificar um horário de preferência ao criar o cluster de banco de dados, o Neptune selecionará aleatoriamente um dia da semana e também atribuirá aleatoriamente um período de 30 minutos a partir de um bloco de 8 horas que varia de acordo com a região.

Aqui, por exemplo, estão os blocos de tempo de 8 horas para janelas de manutenção usadas em várias regiões da AWS:

Região Bloco de hora
Região Oeste dos EUA (Oregon) 6h às 14h (UTC)
Região Oeste dos EUA (Norte da Califórnia). 6h às 14h (UTC)
Região Leste dos EUA (Ohio) 3h às 11h (UTC)
Região Europa (Irlanda) 22h às 6h (UTC)

A janela de manutenção determina quando as operações pendentes começam, e a maioria das operações de manutenção é concluída dentro da janela, mas tarefas de manutenção maiores podem continuar além do horário de término da janela.

Mover a janela de manutenção do cluster de banco de dados

O ideal é que sua janela de manutenção caia no momento em que o cluster estiver em menor uso. Se isso não se aplica à sua janela atual, você pode movê-la para um horário melhor, da seguinte forma:

Para alterar a janela de manutenção do cluster de banco de dados
  1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon Neptune em https://console.aws.amazon.com/neptune/home.

  2. No painel de navegação, escolha Bancos de dados.

  3. Escolha o cluster de banco de dados para o qual deseja alterar a janela de manutenção.

  4. Selecione Modify.

  5. Escolha Mostrar mais na parte inferior da página Modificar cluster.

  6. Na seção Janela de manutenção preferencial, defina o dia, a hora e a duração da janela de manutenção conforme sua preferência.

  7. Escolha Next (Próximo).

    Na página de confirmação, revise suas alterações.

  8. Para aplicar as alterações à janela de manutenção imediatamente, selecione Apply immediately (Aplicar imediatamente).

  9. Escolha Enviar para aplicar as alterações.

    Para editar as alterações, selecione Anterior ou, para cancelar as alterações, escolha Cancelar.

Usar AutoMinorVersionUpgrade para controlar atualizações automáticas de versões secundárias

Importante

AutoMinorVersionUpgrade só é eficaz para atualizações de versões secundárias posterior à versão 1.3.0.0 do mecanismo.

Se o campo AutoMinorVersionUpgrade estiver definido como true na instância (primária) do gravador do cluster de banco de dados, as atualizações da versão secundária serão aplicadas automaticamente a todas as instâncias no cluster de banco de dados durante a próxima janela de manutenção após o lançamento.

Se o campo AutoMinorVersionUpgrade estiver definido como false na instância do gravador do cluster de banco de dados, elas serão aplicadas somente se você instalá-las explicitamente.

nota

As versões de patch (*.*.*.1, *.*.*.2 etc.) são sempre instaladas automaticamente durante a próxima janela de manutenção, independentemente de como o parâmetro AutoMinorVersionUpgrade está definido.

Você pode definir AutoMinorVersionUpgrade usando o AWS Management Console da seguinte forma:

Para definir AutoMinorVersionUpgrade usando o console do Neptune
  1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon Neptune em https://console.aws.amazon.com/neptune/home.

  2. No painel de navegação, escolha Databases (Bancos de dados).

  3. Escolha a instância primária (gravador) do cluster de banco de dados para o qual você deseja definir AutoMinorVersionUpgrade.

  4. Selecione Modify.

  5. Escolha Mostrar mais na parte inferior da página Modificar cluster.

  6. Na parte inferior da página expandida, escolha Ativar atualização automática de versão secundária ou Desabilitar o upgrade automático da versão secundária.

  7. Escolha Next (Próximo).

    Na página de confirmação, revise suas alterações.

  8. Para aplicar as alterações na atualização automática de versões secundárias, selecione Aplicar imediatamente.

  9. Escolha Enviar para aplicar as alterações.

    Para editar as alterações, selecione Anterior ou, para cancelar as alterações, escolha Cancelar.

Você também pode usar a AWS CLI para definir o campo AutoMinorVersionUpgrade. Por exemplo, para defini-lo como true, você pode usar um comando como este:

aws neptune modify-db-instance \ --db-instance-identifier (the ID of your cluster's writer instance) \ --auto-minor-version-upgrade \ --apply-immediately

Da mesma forma, para defini-lo como false, use um comando como este:

aws neptune modify-db-instance \ --db-instance-identifier (the ID of your cluster's writer instance) \ --no-auto-minor-version-upgrade \ --apply-immediately