

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Neptune 參數
<a name="parameters"></a>

您可以使用[參數群組](parameter-groups.md)中的參數，在 Amazon Neptune 中管理資料庫組態。下列參數可用於設定 Neptune 資料庫：

**叢集層級參數**
+ [neptune\$1enable\$1audit\$1log](#parameters-db-cluster-parameters-neptune_enable_audit_log)
+ [neptune\$1enable\$1slow\$1query\$1log](#parameters-db-cluster-parameters-neptune_enable_slow_query_log)
+ [neptune\$1slow\$1query\$1log\$1threshold](#parameters-db-cluster-parameters-neptune_slow_query_log_threshold)
+ [neptune\$1lab\$1mode](#parameters-db-cluster-parameters-neptune_lab_mode)
+ [neptune\$1query\$1timeout](#parameters-db-cluster-parameters-neptune_query_timeout)
+ [neptune\$1streams](#parameters-db-cluster-parameters-neptune_streams)
+ [neptune\$1streams\$1expiry\$1days](#parameters-db-cluster-parameters-neptune_streams_expiry_days)
+ [neptune\$1lookup\$1cache](#parameters-db-cluster-parameters-neptune_lookup_cache)
+ [neptune\$1autoscaling\$1config](#parameters-db-cluster-parameters-neptune_autoscaling_config)
+ [neptune\$1ml\$1iam\$1role](#parameters-db-cluster-parameters-neptune_ml_iam_role)
+ [neptune\$1ml\$1endpoint](#parameters-db-cluster-parameters-neptune_ml_endpoint)
+ [neptune\$1enable\$1inline\$1server\$1generated\$1edge\$1id](#parameters-db-cluster-parameters-neptune_inline_edge_id)

   

**執行個體層級參數**
+ [neptune\$1dfe\$1query\$1engine](#parameters-instance-parameters-neptune_dfe_query_engine)
+ [neptune\$1query\$1timeout](#parameters-instance-parameters-neptune_query_timeout)
+ [neptune\$1result\$1cache](#parameters-db-instance-parameters-neptune_result_cache)
+ [UndoLogPurgeConfig](#parameters-db-instance-parameters-undo_log_purge_config)

   

**已棄用的參數**
+ [neptune\$1enforce\$1ssl](#parameters-db-cluster-parameters-neptune_enforce_ssl)

## `neptune_enable_audit_log` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_enable_audit_log"></a>

此參數可切換 Neptune 的稽核記錄。

允許的值為 `0` (已停用) 和 `1` (已啟用)。預設值為 `0`。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

您可以將稽核日誌發佈到 Amazon CloudWatch，如 [使用 CLI 將 Neptune 稽核日誌發佈至 CloudWatch Logs](cloudwatch-logs.md#cloudwatch-logs-cli) 中所述。

## `neptune_enable_slow_query_log` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_enable_slow_query_log"></a>

使用此參數可啟用或停用 Neptune 的[慢速查詢記錄](slow-query-logs.md)功能。

這是一個動態參數，表示變更其值不需要也不會導致資料庫叢集重新啟動。

允許的值為：
+ **`info`** – 啟用慢速查詢記錄，並記錄可能造成效能降低的所選屬性。
+ **`debug`** – 啟用慢速查詢記錄，並記錄查詢執行的所有可用屬性。
+ **`disabled`** – 停用慢速查詢記錄。

預設值為 `disabled`。

您可以將慢速查詢日誌發佈到 Amazon CloudWatch，如 [使用 CLI 將 Neptune 慢查詢日誌發佈至 CloudWatch Logs](cloudwatch-logs.md#cloudwatch-slow-query-logs-cli) 中所述。

## `neptune_slow_query_log_threshold` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_slow_query_log_threshold"></a>

此參數指定執行時間閾值 (以毫秒為單位)，而執行時間超過此閾值的查詢會被視為緩慢查詢。如果啟用了[慢速查詢記錄](slow-query-logs.md)，則執行時間超過此閾值的查詢將與其某些屬性一起記錄。

預設值為 5000 毫秒 (5 秒)。

這是一個動態參數，表示變更其值不需要也不會導致資料庫叢集重新啟動。

## `neptune_lab_mode` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_lab_mode"></a>

設定後，此參數會啟用 Neptune 的特定實驗性功能。如需目前可用的實驗性功能，請參閱[Neptune 實驗室模式](features-lab-mode.md)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

實驗室模式功能通常預設為停用。若要啟用或停用實驗功能，請在此參數中包含 *（功能名稱）*`=enabled` 或 *（功能名稱）*`=disabled`。您可以啟用或停用多個功能，方法為使用逗號區隔它們，如下所示：

*(feature \$11 name)*`=enabled,` *(feature \$12 name)*`=enabled`

## `neptune_query_timeout` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_query_timeout"></a>

指定圖形查詢的特定逾時持續時間 (以毫秒為單位)。

允許的值範圍從 `10` 到 `2,147,483,647` (231 -1)。預設值為 `120,000` (2 分鐘)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

設定多個逾時設定 （叢集層級、執行個體層級和每個查詢） 時，下表顯示哪個逾時值優先：


| 叢集 PG | 執行個體 PG | 查詢提示 | 結果 | 
| --- | --- | --- | --- | 
| 預設 | 預設 | 無 | 叢集 | 
| Custom | 預設 | 無 | 叢集 | 
| Custom | Custom | 無 | 執行個體 | 
| 預設 | Custom | 無 | 執行個體 | 
| 任何 | 任何 | 最低 | Query | 
| 預設 | Custom | 不最低 | 執行個體 | 
| Custom | 預設 | 不最低 | 叢集 | 
| Custom | Custom | 不最低 | 執行個體 | 

**注意**  
如果您將查詢逾時值設得太高，特別是在無伺服器執行個體上，可能會產生非預期的成本。若沒有合理的逾時設定，您可能會不小心發出其執行時間可能會比預期長得多的查詢，進而產生您從未預期的成本。這在無伺服器執行個體上尤是如此，因為該執行個體在執行查詢時可能會縱向擴展為大型且昂貴的執行個體類型。  
您可以使用查詢逾時值，避免此類非預期的費用，而這些逾時值符合大部分的查詢，且只會導致執行時間異常長的查詢逾時。

## `neptune_streams` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_streams"></a>

啟用或停用 [Neptune 串流](streams.md)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

允許值為 `0` (停用，此為預設值) 和 `1` (啟用)。

## `neptune_streams_expiry_days` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_streams_expiry_days"></a>

指定伺服器在經過多少天後就會刪除串流記錄。

允許的值從 `1` 到 `90` (含)。預設值為 `7`。

此參數是在[引擎 1.2.0.0 版](engine-releases-1.2.0.0.md)中引進的。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

## `neptune_lookup_cache` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_lookup_cache"></a>

在 `R5d` 執行個體上，停用或重新啟用 [Neptune 查閱快取](feature-overview-lookup-cache.md)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

允許的值為 `1`（啟用） 和 `0`（停用）。預設值為 `0`，但無論何時在資料庫叢集中建立 `R5d` 執行個體，都會自動將 `neptune_lookup_cache` 參數設定為 `1`，並在該執行個體上建立查閱快取。

## `neptune_autoscaling_config` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_autoscaling_config"></a>

為 [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` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_ml_iam_role"></a>

指定 Neptune ML 中使用的 IAM 角色 ARN。此值可以是任何有效的 IAM 角色 ARN。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

您可以在圖形上指定機器學習的預設 IAM 角色 ARN。

## `neptune_ml_endpoint` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_ml_endpoint"></a>

指定用於 Neptune ML 的端點。此值可以是任何有效的 [SageMaker AI 端點名稱](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEndpoint.html#sagemaker-CreateEndpoint-request-EndpointName)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

您可以在圖形上指定機器學習的預設 SageMaker AI 端點。

## `neptune_enable_inline_server_generated_edge_id` (叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_inline_edge_id"></a>

 啟用或停用 Neptune 內嵌伺服器產生的 Edge ID 功能。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

允許的值為 `1`（啟用） 和 `0`（停用）。預設值為 `0`。

## `neptune_dfe_query_engine` (執行個體層級參數)
<a name="parameters-instance-parameters-neptune_dfe_query_engine"></a>

此資料庫執行個體參數控制如何使用 [DFE 查詢引擎](neptune-dfe-engine.md)。允許的值如下：

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。
+ **`enabled`** – 盡可能使用 DFE 引擎，但在 `useDFE` 查詢提示存在且設定為 `false` 的情況下除外。
+ **`viaQueryHint`** (預設值) – 使 DFE 引擎僅用於明確包含 `useDFE` 查詢提示 (設定為 `true`) 的查詢。

如果尚未明確設定此參數，則會在啟動執行個體時使用預設值 `viaQueryHint`。

**注意**  
無論如何設定此參數，所有 OpenCypher 查詢都是由 DFE 引擎執行。

## `neptune_query_timeout` (執行個體層級參數)
<a name="parameters-instance-parameters-neptune_query_timeout"></a>

此資料庫執行個體參數會針對一個執行個體指定圖形查詢的逾時持續時間 (以毫秒為單位)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

允許的值範圍從 `10` 到 `2,147,483,647` (231 -1)。預設值為 `120,000` (2 分鐘)。

**注意**  
如果您將查詢逾時值設得太高，特別是在無伺服器執行個體上，可能會產生非預期的成本。若沒有合理的逾時設定，您可能會不小心發出其執行時間可能會比預期長得多的查詢，進而產生您從未預期的成本。這在無伺服器執行個體上尤是如此，因為該執行個體在執行查詢時可能會縱向擴展為大型且昂貴的執行個體類型。  
您可以使用查詢逾時值，避免此類非預期的費用，而這些逾時值符合大部分的查詢，且只會導致執行時間異常長的查詢逾時。

## `neptune_result_cache` (執行個體層級參數)
<a name="parameters-db-instance-parameters-neptune_result_cache"></a>

**`neptune_result_cache`** – 此資料庫執行個體參數會啟用或停用 [快取查詢結果](gremlin-results-cache.md)。

此參數是靜態的，表示對其所做的變更不會在任何執行個體上生效，直到重新啟動了該執行個體。

允許值為 `0` (停用，此為預設值) 和 `1` (啟用)。

## `UndoLogPurgeConfig` (執行個體層級參數)
<a name="parameters-db-instance-parameters-undo_log_purge_config"></a>

**`UndoLogPurgeConfig`**   –   使用此參數可在 Neptune 中啟用或停用積極的 UndoLog 清除。

允許的值為 `default`，其利用標準數量的執行緒來復原日誌清除，而 `aggressive`則使用更多執行緒來加速復原日誌的清除。選取 `agressive`選項時，您可以預期 會觀察`NumUndoPagesPurged`指標的擁抱值。

## `neptune_enforce_ssl` (DEPRECATED 叢集層級參數)
<a name="parameters-db-cluster-parameters-neptune_enforce_ssl"></a>

(**已棄用**) 曾經有允許 HTTP 連線至 Neptune 的區域，而且此參數用來在其設定為 1 時強制所有連線都使用 HTTPS。不過，這個參數不再相關，因為 Neptune 現在只在所有區域中接受 HTTPS 連線。