Mecanismo do Amazon Neptune versão 1.3.2.1 (20/6/2024)

Correções do openCypher

• Um erro foi detectado no recurso de cache do plano de consulta para consultas parametrizadas que contêm uma cláusula WITH interna com SKIP e LIMIT como parâmetros. Os valores SKIP/LIMIT não foram parametrizados adequadamente e, como resultado, as execuções subsequentes do mesmo plano de consulta em cache com valores de parâmetros diferentes ainda retornariam os mesmos resultados da primeira execução. Isso foi corrigido.

  # insert some nodes
  UNWIND range(1, 10) as i CREATE (s {name: i}) RETURN s
  
  # sample query
  MATCH (p) 
  WITH p ORDER BY p.name SKIP $s LIMIT $l 
  RETURN p.name as res
  
  # first time executing with {"s": 2, "l": 1}
  {
    "results" : [ {
      "res" : 3
    } ]
  }
  
  # second time executing with {"s": 2, "l": 10}
  # due to bug, produces
  {
    "results" : [ {
      "res" : 3
    } ]
  }
  # with fix, produces correct results: 
  {
    "results" : [ {
      "res" : 3
    }, {
      "res" : 4
    }, {
      "res" : 5
    }, {
      "res" : 6
    }, {
      "res" : 7
    }, {
      "res" : 8
    }, {
      "res" : 9
    }, {
      "res" : 10
    } ]
  }%

• Correção de um erro em que consultas de mutação parametrizadas lançavam um InternalFailureException quando o parâmetro passado ainda não estava presente no banco de dados.

• Correção de um erro em que as consultas parametrizadas do Bolt ficavam travadas após atingirem uma condição de corrida durante a limpeza dos recursos da consulta.

Melhorias gerais

• Suporte adicionado para TLS versão 1.3 incluindo conjuntos de cifras TLS_AES_128_GCM_SHA256 e TLS_AES_256_GCM_SHA384. O TLS 1.3 é uma opção, mas o TLS 1.2 ainda é o mínimo.

• O suporte estendido do openCypher para o formato datetime está em lab_mode nesta versão. Recomendamos testá-lo.

Melhorias no Gremlin

• Atualização 3.7x do TinkerPop

  • Fornece uma grande expansão da linguagem Gremlin.

    • Novas etapas para processar cadeias de caracteres, listas e datas.

    • Nova sintaxe para especificar a cardinalidade dentro da etapa mergeV().

    • union() agora pode ser usado como uma etapa inicial.

    • Para saber mais sobre as mudanças na 3.7.x, consulte a documentação de atualização do TinkerPop.

  • Ao atualizar os drivers da linguagem Gremlin do cliente para Java, observe que as classes do serializador passaram por renomeações. Você precisará atualizar a nomenclatura do pacote e da classe em seus arquivos de configuração e no código, se especificado.

• StrictTimeoutValidation (somente quando habilitado pelo modo de laboratório StrictTimeoutValidation incluindoStrictTimeoutValidation=enabled): quando o parâmetro StrictTimeoutValidation tem um valor de enabled, um valor de tempo limite por consulta especificado como uma opção de solicitação ou uma dica de consulta não pode exceder o valor definido globalmente no grupo de parâmetros. Nesse caso, o Neptune lançará um InvalidParameterException. Essa configuração pode ser confirmada em uma resposta no endpoint /status quando o valor é disabled. Nas versões 1.3.2.0 e 1.3.2.1 do Neptune, o valor padrão desse parâmetro é Disabled.

Melhorias no openCypher

• A versão 1.3.2.0 do mecanismo Amazon Neptune oferece um throughput até 9x mais rápido e 10x maior para desempenho de consultas do openCypher em relação às versões anteriores do mecanismo.

• Consultas de baixa latência e melhoria no desempenho do throughput: melhorias gerais no desempenho para consultas de baixa latência do openCypher. A nova versão também melhora o throughput dessas consultas. As melhorias são mais significativas quando consultas parametrizadas são usadas.

• Suporte para o cache do plano de consultas: quando uma consulta é enviada ao Neptune, a string de consulta é analisada, otimizada e transformada em um plano de consulta, executado pelo mecanismo. As aplicações muitas vezes são apoiadas por padrões de consulta comuns que são instanciados com diferentes valores. O cache do plano de consultas pode reduzir a latência geral ao armazenar em cache os planos de consulta e, assim, evitar a análise e a otimização desses padrões repetidos. Consulte Cache do plano de consulta no Amazon Neptune para obter mais detalhes.

• Melhoria de desempenho para consultas de agregação DISTINCT.

• Melhoria de desempenho para junções envolvendo variáveis anuláveis.

• Melhoria de desempenho para consultas envolvendo valores diferentes do predicado id(node/relationship).

• Suporte estendido para a funcionalidade de data e hora (habilitado somente no modo de laboratório DatetimeMillisecond incluindo DatetimeMillisecond=enabled). Para obter mais informações, consulte Compatibilidade temporal na implementação do Neptune openCypher (Neptune Analytics e banco de dados do Neptune 1.3.2.0 e superior).

Melhorias gerais

• Atualização da mensagem de erro do NeptuneML ao validar o acesso aos buckets do Graphlytics.

Correções do Gremlin

• Correções das informações de rótulos ausentes na tradução de consultas do DFE, para cenários em que etapas que não contribuem com caminhos contêm rótulos. Por exemplo:

  g.withSideEffect('Neptune#useDFE', true).
    V().
    has('name', 'marko').
    has("name", TextP.regex("mark.*")).as("p1").
    not(out().has("name", P.within("peter"))).
    out().as('p2').
    dedup('p1', 'p2')

• Correção de um erro NullPointerException na tradução da consulta do DFE, que ocorre quando uma consulta é executada em dois fragmentos do DFE e o primeiro fragmento é otimizado para um nó insatisfatório. Por exemplo:

  g.withSideEffect('Neptune#useDFE', true).
    V().
    has('name', 'doesNotExists').
    has("name", TextP.regex("mark.*")).
    inject(1).
    V().
    out().
    has('name', 'vadas')

• Correção de um erro em que Neptune podia lançar InternalFailureException um quando uma consulta continha ValueTraversal dentro do modulador by() e sua entrada era Map. Por exemplo:

  g.V().
    hasLabel("person").
    project("age", "name").by("age").by("name").
    order().by("age")

Correções do openCypher

• Operações UNWIND aprimoradas (por exemplo, expandir uma lista de valores em valores individuais) para evitar situações de falta de memória (OOM). Por exemplo:

  MATCH (n)-->(m)
  WITH collect(m) AS list
  UNWIND list AS m
  RETURN m, list

• Otimização de id personalizada corrigida no caso de várias operações MERGE em que o id é injetado via UNWIND. Por exemplo:

  UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
  MERGE (n:N {`~id`: ids.nid})
  MERGE (m:M {`~id`: ids.mid})

• Correção de explosão de memória ao planejar consultas complexas com acesso à propriedade e vários saltos com relacionamentos bidirecionais. Por exemplo:

  MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}), 
         (person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}), 
         (person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}), 
         (comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}),
         (comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'}) 
  WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy 
  MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'})
  RETURN person1, group.name, info1.value,  post.ranking, info3.value

• Correção de consultas de agregação fixa com null como grupo por variáveis. Por exemplo:

  MATCH (n)
  RETURN null AS group, sum(n.num) AS result

Correções do SPARQL

• Correção do analisador SPARQL para melhorar o tempo de análise de consultas grandes, como INSERT DATA, contendo muitos triplos e tokens grandes.

• Consultas usando valores de filtro numérico podem retornar resultados incorretos ao usar o cache do plano de consulta. Para evitar o problema, use a dica de consulta QUERY:PLANCACHE "disabled" para ignorar o cache do plano de consulta. Por exemplo, use:

  USING QUERY:PLANCACHE "disabled"
  MATCH (n:person)
  WHERE n.yearOfBirth > $year
  RETURN n
  
  parameters={"year":1950}

• Consultas que usam o mesmo nome de parâmetro várias vezes podem falhar com o erro Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled. Ignore o cache do plano de consulta, como acima, nesses casos, ou duplique os parâmetros, como neste exemplo:

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

  Use a dica QUERY:PLANCACHE "disabled" ou modifique os parâmetros:

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

• Consultas executadas com o protocolo Bolt podem produzir resultados incorretos se a consulta for UNION ou UNION ALL. Para evitar o problema, considere executar a consulta específica com o endpoint HTTP. Como alternativa, execute cada parte da união separadamente ao usar o protocolo Bolt.

• 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

• SPARQL versão: 1.1