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

Perbaikan umum

• Dukungan untuk TLS versi 1.3 termasuk suite sandi TLS_AES_128_GCM_SHA256 dan TLS_AES_256_GCM_SHA384. TLS 1.3 adalah opsi - TLS 1.2 masih minimum.

Perbaikan Gremlin

• TinkerPop 3.7.x peningkatan

  • Menyediakan perluasan besar bahasa Gremlin.

    • Langkah-langkah baru untuk memproses string, daftar, dan tanggal.

    • Sintaks baru untuk menentukan kardinalitas melalui langkah. mergeV()

    • union()sekarang dapat digunakan sebagai langkah awal.

    • Untuk mempelajari lebih lanjut tentang perubahan di 3.7.x, lihat dokumentasi pemut TinkerPop akhiran.

  • Saat memutakhirkan driver bahasa Gremlin klien untuk Java, perhatikan bahwa kelas serializer tidak memiliki beberapa penggantian nama. https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming Anda perlu memperbarui penamaan paket dan kelas dalam file konfigurasi Anda dan dalam kode, jika ditentukan.

• StrictTimeoutValidation(hanya bila diaktifkan melalui labmode StrictTimeoutValidation dengan menyertakanStrictTimeoutValidation=enabled): Ketika StrictTimeoutValidation parameter memiliki nilaienabled, nilai batas waktu per kueri yang ditentukan sebagai opsi permintaan atau petunjuk kueri tidak dapat melebihi nilai yang ditetapkan secara global dalam grup parameter. Dalam kasus seperti itu, Neptunus akan melemparInvalidParameterException. Pengaturan ini dapat dikonfirmasi dalam respons pada /status titik akhir ketika nilainyadisabled, dan di Neptunus versi 1.3.2.0 nilai default parameter ini adalah. Disabled

Peningkatan OpenCypher

• Mesin Amazon Neptune versi 1.3.2.0 memberikan throughput hingga 9x lebih cepat dan 10x lebih tinggi untuk kinerja kueri OpenCypher dibandingkan rilis engine sebelumnya.

• Kueri latensi rendah dan peningkatan kinerja throughput: Peningkatan kinerja keseluruhan untuk kueri OpenCypher latensi rendah. Versi baru juga meningkatkan throughput untuk kueri tersebut. Perbaikan lebih signifikan ketika kueri parameter digunakan.

• Dukungan untuk Query Plan Cache: Ketika kueri dikirimkan ke Neptunus, string kueri diurai, dioptimalkan, dan diubah menjadi rencana kueri, yang kemudian dieksekusi oleh mesin. Aplikasi sering didukung oleh pola kueri umum yang dibuat dengan nilai yang berbeda. Cache rencana kueri dapat mengurangi latensi keseluruhan dengan men-cache rencana kueri dan dengan demikian menghindari penguraian dan pengoptimalan untuk pola berulang tersebut.

• Peningkatan Kinerja untuk kueri agregasi DISTINCT.

• Peningkatan kinerja untuk gabungan yang melibatkan variabel yang dapat dibatalkan.

• Peningkatan kinerja untuk kueri yang melibatkan tidak sama dengan predikat id (node/relationship).

• Dukungan tambahan untuk fungsionalitas datetime (Hanya diaktifkan melalui mode lab DatetimeMillisecond dengan menyertakan. DatetimeMillisecond=enabled Untuk informasi selengkapnya, lihat Dukungan temporal dalam implementasi Neptune OpenCypher (Neptune Analytics dan Neptune Database 1.3.2.0 ke atas).

Perbaikan umum

• Memperbarui pesan kesalahan NeptuneML saat memvalidasi akses ke bucket Graphlytics.

Perbaikan Gremlin

• Memperbaiki informasi label yang hilang dalam terjemahan kueri DFE, untuk skenario di mana langkah-langkah kontribusi non-jalur berisi label. Contoh:

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

• Memperbaiki NullPointerException bug dalam terjemahan kueri DFE, yang terjadi ketika kueri dijalankan dalam dua fragmen DFE, dan fragmen pertama dioptimalkan ke node yang tidak memuaskan. Contoh:

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

• Memperbaiki bug di mana Neptunus dapat melempar InternalFailureException ketika kueri berisi modulator ValueTraversal di dalam by () dan inputnya adalah Map. Contoh:

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

Perbaikan OpenCypher

• Peningkatan operasi UNWIND (misalnya memperluas daftar nilai menjadi nilai individual) untuk membantu mencegah situasi di luar memori (OOM). Contoh:

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

• Memperbaiki pengoptimalan id khusus jika terjadi beberapa operasi MERGE di mana id disuntikkan melalui UNWIND. Contoh:

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

• Memperbaiki ledakan memori saat merencanakan kueri kompleks dengan akses properti dan beberapa lompatan dengan hubungan dua arah. Contoh:

  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

• Kueri agregasi tetap dengan null sebagai grup berdasarkan variabel. Contoh:

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

Perbaikan SPARQL

• Memperbaiki parser SPARQL untuk meningkatkan waktu penguraian untuk kueri besar seperti INSERT DATA yang berisi banyak tripel dan token besar.

• Untuk versi 1.3.2.0, kami telah mendeteksi masalah dalam cache rencana kueri ketika skip atau limit digunakan dalam WITH klausa dalam dan diparameter. Contoh:

  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}

  Dalam hal ini, nilai parameter untuk skip dan limit dari rencana pertama akan diterapkan ke kueri berikutnya juga, yang mengarah ke hasil yang tidak terduga.

  Mitigasi

  Untuk mencegah masalah ini, tambahkan petunjuk kueri QUERY:PLANCACHE "disabled" saat mengirimkan kueri yang menyertakan sub-klausa and/or batas lompatan parameter. Atau, Anda dapat mengkodekan nilai ke dalam kueri.

  Opsi 1: Menggunakan Petunjuk Kueri untuk menonaktifkan cache rencana:

  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}

  Opsi 2: Menggunakan nilai kode keras untuk skip dan limit:

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

• Kueri yang menggunakan nilai filter numerik dapat mengembalikan hasil yang salah saat menggunakan cache rencana kueri. Untuk menghindari masalah, gunakan petunjuk kueri QUERY:PLANCACHE "disabled" untuk melewati cache rencana kueri. Misalnya, gunakan:

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

• Kueri yang menggunakan nama parameter yang sama beberapa kali dapat gagal dengan kesalahanParameter 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. Lewati cache rencana kueri seperti di atas dalam kasus seperti itu, atau duplikat parameter seperti dalam contoh ini:

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

  Gunakan petunjuk QUERY:PLANCACHE "disabled" atau ubah parameter:

  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}

• Kueri yang dieksekusi dengan protokol Bolt dapat menghasilkan hasil yang salah jika kueri adalah kueri UNION atau UNION ALL. Untuk menghindari masalah ini, pertimbangkan untuk menjalankan kueri tertentu dengan titik akhir HTTP. Atau, jalankan setiap bagian dari serikat secara terpisah saat menggunakan protokol Bolt.

• Versi paling awal Gremlin didukung: 3.7.1

• Gremlin versi terbaru didukung: 3.7.1

• Versi OpenCypher: Neptune-9.0.20190305-1.0

• Versi SPARQL: 1.1