Mecanismo do Amazon Neptune versão 1.0.4.2.R2 (01/06/2021)

Desde 01/06/2021, a versão 1.0.4.2.R2 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.

Versões de patch subsequentes para esta versão

• Versão: 1.0.4.2.R3 (28/06/2021)

Problemas conhecidos nesta versão do mecanismo

Problema:

Um erro do SPARQL de não respeitar o tipo de mídia em um cabeçalho Accept na presença de espaços.

Por exemplo, uma consulta com -H "Accept: text/csv; q=1.0, */*; q=0.1" exibe uma saída JSON em vez de uma saída CSV.

Solução:

Se você remover os espaços na cláusula Accept no cabeçalho, o mecanismo exibirá a saída no formato correto solicitado. Em outras palavras, em vez de -H "Accept: text/csv; q=1.0, */*; q=0.1" , use:

  -H "Accept: text/csv;q=1.0,*/*;q=0.1"

Novos recursos nesta versão do mecanismo

• Adição do novo tipo de instância R5d, que inclui um cache de pesquisa para acelerar as leituras em casos de uso que envolvam um alto volume de valor de propriedade ou pesquisas literais de RDF. Consulte O cache de pesquisa do Neptune pode acelerar as consultas de leitura.

• Adição de um novo parâmetro de modo de laboratório que permite que o mecanismo experimental do DFE seja invocado somente por consulta com a dica de consulta useDFE.

Melhorias nesta versão do mecanismo

• Adição de suporte para o TinkerPop 3.4.10.

• Adição de suporte para usar a etapa de configuração withStrategies( ) ao enviar solicitações de script do Gremlin. Especificamente, as SubgraphStrategy, PartitionStrategy, ReadOnlyStrategy, EdgeLabelVerificationStrategy e ReservedKeysVerificationStrategy são todas compatíveis.

• Adição da otimização de percursos V() no meio de uma consulta. Anteriormente, esses percursos não eram otimizados no Neptune.

• Adição de suporte para URNs RFC 2141 para serem usados como parâmetros baseUri e namedGraphUri para um carregamento em massa.

Defeitos corrigidos nesta versão do mecanismo

• Correção de um erro do Gremlin no analisador em que consultas incorretas eram tratadas como válidas.

• Correção de um erro do Gremlin em que desdobrar um efeito colateral aggregate() com cap().unfold() a um valueMap() lançava uma exceção.

• Correção de um erro do Gremlin em que algumas etapas property() após uma etapa addV() falhavam com o erro “não é possível converter em string”.

• Correção de um erro do Gremlin para evitar que alguns padrões de inserção condicional lançassem exceções de modificação simultânea.

• Correção de um erro do Gremlin para que o tempo limite da solicitação de consulta agora não exceda o tempo limite da sessão.

• Correção de um erro do SPARQL em que as atualizações usando LOAD ou UNLOAD podiam falhar com um código HTTP 500 em vez do código HTTP 400 quando o servidor remoto não estava disponível.

• Correção de um erro em que as chamadas da API do fluxo falhavam quando os valores commitNum ou opNum maiores que o limite de números inteiros assinados de 32 bits (2.147.483.647) eram usados.

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.0.4.2.R2, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:

• Gremlin versão: 3.4.10

• SPARQL versão: 1.1

Caminhos de atualização para a versão 1.0.4.2.R2 do mecanismo

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

Você não atualizará automaticamente para esta versão.

Atualizar para esta versão

O Amazon Neptune 1.0.4.2.R2 já está disponível ao público em geral.

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.0.4.2 \
    --apply-immediately

Para Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.4.2 ^
    --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.