亚马逊 Neptune Engine 版本 1.3.2.1 (2024-06-20)

openCypher 修复

• 在包含具有和LIMIT作为参数的内部WITH子句的参数化查询的查询计划缓存功能中检测到一个错误。SKIPSKIP/LIMIT 值的参数化不正确，因此，后续执行具有不同参数值的相同缓存查询计划仍会返回与第一次执行相同的结果。此问题已得到修复。

  # 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
    } ]
  }%

• 修复了当传递的参数不存在于数据库中InternalFailureException时，参数化突变查询会抛出一个错误。

• 修复了参数化的 Bolt 查询在查询资源清理期间遇到争用条件后卡住的错误。

常规改进

• 支持 TLS 版本 1.3 包括密码套件 TLS_AES_128_GCM_SHA256 和 TLS_AES_256_GCM_SHA384。TLS 1.3 是一个选项——TLS 1.2 仍然是最低限度。

• OpenCypher 对日期时间格式的扩展支持处于此版本的 lab_mode 中。我们鼓励您对其进行测试。

Gremlin 改进

• TinkerPop 3.7.x 升级

  • 提供了 Gremlin 语言的大幅扩展。

    • 处理字符串、列表和日期的新步骤。

    • 用于在步骤中指定基数的新语法。mergeV()

    • union()现在可以用作起始步骤。

    • 要了解有关 3.7.x 中变更的更多信息，请参阅TinkerPop 升级文档。

  • 在升级适用于 Java 的客户端 Gremlin 语言驱动程序时，请注意，序列化器类已经进行了一些重命名。如果已指定，则需要更新配置文件和代码中的包和类命名。

• StrictTimeoutValidation（仅当通过 labmode StrictTimeoutValidation 通过包含启用时StrictTimeoutValidation=enabled）：当StrictTimeoutValidation参数的值为时enabled，指定为请求选项或查询提示的每个查询的超时值不能超过参数组中全局设置的值。在这种情况下，Neptune 会扔一个。InvalidParameterException当值为时，可以在/status端点的响应中确认此设置disabled，而在 Neptune 版本 1.3.2.0 和 1.3.2.1 中，此参数的默认值为。Disabled

openCypher 改进

• 低延迟查询和吞吐量性能改进：低延迟 OpenCypher 查询的整体性能改进。新版本还提高了此类查询的吞吐量。当使用参数化查询时，这些改进更为显著。

• 对查询计划缓存的支持：将查询提交给 Neptune 时，查询字符串会被解析、优化并转换为查询计划，然后由引擎执行。应用程序通常以常见的查询模式为后盾，这些模式使用不同的值进行实例化。查询计划缓存可以通过缓存查询计划来减少总体延迟，从而避免对此类重复模式进行解析和优化。

• DISTINCT 聚合查询的性能改进。

• 涉及可空变量的联接的性能改进。

• 涉及不等于 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 查询转换中的一个NullPointerException错误，该错误发生在两个 DFE 片段中执行查询，并且第一个片段被优化为无法满足的节点时。例如：

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

• 修复了当查询中包含 by () 调制器且其输入为 Map InternalFailureException ValueTraversal 时，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

• 修复了在多个 MERGE 操作中通过 UNWIND 注入 id 时的自定义 ID 优化问题。例如：

  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 解析器以缩短大型查询的解析时间，例如包含许多三元组和大标记的 INSERT DATA。

• 支持的 Gremlin 最早版本：3.6.2

• 支持的 Gremlin 最新版本：3.7.1

• openCypher 版本：Neptune-9.0.20190305-1.0

• SPARQL 版本：1.1