本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Amazon Neptune 参数 您可以使用[参数组](parameter-groups.md)中的参数来管理 Amazon Neptune 中的数据库配置。以下参数可用于配置 Neptune 数据库： **集群级别的参数** + [neptune\_enable\_audit\_log](#parameters-db-cluster-parameters-neptune_enable_audit_log) + [neptune\_enable\_slow\_query\_log](#parameters-db-cluster-parameters-neptune_enable_slow_query_log) + [neptune\_slow\_query\_log\_threshold](#parameters-db-cluster-parameters-neptune_slow_query_log_threshold) + [neptune\_lab\_mode](#parameters-db-cluster-parameters-neptune_lab_mode) + [neptune\_query\_timeout](#parameters-db-cluster-parameters-neptune_query_timeout) + [neptune\_streams](#parameters-db-cluster-parameters-neptune_streams) + [neptune\_streams\_expiry\_days](#parameters-db-cluster-parameters-neptune_streams_expiry_days) + [neptune\_lookup\_cache](#parameters-db-cluster-parameters-neptune_lookup_cache) + [neptune\_autoscaling\_config](#parameters-db-cluster-parameters-neptune_autoscaling_config) + [neptune\_ml\_iam\_role](#parameters-db-cluster-parameters-neptune_ml_iam_role) + [neptune\_ml\_endpoint](#parameters-db-cluster-parameters-neptune_ml_endpoint) + [neptune\_enable\_inline\_server\_generated\_edge\_id](#parameters-db-cluster-parameters-neptune_inline_edge_id)   **实例级参数** + [neptune\_dfe\_query\_engine](#parameters-instance-parameters-neptune_dfe_query_engine) + [neptune\_query\_timeout](#parameters-instance-parameters-neptune_query_timeout) + [neptune\_result\_cache](#parameters-db-instance-parameters-neptune_result_cache) + [UndoLogPurgeConfig](#parameters-db-instance-parameters-undo_log_purge_config)   **弃用的参数** + [neptune\_enforce\_ssl](#parameters-db-cluster-parameters-neptune_enforce_ssl) ## `neptune_enable_audit_log`（集群级参数） 此参数切换 Neptune 的审计日志记录。 允许的值为 `0`（禁用）和 `1`（启用）。默认值为 `0`。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 您可以将审核日志发布到 Amazon CloudWatch，如中所述[使用 CLI 将 Neptune 审核日志发布到日志 CloudWatch](cloudwatch-logs.md#cloudwatch-logs-cli)。 ## `neptune_enable_slow_query_log`（集群级参数） 使用此参数启用或禁用 Neptune 的[慢速查询日志记录](slow-query-logs.md)特征。 这是一个动态参数，意味着更改其值不需要或导致数据库集群重启。 允许的值包括： + **`info`** – 启用慢速查询日志记录并记录可能导致性能下降的选定属性。 + **`debug`** – 启用慢速查询日志记录并记录查询运行的所有可用属性。 + **`disabled`** – 禁用慢速查询日志记录。 默认值为 `disabled`。 您可以将慢速查询日志发布到 Amazon CloudWatch，如中所述。[使用 CLI 将 Neptune 慢速查询日志发布到日志 CloudWatch](cloudwatch-logs.md#cloudwatch-slow-query-logs-cli) ## `neptune_slow_query_log_threshold`（集群级参数） 此参数以毫秒为单位指定执行时间阈值，超过该阈值后，查询被视为慢速查询。如果启用[慢速查询日志记录](slow-query-logs.md)，则运行时间超过此阈值的查询将与其某些属性一起记录。 默认值为 5000 毫秒（5 秒）。 这是一个动态参数，意味着更改其值不需要或导致数据库集群重启。 ## `neptune_lab_mode`（集群级参数） 设置此项后，该参数将启用 Neptune 的特定实验性特征。有关当前可用的实验性功能，请参阅[Neptune 实验室模式](features-lab-mode.md)。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 默认情况下，通常禁用实验室模式特征。要启用或显式禁用实验功能，请在此参数{{(feature name)}}`=disabled`中包含{{(feature name)}}`=enabled`或。可以通过用逗号分隔多个功能来启用或禁用它们，如下所示： {{(feature \#1 name)}}`=enabled,` {{(feature \#2 name)}}`=enabled` ## `neptune_query_timeout`（集群级参数） 指定图形查询的特定超时持续时间（以毫秒为单位）。 允许值的范围为 `10` 到 `2,147,483,647` (231 - 1)。默认值为 `120,000`（2 分钟）。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 配置多个超时设置（集群级别、实例级别和每个查询）时，下表显示了哪个超时值优先： | 集群 PG | 实例 PG | 查询提示 | 结果 | | --- | --- | --- | --- | | 默认 | 默认 | none | Cluster | | 自定义 | 默认 | none | Cluster | | 自定义 | 自定义 | none | 实例 | | 默认 | 自定义 | none | 实例 | | Any | Any | 最低 | Query | | 默认 | 自定义 | 不是最低的 | 实例 | | 自定义 | 默认 | 不是最低的 | Cluster | | 自定义 | 自定义 | 不是最低的 | 实例 | **注意** 如果您将查询超时值设置得过高，可能会产生意想不到的成本，尤其是在无服务器实例上。如果没有合理的超时设置，您可能会无意中发出一个持续运行时间比预期长得多的查询，从而产生您意想不到的成本。在运行查询时可以纵向扩展到昂贵的大型实例类型的无服务器实例上尤其如此。 您可以使用查询超时值来避免此类意外开支，该值可以容纳您的大多数查询，并且只会导致长时间运行的查询意外超时。 ## `neptune_streams`（集群级参数） 启用或禁用 [Neptune Streams](streams.md)。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 允许的值为 `0`（默认禁用）和 `1`（启用）。 ## `neptune_streams_expiry_days`（集群级参数） 指定服务器删除流记录之前的天数。 允许的值为 `1` 到 `90`（含）。默认值为 `7`。 该参数是在[引擎版本 1.2.0.0](engine-releases-1.2.0.0.md) 中引入的。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 ## `neptune_lookup_cache`（集群级参数） 在 `R5d` 实例上禁用或重新启用 [Neptune 查找缓存](feature-overview-lookup-cache.md)。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 允许的值为 `1`（启用）和 `0`（禁用）。默认值为 `0`，但是每当在数据库集群中创建 `R5d` 实例时，`neptune_lookup_cache` 参数都会自动设置为 `1`，并在该实例上创建查找缓存。 ## `neptune_autoscaling_config`（集群级参数） 为 [Neptune 自动扩缩](manage-console-autoscaling.md)创建和管理的只读副本实例设置配置参数。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 使用您设置为 `neptune_autoscaling_config` 参数值的 JSON 字符串，可以指定： + Neptune 自动扩缩为它所创建的所有新的只读副本实例使用的实例类型。 + 分配给这些只读副本的维护时段。 + 要与所有新的只读副本关联的标签。 JSON 字符串的结构如下所示： ``` "{ \"tags\": [ { \"key\" : \"{{reader tag-0 key}}\", \"value\" : \"{{reader tag-0 value}}\" }, { \"key\" : \"{{reader tag-1 key}}\", \"value\" : \"{{reader tag-1 value}}\" }, ], \"maintenanceWindow\" : \"{{wed:12:03-wed:12:33}}\", \"dbInstanceClass\" : \"db.r5.xlarge\" }" ``` 请注意，字符串中的引号必须全部使用反斜杠字符 (`\`) 进行转义。 `neptune_autoscaling_config` 参数中未指定的三个配置设置中的任何一个都是从数据库集群的主写入器实例的配置中复制的。 ## `neptune_ml_iam_role`（集群级参数） 指定 Neptune ML 中使用的 IAM 角色 ARN。该值可以是任何有效的 IAM 角色 ARN。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 您可以在图形上为机器学习指定默认 IAM 角色 ARN。 ## `neptune_ml_endpoint`（集群级参数） 指定用于 Neptune ML 的端点。该值可以是任何有效的 [SageMaker AI 终端节点名称](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateEndpoint.html#sagemaker-CreateEndpoint-request-EndpointName)。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 您可以在图表上为机器学习指定默认 SageMaker AI 端点。 ## `neptune_enable_inline_server_generated_edge_id`（集群级参数） 启用或禁用 Neptune 内联服务器生成的 Edge ID 功能。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 允许的值为 `1`（启用）和 `0`（禁用）。默认值为 `0`。 ## `neptune_dfe_query_engine`（实例级参数） 此数据库实例参数控制 [DFE 查询引擎](neptune-dfe-engine.md)的使用方式。允许的值如下所示： 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 + **`enabled`** – 使得尽可能使用 DFE 引擎，但 `useDFE` 查询提示存在并设置为 `false` 除外。 + **`viaQueryHint`**（默认）– 使得 DFE 引擎仅用于显式包含设置为 `true` 的 `useDFE` 查询提示的查询。 如果未显式设置此参数，则实例启动时将使用默认值 `viaQueryHint`。 **注意** 无论如何设置此参数，所有 openCypher 查询都由 DFE 引擎执行。 ## `neptune_query_timeout`（实例级参数） 此数据库实例参数为一个实例指定图形查询的超时时间，以毫秒为单位。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 允许值的范围为 `10` 到 `2,147,483,647` (231 - 1)。默认值为 `120,000`（2 分钟）。 **注意** 如果您将查询超时值设置得过高，可能会产生意想不到的成本，尤其是在无服务器实例上。如果没有合理的超时设置，您可能会无意中发出一个持续运行时间比预期长得多的查询，从而产生您意想不到的成本。在运行查询时可以纵向扩展到昂贵的大型实例类型的无服务器实例上尤其如此。 您可以使用查询超时值来避免此类意外开支，该值可以容纳您的大多数查询，并且只会导致长时间运行的查询意外超时。 ## `neptune_result_cache`（实例级参数） **`neptune_result_cache`** – 此数据库实例参数启用或禁用 [缓存查询结果](gremlin-results-cache.md)。 此参数是静态的，这意味着在任何实例重启之前，对其所做的更改不会在该实例上生效。 允许的值为 `0`（禁用，默认值）和 `1`（启用）。 ## `UndoLogPurgeConfig`（实例级参数） **`UndoLogPurgeConfig`**— 使用此参数在 Neptune 中启用或禁用主动 UndoLog 清除。 允许的值是 `default` 和 `aggressive`，前者会使用标准的线程数进行撤消日志清除，而后者则会使用增加的线程数来加快撤消日志的清理。选择 `agressive` 选项后，您可能会看到更高的 `NumUndoPagesPurged` 指标值。 ## `neptune_enforce_ssl`（弃用的集群级参数） （**已弃用**）过去有些区域允许 HTTP 连接到 Neptune，当此参数设置为 1 时，用于强制所有连接使用 HTTPS。但是，此参数不再相关，因为 Neptune 现在在所有区域中仅接受 HTTPS 连接。