Amazon Neptune Engine versione 1.3.2.0 (2024-06-10)

Miglioramenti generali

• Supporto per TLS versione 1.3, incluse le suite di crittografia TLS_AES_128_GCM_SHA256 e TLS_AES_256_GCM_SHA384. TLS 1.3 è un'opzione: TLS 1.2 è ancora il minimo.

Miglioramenti a Gremlin

• TinkerPop Aggiornamento 3.7.x

  • Fornisce una grande espansione del linguaggio Gremlin.

    • Nuovi passaggi per l'elaborazione di stringhe, elenchi e date.

    • Nuova sintassi per specificare la cardinalità all'interno del passaggio. mergeV()

    • union()ora può essere utilizzato come passaggio iniziale.

    • Per saperne di più sulle modifiche apportate alla versione 3.7.x, consulta la documentazione sull'TinkerPop aggiornamento.

  • Quando si aggiornano i driver del linguaggio Gremlin del client per Java, si noti che le classi serializzatrici hanno annullato la ridenominazione. https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming Dovrai aggiornare la denominazione dei pacchetti e delle classi nei file di configurazione e nel codice, se specificato.

• StrictTimeoutValidation(solo se abilitato tramite labmode StrictTimeoutValidation includendoStrictTimeoutValidation=enabled): quando il StrictTimeoutValidation parametro ha un valore dienabled, un valore di timeout per query specificato come opzione di richiesta o suggerimento di query non può superare il valore impostato globalmente nel gruppo di parametri. In tal caso, Neptune lancerà un. InvalidParameterException Questa impostazione può essere confermata in una risposta sull'/statusendpoint quando il valore èdisabled, e nella versione 1.3.2.0 di Neptune il valore predefinito di questo parametro è. Disabled

Miglioramenti di openCypher

• La versione 1.3.2.0 del motore Amazon Neptune offre prestazioni delle query OpenCypher fino a 9 volte più veloci e 10 volte superiori rispetto alle versioni precedenti del motore.

• Query a bassa latenza e miglioramento delle prestazioni di throughput: miglioramenti complessivi delle prestazioni per le query OpenCypher a bassa latenza. La nuova versione migliora anche la velocità effettiva di tali query. I miglioramenti sono più significativi quando si utilizzano interrogazioni parametrizzate.

• Supporto per Query Plan Cache: quando una query viene inviata a Neptune, la stringa di query viene analizzata, ottimizzata e trasformata in un piano di query, che viene quindi eseguito dal motore. Le applicazioni sono spesso supportate da modelli di query comuni che vengono istanziati con valori diversi. La cache dei piani di query può ridurre la latenza complessiva memorizzando nella cache i piani di query ed evitando così l'analisi e l'ottimizzazione per tali modelli ripetuti.

• Miglioramento delle prestazioni per le query di aggregazione DISTINCT.

• Miglioramento delle prestazioni per i join che coinvolgono variabili nullable.

• Miglioramento delle prestazioni per le query che coinvolgono il predicato not equals to id (). node/relationship

• Supporto esteso per la funzionalità datetime (abilitata solo tramite la modalità lab includendo. DatetimeMillisecond DatetimeMillisecond=enabled Per ulteriori informazioni, consulta Supporto temporale nell'implementazione di Neptune OpenCypher (Neptune Analytics e Neptune Database 1.3.2.0 e versioni successive).

Miglioramenti generali

• È stato aggiornato il messaggio di errore NeptunEML durante la convalida dell'accesso ai bucket Graphlytics.

Correzioni Gremlin

• È stato corretto il problema delle informazioni sulle etichette mancanti nella traduzione delle query DFE, per gli scenari in cui i passaggi che non contribuiscono al percorso contengono etichette. Ad esempio:

  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')

• È stato corretto un NullPointerException bug nella traduzione delle query DFE, che si verifica quando un'interrogazione viene eseguita in due frammenti DFE e il primo frammento è ottimizzato in un nodo insoddisfacente. Ad esempio:

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

• È stato corretto un bug per cui Neptune poteva generare un segnale InternalFailureException quando una query contiene il modulatore by () ValueTraversal interno e il suo input è Map. Ad esempio:

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

Correzioni apportate a openCypher

• Operazioni UNWIND migliorate (ad esempio, espansione di un elenco di valori in singoli valori) per aiutare a prevenire situazioni di esaurimento della memoria (OOM). Ad esempio:

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

• È stata corretta l'ottimizzazione personalizzata dell'id in caso di più operazioni MERGE in cui l'id viene iniettato tramite UNWIND. Ad esempio:

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

• Risolto il problema dell'esplosione della memoria durante la pianificazione di query complesse con accesso alle proprietà e hop multipli con relazioni bidirezionali. Ad esempio:

  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

• Interrogazioni di aggregazione fisse con null come raggruppamento per variabili. Ad esempio:

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

Correzioni apportate a SPARQL

• È stato corretto il parser SPARQL per migliorare i tempi di analisi per query di grandi dimensioni come INSERT DATA contenenti molte triple e token di grandi dimensioni.

• Per la versione 1.3.2.0, abbiamo rilevato un problema nella cache del piano di interrogazione quando skip o limit viene utilizzato in una clausola interna WITH e siamo parametrizzati. Ad esempio:

  MATCH (n:Person)
  WHERE n.age > $age
  WITH n skip $skip LIMIT $limit 
  RETURN n.name, n.age
  
  parameters={"age": 21, "skip": 2, "limit": 3}

  In questo caso, i valori dei parametri per skip e limit del primo piano verranno applicati anche alle query successive, con risultati imprevisti.

  Mitigazione

  Per evitare questo problema, aggiungi il suggerimento per la query QUERY:PLANCACHE "disabled" quando invii una query che include una clausola secondaria di salto al limite parametrizzata. and/or In alternativa, puoi codificare i valori nella query.

  Opzione 1: utilizzo del Query Hint per disabilitare la cache del piano:

  Using QUERY:PLANCACHE "disabled"
  MATCH (n:Person) WHERE n.age > $age
  WITH n skip $skip LIMIT $limit
  RETURN n.name, n.age
  
  parameters={"age": 21, "skip": 2, "limit": 3}

  Opzione 2: utilizzo di valori codificati per saltare e limitare:

  MATCH (n:Person)
  WHERE n.age > $age
  WITH n skip 2 LIMIT 3
  RETURN n.name, n.age
  
  parameters={"age": 21}

• Le interrogazioni che utilizzano valori di filtro numerici possono restituire risultati errati quando si utilizza la cache del piano di interrogazione. Per evitare il problema, utilizzate il suggerimento di interrogazione QUERY:PLANCACHE "disabled" per saltare la cache del piano di query. Usa ad esempio:

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

• Le interrogazioni che utilizzano più volte lo stesso nome di parametro possono avere esito negativo e generare l'errore. 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 In questi casi, salta la cache del piano di query come sopra oppure duplica i parametri come in questo esempio:

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

  Usa il suggerimento QUERY:PLANCACHE "disabled" o modifica i parametri:

  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}

• Le interrogazioni eseguite con il protocollo Bolt possono produrre risultati errati se si tratta di una query UNION o UNION ALL. Per evitare il problema, considera l'esecuzione della particolare query con l'endpoint HTTP. In alternativa, esegui ogni parte dell'unione separatamente quando usi il protocollo Bolt.

• Versione meno recente di Gremlin supportata: 3.7.1

• Versione più recente di Gremlin supportata: 3.7.1

• Versione openCypher: Neptune-9.0.20190305-1.0

• Versione di SPARQL: 1.1