View a markdown version of this page

Neptune 实验室模式 - Amazon Neptune
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Neptune 实验室模式

您可以使用 Amazon Neptune 实验室模式启用当前 Neptune 引擎版本中新增的、但尚未准备好用于生产环境因而默认未启用的特征。这让您能够在开发和测试环境中试用这些功能。

使用 Neptune 实验室模式

使用 neptune_lab_mode 数据库集群参数来启用或禁用特征。为此,您可以在数据库集群参数组的 neptune_lab_mode 参数值中包含 (feature name)=enabled 或 (feature name)=disabled。

例如,在该引擎版本中,您可以将 neptune_lab_mode 参数设置为 Streams=disabled, ReadWriteConflictDetection=enabled。

有关如何编辑数据库的数据库集群参数组的信息,请参阅 编辑参数组。请注意,您无法编辑默认的数据库集群参数组。如果使用默认组,则必须先创建一个新的数据库集群参数组,然后才能设置 neptune_lab_mode 参数。

注意

当您更改静态数据库集群参数(例如 neptune_lab_mode)时,必须重启集群的主(写入器)实例才能使更改生效。在版本:1.2.0.0(2022 年 7 月 21 日) 之前,数据库集群中的所有只读副本将在主实例重启时自动重启。

从版本:1.2.0.0(2022 年 7 月 21 日) 开始,重启主实例不会导致任何副本重启。这意味着您必须分别重启每个实例,才能获得数据库集群参数的更改(请参阅参数组)。

重要

目前,如果您提供了错误的实验室模式参数,或者您的请求由于其它原因而失败,则可能不会收到失败的通知。您应始终通过调用状态 API 来验证实验室模式更改请求是否成功,如下所示:

curl -G https://your-neptune-endpoint:port/status

状态结果包括实验室模式信息,这些信息将显示您请求的更改是否已完成:

{ "status":"healthy", "startTime":"Wed Dec 29 02:29:24 UTC 2021", "dbEngineVersion":"development", "role":"writer", "dfeQueryEngine":"viaQueryHint", "gremlin":{"version":"tinkerpop-3.5.2"}, "sparql":{"version":"sparql-1.1"}, "opencypher":{"version":"Neptune-9.0.20190305-1.0"}, "labMode":{ "ObjectIndex":"disabled", "ReadWriteConflictDetection":"enabled" }, "features":{ "LookupCache":{"status":"Available"}, "ResultCache":{"status":"disabled"}, "IAMAuthentication":"disabled", "Streams":"disabled", "AuditLog":"disabled" }, "settings":{"clusterQueryTimeoutInMs":"120000"} }

当前使用实验室模式可以访问以下特征:

OSGP 索引

Neptune 现在可以维护第四个索引,即 OSGP 索引,这对于具有大量谓词的数据集非常有用(请参阅启用 OSGP 索引)。

通过在 neptune_lab_mode 数据库集群参数中设置 ObjectIndex=enabled,可以在新且空的 Neptune 数据库集群中启用 OSGP 索引。只能在新且空的数据库集群中启用 OSGP 索引。

默认情况下,OSGP 索引处于禁用状态。

注意

设置 neptune_lab_mode 数据库集群参数以启用 OSGP 索引后,必须重启集群的写入器实例才能使更改生效。

警告

如果您通过设置禁用已启用的 OSGP 索引 ObjectIndex=disabled 然后在添加更多数据后重新启用它,索引将无法正确构建。 On-demand 不支持重建索引,因此只能在数据库为空时启用 OSGP 索引。

启用字典垃圾回收

如果未通过 DictionaryGCMode 参数启用 neptune-streams,则可以为属性图形数据启用字典垃圾回收。可通过 DictionaryGCConcurrency 参数控制并发度。有关更多信息,请参阅字典垃圾回收。

形式化事务语义

Neptune 更新了并发事务的形式语义(请参阅Neptune 中的事务语义)。

在 neptune_lab_mode 参数中,将 ReadWriteConflictDetection 用作启用或禁用形式化事务语义的功能名称。

默认情况下,已启用形式化事务语义。如果要恢复为以前的行为,请在为数据库集群 neptune_lab_mode 参数设置的值中包含 ReadWriteConflictDetection=disabled。

扩展日期时间支持

Neptune 扩展了对日期时间功能的支持。要启用扩展了格式的日期时间,请在为数据库集群 neptune_lab_mode 参数设置的值中包含 DatetimeMillisecond=enabled。

StrictTimeoutValidation

注意

此功能从开始可用 海王星引擎版本 1.3.2.0。

默认值:启用(在之前默认处于禁用状态) 海王星引擎版本 1.4.0.0)

允许的值: enabled/disabled

当此参数为 enabled,指定为请求选项或查询提示的每个查询的超时值不能超过在中全局设置的值 neptune_query_timeout 参数组设置。如果每个查询的超时时间超过全局设置,Neptune 会抛出 InvalidParameterException。在 1.4.0.0 之前的引擎版本中,此参数是 disabled 默认情况下,必须明确启用。

此设置可以在回复中确认 /status 值为时的端点 disabled。

有关更多信息,请参阅 每个查询的超时。

AccurateQRCMemoryEstimation

注意

此功能从开始可用 海王星引擎版本 1.4.0.0。

默认值:已禁用

允许的值: enabled/disabled

Gremlin 查询结果缓存启用后,允许在数据库上缓存查询结果。默认情况下,近似估计值用于确定缓存结果的大小,启用此实验室模式参数 AccurateQRCMemoryEstimation 后,缓存结果的大小估计值将使用准确的大小估计值而不是近似值。此实验室模式参数从 Neptune 引擎发行版本 1.4.0.0 开始可用。

UndoLogPurgeConfig

注意

此功能从开始可用 海王星引擎版本 1.2.0.0。

默认值:default

允许的值:默认值或激进值

UndoLogPurgeConfig 控制 Neptune 清除撤消日志的激烈程度。您可以通过以下方式启用它 neptune_lab_mode 通过包括数据库集群参数 UndoLogPurgeConfig=aggressive 在参数值中。

当设置为 default,Neptune 使用标准数量的线程来清除撤消日志。当设置为 aggressive,Neptune 使用更多的线程来加快撤消日志的清理。清除线程的数量会随着实例大小而增加,因此将此设置与更大的写入器实例配对会增加撤消日志的流失速度。

撤消日志清除只能由写入器实例执行。因为 neptune_lab_mode 是一个静态参数,必须重新启动写入器实例才能更改为 UndoLogPurgeConfig 才能生效。从 Neptune 引擎版本 1.2.0.0 开始,重新启动写入器不再重新启动只读副本。如果要在故障转移时在副本上激活该设置,则必须单独重新启动该副本。

要恢复到标准清除,请设置 UndoLogPurgeConfig=default 在 neptune_lab_mode 参数并重新启动写入器实例。

激活该设置后,您可以跟踪 UndoLogListSize 和 NumUndoPagesPurged CloudWatch 用于观察生产负荷下的净流失率的指标。这在你需要携带时很有用 UndoLogListSize 低于版本升级之前所需的阈值(请参阅 从 1.2.0.0 之前的版本升级到引擎版本 1.2.0.0 或更高版本)。