选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

亚马逊 Neptune Engine 版本 1.3.4.0 (2024-10-01)

聚焦模式
亚马逊 Neptune Engine 版本 1.3.4.0 (2024-10-01) - Amazon Neptune

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

自 2024 年 10 月 1 日起,引擎版本 1.3.4.0 已全面部署。请注意,新版本在每个区域的发布需要几天的时间。

注意

引擎版本 1.3.0.0 为自定义参数组和自定义集群参数组引入了一种新格式。因此,如果您要从 1.3.0.0 之前的引擎版本升级到引擎版本 1.3.0.0 或更高版本,则必须使用参数组系列重新创建所有现有的自定义参数组和自定义集群参数组。neptune1.3早期版本使用参数组系列 neptune1neptune1.2,而这些参数组不适用于版本 1.3.0.0 及更高版本。同样,对于引擎版本 1.4.0.0 及更高版本,您应该使用 1.4.0.0 集群参数组。请参阅Amazon Neptune 参数组了解更多信息。

警告

在 SPARQL 1.1 更新操作中检测到一个问题,当更新运算符与基于操作的授权策略一起使用时,在某些条件下可能会出现该问题。如果您使用带有基于操作的授权策略的 SPARQL 1.1 更新操作,我们建议升级到最新的 Neptune 次要引擎版本(至少 1.3.4.0),其中包含针对此问题的修复程序。

由于在处理数字类型参数的重复使用时存在问题,因此暂时禁用了涉及数字参数值的参数化查询的查询计划缓存,如以下查询所示:

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

此引擎版本中的改进

  • 为 DFE 引擎添加了对嵌套遍历中执行 Gremlim limit () 步骤的支持。

  • 添加了与 Gremlin 结果缓存相关的 CloudWatch 指标,如下所示,这些指标可用于诊断和调整结果缓存延迟。有关详细信息,请参阅 Neptune 指标

    NumResultCacheHit NumResultCacheMiss ResultCacheSizeInBytes ResultCacheItemCount ResultCacheOldestItemTimestamp ResultCacheNewestItemTimestamp

此引擎版本中修复的缺陷

常规改进
  • 修复了一个错误,即在极少数情况下,引擎会崩溃而不是返回查询错误。

Gremlin 修复
  • 当客户端或代理通过已建立/使用的 HTTP 连接发送 websocket 升级请求时,我们改进了请求处理和错误报告(之前返回了 400 个响应,错误为 “未提供 gremlin 脚本,代码”)。 MissingParameterException

  • 通过更新单基数属性值优化了 MergeV 步骤的处理。例如,Neptune 现在原生支持以下查询。

    g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])
  • 修复了 Gremlin DFE 查询评估错误,当查询包含用于在运行InternalFailureException时生成地图的ToMap逻辑函数,并且地图输出用作聚合键(中)时,该错误会导致查询失败。DFEAggregationNode受影响的示例查询:

    g.V("1").as("a").as("b").select("a","b").dedup()
openCypher 修复
  • 修复了在存在空值collect(distinct())的情况下运行会导致返回错误的错误。

  • 修复了运行包含范围过滤器(针对参数值 </<=/>/>=)的参数化查询会导致结果重复/缺失的错误。

  • 修复了 DFE 引擎产生的输出多于限制查询中请求的输出量的问题,这可能会导致内存不足错误。

SPARQL 修复
  • 修复了在启用 IAM 身份验证的集群上运行联合 SPARQL 更新查询会导致返回错误的错误。

  • 修复了 SPARQL 1.1 更新操作的基于操作的权限。

此版本支持的查询语言版本

在将数据库集群升级到版本 1.3.4.0 之前,请确保您的项目与以下查询语言版本兼容:

  • 支持的 Gremlin 最早版本:3.7.1

  • 支持的 Gremlin 最新版本:3.7.1

  • openCypher 版本:Neptune-9.0.20190305-1.0

  • SPARQL 版本:1.1

引擎版本 1.3.4.0 的升级路径

您可以从引擎版本 1.2.0.0 或更高版本升级到此版本。

升级到此版本

如果数据库集群运行的引擎版本有此版本的升级路径,则可以立即对其进行升级。您可以使用控制台上的数据库集群操作或使用 SDK 升级任何符合条件的集群。以下 CLI 命令将立即升级符合条件的集群:

对于 Linux、OS X 或 Unix:

aws neptune modify-db-cluster \ --db-cluster-identifier (your-neptune-cluster) \ --engine-version 1.3.4.0 \ --allow-major-version-upgrade \ --apply-immediately

对于 Windows:

aws neptune modify-db-cluster ^ --db-cluster-identifier (your-neptune-cluster) ^ --engine-version 1.3.4.0 ^ --allow-major-version-upgrade ^ --apply-immediately

您可以指定 --no-apply-immediately,而不是 --apply-immediately。要执行主要版本升级, allow-major-version-upgrade参数是必需的。另外,请务必包括引擎版本,否则您的引擎可能会升级到其它版本。

如果集群使用自定义集群参数组,请确保包含以下参数以指定此参数组:

--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

同样,如果集群中的任何实例使用自定义数据库参数组,请确保包含此参数以指定此参数组:

--db-instance-parameter-group-name (name of the custom instance parameter group)

升级前始终先测试

发布新的主要或次要 Neptune 引擎版本时,请务必先在该版本上测试您的 Neptune 应用程序,然后再升级到该版本。即使是次要版本升级,也可能引入会影响代码的新特征或行为。

首先,将当前版本的发行说明页面与目标版本的发行说明页面进行比较,以查看查询语言版本是否会发生变化或是否会发生其它重大更改。

在升级生产数据库集群之前测试新版本的最佳方法是克隆生产集群,以便克隆运行新的引擎版本。然后,您可以在不影响生产数据库集群的情况下在克隆上运行查询。

请在升级之前始终创建手动快照

在执行升级之前,我们强烈建议您始终创建数据库集群的手动快照。拥有自动快照只能提供短期保护,而手动快照在您显式删除它之前仍然可用。

在某些情况下,作为升级过程的一部分,Neptune 会为您创建手动快照,但您不应依赖此快照,无论如何都应创建自己的手动快照。

当您确定不需要将数据库集群恢复到其升级前的状态时,可以显式删除自己创建的手动快照以及 Neptune 可能已创建的手动快照。如果 Neptune 创建手动快照,则其名称将以 preupgrade 开头,后跟数据库集群的名称、源引擎版本、目标引擎版本和日期。

注意

如果您在待处理操作正在进行时尝试升级,则可能会遇到如下错误:

We're sorry, your request to modify DB cluster (cluster identifier) has failed. Cannot modify engine version because instance (instance identifier) is running on an old configuration. Apply any pending maintenance actions on the instance before proceeding with the upgrade.

如果遇到此错误,请等待待处理操作完成,或者立即触发维护时段,让之前的升级完成。

有关升级引擎版本的更多信息,请参阅维护 Amazon Neptune 数据库集群。如果您有任何疑问或疑虑, AWS 可通过社区论坛和AWS 高级支持与支持团队联系

本页内容

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。