Amazon Neptune Engine versão 1.3.4.0 (2024-10-01) - 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á.

Amazon Neptune Engine versão 1.3.4.0 (2024-10-01)

Em 01/10/2024-2024, a versão 1.3.4.0 do mecanismo geralmente está sendo implantada. 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. Consulte Grupos de parâmetros do Amazon Neptune Para mais informações.

Atenção

Foi detectado um problema nas operações de atualização SPARQL 1.1 que pode estar presente sob determinadas condições quando os operadores de atualização são usados com políticas de autorização baseadas em ações. Se você estiver usando as operações de atualização SPARQL 1.1 com políticas de autorização baseadas em ações, recomendamos atualizar para a versão mais recente do motor secundário do Neptune (pelo menos 1.3.4.0), que inclui uma correção para esse problema.

O cache do plano de consulta foi temporariamente desativado para consultas parametrizadas envolvendo valores de parâmetros numéricos devido a um problema no tratamento de usos duplicados de um parâmetro de tipo numérico, como na consulta a seguir:

MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n UNION MATCH (n:show) WHERE n.duration>=$minutes RETURN n parameters={"minutes":130}

Melhorias nesta versão do motor

  • Foi adicionado suporte para execução de etapas Gremlin limit () em travessias aninhadas para o motor. DFE

  • Foram adicionadas CloudWatch métricas relacionadas ao cache de resultados do Gremlin, conforme listado abaixo, que podem ser úteis para diagnosticar e ajustar a latência do cache de resultados. Consulte Neptune Metrics para obter detalhes.

    NumResultCacheHit NumResultCacheMiss ResultCacheSizeInBytes ResultCacheItemCount ResultCacheOldestItemTimestamp ResultCacheNewestItemTimestamp

Defeitos corrigidos nesta versão do motor

Melhorias gerais
  • Corrigido um bug em que, em casos raros, o mecanismo trava em vez de retornar um erro de consulta.

Correções do Gremlin
  • Melhoramos o tratamento de solicitações e o relatório de erros quando um cliente ou proxy envia uma solicitação de atualização do websocket por meio de uma HTTP conexão estabelecida/usada (antes disso, 400 respostas com o erro “nenhum script gremlin fornecido, código” eram retornadas). MissingParameterException

  • Otimizou o tratamento das etapas do MergeV com atualizações de valores de propriedades de cardinalidade única. Por exemplo, a consulta abaixo agora tem suporte nativo no Neptune.

    g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])
  • Corrigido um bug de avaliação de DFE consulta do Gremlin que fazia com que as consultas falhassem com um InternalFailureException quando a consulta continha uma função ToMap lógica para gerar um mapa em tempo de execução e a saída do mapa era usada como uma chave de agregação (in). DFEAggregationNode Exemplo de consulta afetada:

    g.V("1").as("a").as("b").select("a","b").dedup()
openCypher correções
  • Corrigido um erro em que a execução collect(distinct()) com valores nulos presentes fazia com que um erro fosse retornado.

  • Corrigido um erro em que executar uma consulta parametrizada contendo filtro de intervalo (</<=/>/>= em relação ao valor do parâmetro) resultava em resultados duplicados/ausentes.

  • Corrigido um bug em que o DFE motor produzia mais resultados do que o solicitado nas consultas de limite, o que poderia levar a erros de falta de memória.

SPARQLcorreções
  • Corrigido um erro em que a execução de uma consulta de SPARQL atualização federada em clusters IAM habilitados para autenticação fazia com que um erro fosse retornado.

  • Permissões fixas baseadas em ações para operações de atualização SPARQL 1.1.

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.4.0, certifique-se de que seu projeto seja compatível com essas versões da linguagem de consulta:

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

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

  • openCypher versão: Neptune-9.0.20190305-1.0

  • SPARQLversão: 1.1

Caminhos de atualização para a versão 1.3.4.0 do motor

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 qualificado usando as operações do cluster de banco de dados no console ou usando SDK o. O CLI comando a seguir atualizará imediatamente um cluster qualificado:

Para Linux, OS X ou Unix:

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

Para Windows:

aws neptune modify-db-cluster ^ --db-cluster-identifier (your-neptune-cluster) ^ --engine-version 1.3.4.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, o allow-major-version-upgrade parâmetro é necessário. 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. Se você tiver alguma dúvida ou preocupação, a equipe de AWS Suporte está disponível nos fóruns da comunidade e por meio do AWS Premium Support.