Manter o cluster de banco de dados do Amazon Neptune - Amazon Neptune
Números de versãoTipos de versõesVida útil da versão do mecanismoProcesso de atualizaçãoRealizar a atualização para a versão 1.2.0.0 ou posterior

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

Manter o cluster de banco de dados do Amazon Neptune

O Neptune realiza manutenção periódica em todos os recursos que usa, incluindo:

  • Substituir o hardware subjacente conforme necessário. Isso acontece em segundo plano, sem que você precise realizar nenhuma ação e geralmente não afeta as operações.

  • Atualizar o sistema operacional subjacente. As atualizações do sistema operacional das instâncias no cluster de banco de dados são realizadas para melhorar o desempenho e a segurança. Portanto, você deve concluí-las o mais rápido possível. Em geral, essas atualizações demoram cerca de dez minutos. As atualizações do sistema operacional não alteram a versão do mecanismo de banco de dados nem a classe de uma instância de banco de dados.

    Em geral, é melhor atualizar primeiro as instâncias do leitor em um cluster de banco de dados e depois a instância do gravador. Atualizar os leitores e o gravador ao mesmo tempo pode causar um período de inatividade no caso de um failover. O backup das instâncias de banco de dados não é feito automaticamente antes de uma atualização do sistema operacional. Dessa forma, faça backups manuais antes de aplicar uma atualização do sistema operacional.

  • Atualizar o mecanismo do banco de dados Neptune. O Neptune lança regularmente uma variedade de atualizações do mecanismo para introduzir novos recursos e melhorias e corrigir bugs.

Números das versões do mecanismo

Numeração de versão antes da versão 1.3.0.0 do mecanismo

Antes de novembro de 2019, o Neptune era compatível apenas com uma versão do mecanismo por vez, e os números de versão do mecanismo tinham todos o mesmo formato, 1.0.1.0.200<xxx>, em que xxx era o número do patch. As novas versões do mecanismo foram todas lançadas como patches para versões anteriores.

Em novembro de 2019, o Neptune passou a ser compatível com várias versões, oferecendo aos clientes um melhor controle dos caminhos de atualização. Consequentemente, a numeração de versões do mecanismo foi alterada.

De novembro de 2019 até a versão 1.3.0.0 do mecanismo, os números de versão tinham cinco partes. Por exemplo, no número de versão 1.0.2.0.R2:

  • A primeira parte sempre foi 1.

  • A segunda parte, (0 em 1.0.2.0.R2), era o número da versão principal do banco de dados.

  • A terceira e a quarta parte, (2.0 em 1.0.2.0.R2), eram números de versão secundária.

  • A quinta parte, (R2 em 1.0.2.0.R2), era o número do patch.

A maioria das atualizações era atualizações de patches, e a distinção entre patches e atualizações de versões secundárias nem sempre era clara.

Numeração de versão a partir da versão 1.3.0.0 do mecanismo

A partir da versão 1.3.0.0 do mecanismo, o Neptune mudou a forma como as atualizações do mecanismo são numeradas e gerenciadas.

Os números de versão do mecanismo agora têm quatro partes, cada uma correspondendo a um tipo de versão, da seguinte forma:

    product-version.major-version.minor-version.patch-version

Alterações ininterruptas do tipo que foram lançadas anteriormente como patches agora são lançadas como versões secundárias que você pode gerenciar usando a configuração da instância AutoMinorVersionUpgrade.

Isso significa que, se você quiser, poderá receber uma notificação sempre que uma nova versão secundária for lançada, basta assinar o evento RDS-EVENT-0156 (consulte Assinar a notificação de eventos do Neptune).

As versões de patches agora estão reservadas para correções direcionadas urgentes e são numeradas usando a última parte do número da versão (*.*.*.1, *.*.*.2 e assim por diante).

Diferentes tipos de versões do mecanismo no Amazon Neptune

Os quatro tipos de versão do mecanismo que correspondem às quatro partes de um número de versão do mecanismo são os seguintes:

  • Versão do produto: é alterada somente se o produto passar por mudanças amplas e fundamentais na funcionalidade ou interface. A versão atual do produto Neptune é 1.

  • Versão principal: a versões principais introduzem novos recursos importantes e mudanças significativas e geralmente têm uma vida útil de pelo menos dois anos.

  • Versão secundária: as versões secundárias podem conter novos recursos, melhorias e correções de erros, mas não contêm alterações significativas. Você pode escolher se deseja ou não que sejam aplicadas automaticamente durante a próxima janela de manutenção, além de optar por receber uma notificação sempre que for lançada.

  • Versão de patch: as versões de patch são lançadas somente para tratar de correções de erros urgentes ou atualizações críticas de segurança. Raramente contêm alterações significativas e são aplicadas automaticamente durante a próxima janela de manutenção após o lançamento.

Atualizações da versão principal do Amazon Neptune

Uma atualização de versão principal geralmente introduz um ou mais recursos novos e importantes e geralmente contém alterações significativas. Normalmente, tem uma vida útil de suporte de cerca de dois anos. As versões principais do Neptune estão listadas nas versões do mecanismo, junto com a data em que foram lançadas e o fim da vida útil estimado.

As atualizações da versão principal são totalmente opcionais até que a versão principal utilizada chegue ao fim da vida útil. Se você optar por atualizar para uma nova versão principal, você deverá instalar a nova versão usando o AWS CLI ou o console o Neptune, conforme descrito em Atualizações de versão principal.

No entanto, se a versão principal utilizada chegar ao fim da vida útil, você receberá uma notificação de que é necessário atualizar para uma versão principal mais recente. Dessa forma, se você não fizer a atualização dentro de um período de carência após a notificação, uma atualização para a versão principal mais recente será programada automaticamente para ocorrer durante a próxima janela de manutenção. Consulte Vida útil da versão do mecanismo para obter mais informações.

Atualizações da versão secundária do Amazon Neptune

A maioria das atualizações do mecanismo do Neptune são atualizações de versões secundárias. Elas acontecem com bastante frequência e não contêm alterações significativas.

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 atualizações de versões secundárias são independentes (não dependem das atualizações anteriores da versão secundária para a mesma versão principal) e cumulativas (elas contêm todos os recursos e correções introduzidos nas atualizações de versões secundárias anteriores). Isso significa que você pode instalar qualquer atualização de versão secundária, independentemente de ter instalado ou não as anteriores.

É fácil acompanhar os lançamentos de versões secundárias assinando o evento RDS-EVENT-0156 (consulte Assinar a notificação de eventos do Neptune). Em seguida, você receberá notificações sempre que uma nova versão secundária for lançada.

Além disso, independentemente de você assinar ou não as notificações, sempre poderá verificar quais atualizações estão pendentes.

Atualizações de versão de patch do Amazon Neptune

No caso de problemas de segurança ou outros defeitos graves que afetam a confiabilidade da instância, o Neptune implanta patches obrigatórios. Eles são aplicados a todas as instâncias no cluster de banco de dados durante próxima janela de manutenção, sem qualquer intervenção de sua parte.

Uma versão de patch é implantada somente quando os riscos de não implantá-la superam os riscos e o tempo de inatividade associados à implantação. As versões de patch não ocorrem com frequência (geralmente uma vez a cada poucos meses) e raramente exigem mais do que uma fração de sua janela de manutenção para serem aplicadas.

Planejar a vida útil da versão principal do mecanismo do Amazon Neptune

As versões do mecanismo do Neptune quase sempre chegam ao fim da vida útil no final de um trimestre civil. As exceções ocorrem somente quando surgem problemas importantes de segurança ou disponibilidade.

Quando uma versão do mecanismo chegar ao fim da vida útil, você precisará atualizar o banco de dados Neptune para uma versão mais recente.

Em geral, as versões do mecanismo do Neptune continuam disponíveis da seguinte forma:

  • Versões secundárias do mecanismo: as versões secundárias do mecanismo permanecem disponíveis por pelo menos seis meses após o lançamento.

  • Versões principais do mecanismo: as versões principais do mecanismo permanecem disponíveis por pelo menos 12 meses após o lançamento.

Pelo menos três meses antes de uma versão do mecanismo chegar ao fim da vida útil, AWS enviará uma notificação automática ao endereço de e-mail associado à conta da AWS e publicará a mesma mensagem no AWS Health Dashboard. Isso dará tempo para planejar e se preparar para a atualização.

Quando uma versão do mecanismo chegar ao fim da vida útil, você não poderá mais criar clusters ou instâncias usando essa versão, nem o ajuste de escala automático poderá criar instâncias usando essa versão.

Uma versão do mecanismo que realmente chegue ao fim da vida útil será atualizada automaticamente durante uma janela de manutenção. A mensagem enviada a você três meses antes do fim da vida útil da versão do mecanismo conterá detalhes sobre o que essa atualização automática envolverá, incluindo a versão para a qual o mecanismo será atualizado automaticamente, o impacto nos clusters de banco de dados e as ações que recomendamos.

Importante

Você é responsável por manter as versões do mecanismo de banco de dados atualizadas. A AWS incentiva todos os clientes a atualizar os bancos de dados para a versão mais recente do mecanismo, a fim de se beneficiarem das proteções de segurança, privacidade e disponibilidade mais atualizadas. Se você operar o banco de dados em um mecanismo ou um software não compatível após a data de defasagem (“Mecanismo herdado”), enfrentará uma maior probabilidade de riscos operacionais, segurança e privacidade, incluindo eventos de inatividade.

A operação do banco de dados em qualquer mecanismo está sujeita ao Contrato que rege o uso dos Serviços da AWS. Os Mecanismos herdados não estão disponíveis ao público em geral. A AWS não oferece mais suporte ao Mecanismo herdado e a AWS pode limitar o acesso ou o uso de qualquer Mecanismo herdado a qualquer momento, se a AWS determinar que o Mecanismo herdado representa um risco de segurança ou responsabilidade, ou um risco de danos, aos Serviços da AWS, a suas Afiliadas ou a terceiros. Sua decisão de continuar executando Seu conteúdo em um Mecanismo herdado pode fazer com que Seu conteúdo fique indisponível, corrompido ou irrecuperável. Os bancos de dados executados em um Mecanismo herdado estão sujeitos às exceções do Acordo de Serviço (SLA).

BANCOS DE DADOS E SOFTWARES RELACIONADOS EXECUTADOS EM UM MECANISMO HERDADO CONTÊM BUGS, ERROS, DEFEITOS E/OU COMPONENTES NOCIVOS. CONSEQUENTEMENTE, E NÃO OBSTANTE QUALQUER DISPOSIÇÃO EM CONTRÁRIO NO CONTRATO OU NOS TERMOS DO SERVIÇO, A AWS ESTÁ FORNECENDO O MECANISMO HERDADO “NO ESTADO EM QUE SE ENCONTRA”.

Instalar atualizações no mecanismo do Neptune manualmente

Como instalar uma atualização da versão principal do mecanismo

As versões principais do mecanismo sempre devem ser instaladas manualmente. Para minimizar o tempo de inatividade e fornecer bastante tempo para testes e validação, a melhor maneira de instalar uma nova versão principal geralmente é usar a solução de implantação azul/verde do Neptune.

Em alguns casos, você também pode usar o modelo AWS CloudFormation com o qual criou seu cluster de banco de dados para instalar uma atualização da versão principal (consulte Usando um AWS CloudFormation modelo para atualizar a versão do mecanismo do seu cluster de banco de dados Neptune).

Se você quiser instalar uma atualização da versão principal imediatamente, você pode usar um comando da CLI como o seguinte:

aws neptune modify-db-cluster \
  --db-cluster-identifier (identifier for your neptune cluster) \
  --engine neptune \
  --engine-version (the new engine version) \
  --apply-immediately

Especifique a versão do mecanismo para a qual você deseja atualizar. Caso contrário, o mecanismo poderá ser atualizado para uma versão que não seja a mais recente nem a esperada.

Em vez de --apply-immediately, é possível especificar --no-apply-immediately.

Se o cluster usar um grupo de parâmetros de cluster personalizado, use este parâmetro para especificá-lo:

  --db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

Da mesma forma, se alguma instância no cluster usar um grupo de parâmetros de banco de dados personalizado, use este parâmetro para especificá-lo:

  ---db-instance-parameter-group-name (name of the custom instance parameter group)

Instalar uma atualização da versão secundária do mecanismo usando o AWS Management Console

Para fazer uma atualização da versão secundária usando o console 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 Bancos de dados e selecione o cluster de banco de dados que você deseja modificar.

  3. Selecione Modify.

  4. Em Especificações da instância, escolha a nova versão para a qual você deseja atualizar.

  5. Escolha Next (Próximo).

  6. Para aplicar alterações imediatamente, escolha Aplicar imediatamente.

  7. Escolha Enviar para atualizar o cluster de banco de dados.

Instalar uma atualização da versão secundária do mecanismo usando o AWS CLI

Você pode usar um comando como o seguinte para realizar uma atualização da versão secundária sem esperar pela próxima janela de manutenção:

aws neptune modify-db-cluster \
  --db-cluster-identifier (your-neptune-cluster) \
  --engine-version (new-engine-version) \
  --apply-immediately

Se você estiver fazendo a atualização manual com a AWS CLI, inclua a versão do mecanismo para a qual deseja atualizar. Caso contrário, o mecanismo poderá ser atualizado para uma versão que não seja a mais recente nem a esperada.

Realizar a atualização para a versão 1.2.0.0 ou posterior do mecanismo a partir de uma versão anterior à 1.2.0.0

A versão 1.2.0.0 do mecanismo introduziu algumas alterações significativas que podem tornar a atualização de uma versão anterior mais complicada do que o normal:

  • A versão 1.2.0.0 do mecanismo introduziu um novo formato para grupos de parâmetros personalizados e grupos de parâmetros de cluster personalizados. Como resultado, se você estiver atualizando de uma versão de mecanismo anterior à 1.2.0.0 para a versão 1.2.0.0 ou posterior, deverá recriar todos os grupos de parâmetros personalizados e grupos de parâmetros de cluster personalizados existentes usando a família de grupos de parâmetros neptune1.2. As versões anteriores usavam a família de grupos de parâmetros neptune1, e esses grupos de parâmetros não funcionarão com a versão 1.2.0.0 e posterior. Consulte Grupos de parâmetros do Amazon Neptune para obter mais informações.

  • A versão 1.2.0.0 do mecanismo também introduziu um novo formato para undo logs. Como resultado, todos os undo logs criados por uma versão anterior do mecanismo devem ser eliminados e a métrica UndoLogsListSize do CloudWatch deve cair para zero para que seja possível iniciar qualquer atualização de uma versão anterior à 1.2.0.0. Se houver muitos registros de undo logs (duzentos mil ou mais) ao tentar iniciar uma atualização, a tentativa de atualização poderá expirar enquanto aguarda a conclusão da limpeza dos undo logs.

    É possível acelerar a taxa de limpeza atualizando a instância de gravador do cluster, que é onde a limpeza ocorre. Fazer isso antes de tentar realizar a atualização pode reduzir o número de undo logs antes de começar. Aumentar o tamanho do gravador para um tipo de instância 24XL pode aumentar a taxa de limpeza para mais de um milhão de registros por hora.

    Se a métrica UndoLogsListSize do CloudWatch for extremamente grande, abrir um caso de suporte pode ajudar a examinar estratégias adicionais para reduzi-la.

  • Por fim, houve uma alteração significativa na versão 1.2.0.0. Ela afeta o código anterior que usava o protocolo Bolt com autenticação do IAM. A partir da versão 1.2.0.0, o Bolt precisa de um caminho de recursos para a assinatura do IAM. Em Java, a definição do caminho de recursos pode ser assim: request.setResourcePath("/openCypher"));. Em outras linguagens, o /openCypher pode ser anexado ao URI do endpoint. Consulte Usar o protocolo Bolt para ver exemplos.