Amazon Neptune 引擎 1.3.2.0 版 (2024-06-10）

一般改進

• 支援 1.3 TLS版，包括密碼套件 TLS_AES_128_GCM_SHA256 和 TLS_AES_256_GCM_SHA384。TLS 1.3 是選項 - TLS 1.2 仍然是最小值。

Gremlin 改進

• TinkerPop 3.7.x 升級

  • 提供 Gremlin 語言的大量擴展。

    • 處理字串、清單和日期的新步驟。

    • 用於指定mergeV()步驟的基數的新語法。

    • union() 現在可以用作開始步驟。

    • 若要進一步了解 3.7.x 中的變更，請參閱TinkerPop 升級文件 。

  • 在升級 Java 的用戶端 Gremlin 語言驅動程式時，請注意序列化器類別已忽略一些重新命名 。如果指定，您將需要更新組態檔案中和程式碼中的套件和類別命名。

• StrictTimeoutValidation （只有在透過包含 StrictTimeoutValidation的實驗室模式啟用時StrictTimeoutValidation=enabled）：當StrictTimeoutValidation參數具有 的值時enabled，每個查詢逾時值指定為請求選項或查詢提示不能超過參數群組中全域設定的值。在這種情況下，Neptune 會擲回 InvalidParameterException。當值為 時，此設定可以在/status端點的回應中確認disabled，而在 Neptune 1.3.2.0 版中，此參數的預設值為 Disabled。

openCypher 改進

• Amazon Neptune 引擎 1.3.2.0 版提供比先前引擎版本快 9 倍的 openCypher 查詢效能和高 10 倍的輸送量。

• 低延遲查詢和輸送量效能改善：低延遲 openCypher 查詢的整體效能改善。新版本也會改善此類查詢的輸送量。使用參數化查詢時，改善效果更為顯著。

• 支援查詢計畫快取：將查詢提交至 Neptune 時，查詢字串會剖析、最佳化，並轉換為查詢計畫，然後由引擎執行。應用程式通常由以不同值現化的常見查詢模式提供支援。查詢計畫快取可以透過快取查詢計畫來降低整體延遲，從而避免剖析和最佳化這類重複模式。

• DISTINCT 彙總查詢的效能改善。

• 涉及 nullable 變數之聯結的效能改善。

• 涉及不等於 id（節點/關係） 述詞之查詢的效能改善。

• 延長日期時間功能的支援 （僅透過包含 DatetimeMillisecond的實驗室模式啟用DatetimeMillisecond=enabled。如需詳細資訊，請參閱Neptune openCypher 實作 （Neptune Analytics 和 Neptune Database 1.3.2.0 及更高版本） 的暫時支援。

一般改進

• 驗證 Graphlytics 儲存貯體的存取權時，已更新 NeptuneML 錯誤訊息。

Gremlin 修正

• 修正DFE查詢轉譯中缺少的標籤資訊，適用於非路徑貢獻步驟包含標籤的情況。例如：

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

• 已修正DFE查詢轉譯中的錯誤，當查詢以兩個DFE片段執行時會發生此NullPointerException錯誤，而第一個片段最佳化為不滿意的節點。例如：

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

• 已修正當查詢包含 by（） 調節程式 ValueTraversal 內部且其輸入為 Map InternalFailureException時，Neptune 可能會擲出 的錯誤。例如：

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

openCypher 修正

• 改善UNWIND操作 （例如將值清單展開為個別值），以協助防止記憶體不足 （OOM） 情況。例如：

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

• 已修正在透過 注入 ID 的多個MERGE操作時，自訂 ID 最佳化UNWIND。例如：

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

• 修正記憶體爆炸，同時規劃具有屬性存取的複雜查詢，以及具有雙向關係的多個躍點。例如：

  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

• 已修正依變數分組為 null 的彙總查詢。例如：

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

SPARQL 修正

• 已修正SPARQL剖析器，以改善大型查詢的剖析時間，例如INSERTDATA包含許多三重和大型權杖。

• 對於 1.3.2.0 版，當內部WITH子句中使用 skip或 limit 並進行參數化時，我們偵測到查詢計畫快取中的問題。例如：

  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}

  在此情況下，從第一個計畫略過和限制的參數值也會套用至後續查詢，導致非預期的結果。

  緩解

  為了避免此問題，請在提交包含參數化略過和/或限制子條款的查詢QUERY:PLANCACHE "disabled"時新增查詢提示。或者，您可以將值硬式編碼到查詢中。

  選項 1：使用查詢提示停用計劃快取：

  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}

  選項 2：使用硬式編碼值進行略過和限制：

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

• 使用數值篩選條件值的查詢在使用查詢計劃快取時，可能會傳回不正確的結果。若要避免問題，請使用查詢提示QUERY:PLANCACHE "disabled"略過查詢計劃快取。例如，使用：

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

• 多次使用相同參數名稱的查詢可能會失敗，但錯誤為 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。在這種情況下，請略過上述查詢計畫快取，或複製參數，如本範例所示：

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

  使用提示QUERY:PLANCACHE "disabled"或修改參數：

  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}

• 如果查詢是 UNION或 查詢，則使用 Bolt 通訊協定執行的UNIONALL查詢可能會產生不正確的結果。為避免問題，請考慮使用HTTP端點執行特定查詢。或者，使用 Bolt 通訊協定時，請分別執行工會的每個部分。

• 支援的 Gremlin 最早版本：3.7.1

• 支援的 Gremlin 最新版本：3.7.1

• openCypher 版本： Neptune-9.0.20190305-1.0

• SPARQL 版本： 1.1