Mecanismo do Amazon Neptune versão 1.1.1.0.R3 (07/06/2022) - Amazon Neptune
MelhoriasDefeitos corrigidosVersões de linguagem de consulta compatíveisCaminhos de atualizaçãoAtualizar

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

Mecanismo do Amazon Neptune versão 1.1.1.0.R3 (07/06/2022)

Desde 07/06/2022, a versão 1.1.1.0.R3 do mecanismo está sendo implantada de forma geral. Observe que leva vários dias para que uma nova versão fique disponível em todas as regiões.

Importante

A atualização para esta versão do mecanismo a partir de uma versão anterior à 1.1.0.0 também aciona uma atualização do sistema operacional em todas as instâncias do cluster de banco de dados. Como as solicitações de gravação ativas que ocorrem durante a atualização do sistema operacional não serão processadas, você deve pausar todas as workloads de gravação no cluster que está sendo atualizado, incluindo carregamentos de dados em massa, antes de iniciar a atualização.

No início da atualização, o Neptune gera um snapshot com um nome composto de preupgrade seguido por um identificador gerado automaticamente com base nas informações do cluster de banco de dados. Você não será cobrado por esse snapshot e poderá usá-lo para restaurar o cluster de banco de dados se algo der errado durante o processo de atualização.

Quando a atualização do mecanismo em si for concluída, a nova versão do mecanismo estará disponível brevemente no sistema operacional antigo, mas em menos de cinco minutos todas as instâncias do cluster iniciarão simultaneamente uma atualização do sistema operacional. O cluster de banco de dados ficará indisponível nesse momento por alguns minutos. Você poderá retomar as workloads de gravação após a conclusão da atualização.

Esse processo gera os seguintes eventos:

  • Mensagens de eventos por cluster:

    • Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]

    • Database cluster major version has been upgraded

  • Mensagens de eventos por instância:

    • Applying off-line patches to DB instance

    • DB instance shutdown

    • Finished applying off-line patches to DB instance

    • DB instance restarted

nota

Há uma alteração significativa nesta versão para o código que usa o openCypher com autenticação do IAM. Até o momento, a string do host na assinatura do IAM incluía o protocolo, como bolt://, por exemplo:

"Host":"bolt://(host URL):(port)"

A partir da versão do mecanismo 1.1.1.0, o protocolo deve ser omitido:

"Host":"(host URL):(port)"

Consulte Usar o protocolo Bolt para ver exemplos.

Melhorias nesta versão do mecanismo

  • Adição de suporte para os tipos de instância x2g equipados com Graviton2, otimizados para workloads com uso intenso de memória. Inicialmente, eles estão disponíveis apenas em quatro Regiões da AWS:

    • Leste dos EUA (Norte da Virgínia) (us-east-1)

    • Leste dos EUA (Ohio) (us-east-2)

    • Oeste dos EUA (Oregon) (us-west-2)

    • Europa (Irlanda) (eu-west-1)

    Para obter mais informações, consulte a página Preços do Neptune.

  • Melhoria no desempenho das etapas do Gremlin em que vários percursos de bordas ou vértices, pesquisas de propriedades ou pesquisas de rótulos estão envolvidos.

Defeitos corrigidos nesta versão do mecanismo

  • Correção de um erro do Gremlin no processamento da etapa otherV() em um percurso secundário.

  • Correção de um erro do Gremlin em consultas com union que têm apenas etapas de filtro como filhos. Por exemplo:

    g.V().union(has("name"), out("knows")).out()

  • Correção de um erro do SPARQL em que variáveis usadas em expressões FILTER aninhadas em cláusulas UNION recebiam informações de escopo inválidas.

Versões de linguagem de consulta compatíveis com esta versão

Antes de atualizar um cluster de banco de dados para a versão 1.1.1.0.R3, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:

  • Versão compatível mais antiga do Gremlin: 3.5.2

  • Versão compatível mais recente do Gremlin: 3.5.4

  • openCypher versão: Neptune-9.0.20190305-1.0

  • SPARQL versão: 1.1

Caminhos de atualização para a versão 1.1.1.0.R3 do mecanismo

O cluster será atualizado com essa versão de patch automaticamente durante a próxima janela de manutenção se você estiver executando a versão 1.1.1.0 do mecanismo.

Atualizar para esta versão

Importante

A atualização para esta versão do mecanismo a partir de qualquer versão anterior à 1.1.0.0 também aciona uma atualização do sistema operacional em todas as instâncias no cluster de banco de dados. Como as solicitações de gravação ativas que ocorrem durante a atualização do sistema operacional não serão processadas, você deve pausar todas as workloads de gravação no cluster que está sendo atualizado, incluindo carregamentos de dados em massa, antes de iniciar a atualização.

No início da atualização, o Neptune gera um snapshot com um nome composto de preupgrade seguido por um identificador gerado automaticamente com base nas informações do cluster de banco de dados. Você não será cobrado por esse snapshot e poderá usá-lo para restaurar o cluster de banco de dados se algo der errado durante o processo de atualização.

Quando a atualização do mecanismo em si for concluída, a nova versão do mecanismo estará disponível brevemente no sistema operacional antigo, mas em menos de cinco minutos todas as instâncias do cluster iniciarão simultaneamente uma atualização do sistema operacional. O cluster de banco de dados ficará indisponível nesse momento por cerca de seis minutos. Você poderá retomar as workloads de gravação após a conclusão da atualização.

Esse processo gera os seguintes eventos:

  • Mensagens de eventos por cluster:

    • Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]

    • Database cluster major version has been upgraded

  • Mensagens de eventos por instância:

    • Applying off-line patches to DB instance

    • DB instance shutdown

    • Finished applying off-line patches to DB instance

    • DB instance restarted

Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para essa versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:

Para Linux, OS X ou Unix:

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

Para Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.1.1.0 ^
    --apply-immediately

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 nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.

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. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.

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 é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone 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.

nota

Se você estiver tentando atualizar com uma ação pendente em andamento, poderá encontrar um erro como o seguinte:

   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.

Se você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.

Para obter mais informações sobre como atualizar a versão do mecanismo, consulte Manter o cluster de banco de dados do Amazon Neptune. Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do AWS Premium Support.