Mecanismo do Amazon Neptune versão 1.3.1.0 (6/3/2024) - Amazon Neptune
MelhoriasDefeitos corrigidosVersões de linguagem de consulta compatíveisCaminhos de atualizaçãoAtualizar

Mecanismo do Amazon Neptune versão 1.3.1.0 (6/3/2024)

Desde 6/3/2024, a versão 1.3.1.0 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.

nota

A versão 1.3.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.3.0.0 para a versão 1.3.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.3. As versões anteriores usavam a família de grupos de parâmetros neptune1 ou neptune1.2, e esses grupos de parâmetros não funcionarão com a versão 1.3.0.0 e posterior. Da mesma forma, você deve usar grupos de parâmetros de cluster 1.4.0.0 para as versões 1.4.0.0 e superiores do mecanismo. Consulte Grupos de parâmetros do Amazon Neptune para obter mais informações.

Melhorias nesta versão do mecanismo

Melhorias gerais

  • O Neptune melhorou o aviso exibido no perfil/explique.

  • Remoção de curvas NIST EC obsoletas dos grupos nomeados padrão usados durante a negociação de TLS. As curvas removidas foram sect409k1, sect409r1 e sect571k1.

Melhorias no Gremlin

  • Cálculo de estatísticas de DFE aprimorada para evitar NCUs muito altas de instâncias sem servidor.

  • Melhoria de desempenho do Gremlin para WITHIN.

Defeitos corrigidos nesta versão do mecanismo

Correções do Gremlin

  • Melhorias diversas nos planos de consulta do DFE do Gremlin.

  • Correção de erro em consultas do Gremlin com percurso opcional, por exemplo, para consultas no formato “g.V().hasLabel('person').group().by(id()).by(__.in('friend').id().fold())”, onde nenhuma pessoa sem bordas de amigos foi agrupada.

  • Correção de um erro em que consultas do Gremlin contendo etapas de aglutinação dentro de moduladores by fazia com que um erro fosse retornado se executadas usando o mecanismo DFE.

  • Correção de um erro que impedia que consultas somente leitura executadas em uma sessão do Gremlin funcionassem quando conectadas a uma réplica de leitura.

  • Correção de erro em que o ARN do IAM não estava presente no log de auditoria de uma solicitação de conexão de websocket inicial bem-sucedida do Gremlin.

  • Etapa de aglutinação, identificar a cobertura da etapa com o DFE.

  • Otimização do conjunto de características para planos completos do DFE.

Correções do openCypher

  • Correções de erros na cláusula SET do openCypher para permitir a configuração em uma expressão não variável (ou seja: match(n:TEST) set(case when n.prop = 2 then n end).prop = 3 return n.prop.

  • Correção de erro para falhas nas consultas do openCypher envolvendo agregação e ordenação.

  • UNWIND aprimorado de grandes listas contendo mapas estáticos.

  • Correção de erro da consulta MERGE do openCypher usando ID personalizado com valores duplicados.

Correções do SPARQL

  • Correção de um erro do SPARQL sobre o escopo da variável em padrões opcionais.

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.3.1.0, 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.6.2

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

  • openCypher versão: Neptune-9.0.20190305-1.0

  • SPARQL versão: 1.1

Caminhos de atualização para a versão 1.3.1.0 do mecanismo

Você pode atualizar para esta versão a partir da versão 1.2.0.0 ou superior.

Atualizar para esta versão

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 esta 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.3.1.0 \
    --allow-major-version-upgrade \
    --apply-immediately

Para Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.3.1.0 ^
    --allow-major-version-upgrade ^
    --apply-immediately

Em vez de --apply-immediately, é possível especificar --no-apply-immediately. Para realizar uma atualização de versão principal, é necessário usar o parâmetro allow-major-version-upgrade. Além disso, não se esqueça de incluir a versão do mecanismo ou ele poderá ser atualizado para outra versão.

Se o cluster usar um grupo de parâmetros de cluster personalizado, não se esqueça de incluir 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, não se esqueça de incluir este parâmetro para especificá-lo:

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

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.