

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

# Amazon Neptune 參數群組
<a name="parameter-groups"></a>

您可以使用參數群組中的[參數](parameters.md)，在 Amazon Neptune 中管理資料庫組態。參數群組扮演引擎組態值的*容器*，以套用至一或多個資料庫執行個體。

參數群組有兩種類型，即資料庫叢集參數群組和資料庫參數群組。
+ 「資料庫參數群組」**會在執行個體層級套用，並且一般都會和 Neptune 圖形引擎的設定建立關聯，例如 `neptune_query_timeout` 參數。
+ 「資料庫叢集參數群組」**會套用到叢集中的每個執行個體，並且一般擁有較廣的設定。每個 Neptune 叢集都會與一個資料庫叢集參數群組相關聯。該叢集內的每個資料庫執行個體會繼承包含在資料庫叢集參數群組中的引擎組態值。

您在資料庫叢集參數群組中修改的任何組態值，都會覆寫資料庫參數群組中的預設值。若您在資料庫參數群組中編輯對應的值，則那些值會覆寫資料庫叢集參數群組中的設定。

如果您建立資料庫執行個體而未指定自訂資料庫參數群組，將會使用預設的資料庫參數群組。您無法修改預設資料庫參數群組的參數設定。相反，若要變更預設參數設定，您必須建立新的資料庫參數群組。並非所有資料庫引擎參數都可以在您建立的資料庫參數群組中變更。

參數群組會在與特定 Neptune 引擎版本相容的系列中建立。當您升級至新的主要或次要引擎版本時，您可能需要使用該版本的對應參數群組系列重新建立自訂參數群組。

參數群組系列命名遵循模式 `neptuneX.Y`，其中 `X.Y`符合引擎版本。例如：
+ `neptune1` – 適用於 1.2.0.0 之前的引擎版本
+ `neptune1.2` – 適用於引擎 1.2.x 版
+ `neptune1.3` – 適用於引擎 1.3.x 版
+ `neptune1.4` – 適用於引擎 1.4.x 版

升級 Neptune 叢集時，請檢查目標引擎版本的[版本備註](engine-releases.md)，以判斷是否需要新的參數群組系列。若是如此，您必須先在新系列中重新建立所有自訂參數群組，才能升級。

有些 Neptune 參數是靜態的，而其他參數是動態的。差異如下所示：

**靜態參數**
+ 靜態參數是指僅在資料庫執行個體重新啟動後才會生效的參數。換言之，當您變更靜態參數並儲存執行個體資料庫參數群組時，您必須手動重新啟動資料庫執行個體，參數變更才會生效。目前，所有 Neptune 執行個體層級參數 (位於資料庫參數群組中，而非資料庫叢集參數群組中) 都是靜態的。
+ 當您變更叢集層級靜態參數並儲存資料庫叢集參數群組時，參數變更會在您手動重新啟動叢集中的每個資料庫執行個體之後生效。

**動態參數**
+ 動態參數是指在參數群組中更新參數之後幾乎立即生效的參數。換言之，在更新動態參數之後，不需要重新啟動資料庫執行個體，參數變更就會生效。
+ 對於要跨所有資料庫執行個體套用的動態叢集參數變更，預期會有些微的延遲。
+ 更新的動態參數值不會套用至目前執行中的請求，而只會套用至變更發生後提交的請求。
+ 變更動態叢集層級參數時，根據預設，參數變更會立即套用至資料庫叢集，無需任何重新啟動。若要將參數變更延遲到叢集中的資料庫執行個體重新啟動之後，您可以使用 AWS CLI 將參數變更`ApplyMethod``pending-reboot`的 設定為 。

目前，除了下列新叢集參數以外，所有參數都是靜態的：
+ `neptune_enable_slow_query_log` (叢集層級)
+ `neptune_slow_query_log_threshold` (叢集層級)

以下是使用資料庫參數群組中的參數時，您應該知道的一些重要提示：
+ 未正確設定資料庫參數群組中的參數，可能產生各種意外影響，包括降低效能和系統不穩定。修改資料庫參數時請務必謹慎，在修改資料庫參數群組之前，請備份您的資料。在建參數群組設定變更套用到生產資料庫執行個體之前，請先在測試資料庫執行個體上嘗試這些變更。
+ 變更與資料庫執行個體關聯的資料庫參數群組時，您必須手動重新啟動執行個體，資料庫執行個體才會使用新的資料庫參數群組。
**注意**  
在 [版本：1.2.0.0 (2022 年 7 月 21 日)](engine-releases-1.2.0.0.md) 之前，每當主要 (寫入器) 執行個體重新啟動時，資料庫叢集中的所有僅供讀取複本執行個體都會自動重新啟動  
從 [版本：1.2.0.0 (2022 年 7 月 21 日)](engine-releases-1.2.0.0.md) 開始，重新啟動主執行個體並不會導致任何複本執行個體重新啟動。這表示如果您要變更叢集層級參數，必須個別重新啟動每個執行個體，才能接收參數變更。

## 編輯資料庫叢集參數群組或資料庫參數群組
<a name="parameters-editgroup"></a>

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home)：// 開啟 Amazon Neptune 主控台。

1. 在導覽窗格中，選擇 **Parameter groups** (參數群組)。

1. 選擇您要編輯的資料庫參數群組的 **Name** (名稱) 連結。

   (選用) 選擇 **Create parameter group** (建立參數群組) 來建立新的叢集參數群組，然後建立新的群組。然後，選擇新參數群組的 **Name** (名稱)。
**重要**  
若因為無法修改預設資料庫叢集參數群組，因此您只有預設的資料庫叢集參數群組，則此步驟是「必要」**的。

1. 搜尋 參數，然後按一下**名稱**欄旁的**值**欄位。

1. 輸入允許的值，然後選擇值欄位旁的檢查。

1. 選擇**儲存變更**。

1. 如果您要變更資料庫叢集參數，請重新啟動 Neptune 叢集中的每個資料庫執行個體，或如果要變更資料庫執行個體參數，請重新啟動一或多個特定執行個體。

## 建立資料庫叢集參數群組或資料庫參數群組
<a name="parameters-creategroup"></a>

您可以輕鬆地使用 Neptune 主控台建立新的參數群組。

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home)：// 開啟 Amazon Neptune 主控台。

1. 在左側導覽窗格中，選擇 **Parameter groups** (參數群組)。

1. 選擇 **Create DB parameter group** (建立資料庫參數群組)。

   **Create DB parameter group** (建立資料庫參數群組) 頁面隨即出現。

1. 在**參數群組系列**清單中，選擇符合您目標 Neptune 引擎版本的系列 （例如 **neptune1.2**、**neptune1.3** 或 **neptune1.4)。**

1. 在 **Type** (類型) 清單中選擇 **DB Parameter Group** (資料庫參數群組) 或 **DB Cluster Parameter Group** (資料庫叢集參數群組)。

1. 在 **Group name** (群組名稱) 方塊中輸入新資料庫參數群組的名稱。

1. 在 **Description** (描述) 方塊中輸入新資料庫參數群組的描述。

1. 選擇**建立**。

您也可以使用 AWS CLI建立新的參數群組：

```
aws neptune create-db-parameter-group \
  --db-parameter-group-name (a name for the new DB parameter group) \
  --db-parameter-group-family (the family matching your engine version, such as neptune1.2, neptune1.3, or neptune1.4) \
  --description (a description for the new DB parameter group)
```