翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Neptune パラメータグループ
パラメータグループの[パラメータ](parameters.md)を使用して、Amazon Neptune のデータベース設定を管理します。パラメータグループは、1 つ以上の DB インスタンスに適用されるエンジン設定値の*コンテナ*として機能します。
DB クラスターのパラメータグループと、いわゆる DB パラメータグループという、2 つのタイプの DB パラメータグループがあります。
+ *DB パラメータグループ*は、インスタンスレベルで適用され、通常 Neptune グラフエンジンに関連付けられています (例: `neptune_query_timeout` パラメータ)。
+ *DB クラスターのパラメータグループ*は、クラスター内のすべてのインスタンスに適用され、通常、より広範な設定があります。すべての Neptune クラスターは、DB クラスターパラメータグループに関連付けられます。そのクラスター内の各 DB インスタンスは、DB クラスターのパラメータグループに含まれるエンジン設定値を継承します。
DB クラスターパラメータグループで変更した設定値は、DB パラメータグループのデフォルト値を上書きします。DB パラメータグループ内の対応する値を編集すると、これらの値によって DB クラスターパラメータグループの設定が上書きされます。
カスタム DB パラメータグループを指定せずに DB インスタンスを作成した場合は、デフォルトの DB パラメータグループが使用されます。デフォルトの DB パラメータグループのパラメータ設定を変更することはできません。代わりに、デフォルトのパラメーター設定を変更するには、新しい DB パラメータグループを作成する必要があります。DB エンジンのすべてのパラメータを、作成した DB パラメータグループで変更できるわけではありません。
パラメータグループは、特定の 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 のパラメータには、静的なものと動的なものがあります。違いは次のとおりです。
**静的パラメータ**
+ 静的パラメータは、DB インスタンスが再起動された後にのみ有効になるパラメータです。言い換えると、静的パラメータを変更してインスタンスの DB パラメータグループを保存したとき、パラメータの変更を有効にするには、DB インスタンスを手動で再起動する必要があります。現在、Neptune インスタンスレベルのパラメータ (DB クラスターパラメータグループではなく DB パラメータグループ内) はすべて静的です。
+ クラスターレベルの静的パラメータを変更して、DB クラスターのパラメータグループを保存したとき、パラメータの変更は、クラスター内のすべての DB インスタンスを手動で再起動した後に有効になります。
**動的パラメータ**
+ 動的パラメータとは、パラメータグループ内のパラメータが更新されたほぼ直後に有効になるパラメータです。つまり、動的パラメータを更新した後、DB インスタンスを再起動しなくてもパラメータの変更が有効になります。
+ 動的クラスターパラメータの変更がすべての DB インスタンスに適用されるまで、多少の遅延が予想されます。
+ 更新された動的パラメータ値は、現在実行中のリクエストには適用されず、変更が行われた後に送信されたリクエストにのみ適用されます。
+ クラスターレベルの動的パラメータを変更すると、デフォルトでは、パラメータの変更は直ちに DB クラスターに適用され、再起動を必要としません。クラスター内の DB インスタンスが再起動されるまでパラメータの変更を延期するには、 AWS CLI を使用してパラメータ変更`pending-reboot`の `ApplyMethod`を に設定します。
現在、以下の新しいクラスターパラメータを除くすべてのパラメータは静的です。
+ `neptune_enable_slow_query_log` (クラスターレベル)
+ `neptune_slow_query_log_threshold` (クラスターレベル)
DB パラメータグループのパラメータを使用する際に、注意する必要がある重要な点を以下に示します。
+ DB パラメータグループに不適切な設定のパラメータがあると、パフォーマンスが低下したりシステムが不安定になったり、予期しない悪影響が生じることがあります。データベースパラメータの変更時には常に注意が必要です。DB パラメータグループの変更前にデータをバックアップしてください。テスト DB インスタンスでパラメータグループの設定の変更を試してから、本稼働 DB インスタンスにそれらの変更を適用します。
+ DB インスタンスに関連付けられている DB パラメータグループを変更する場合、DB インスタンスで新しい DB パラメータグループを使用する前に、インスタンスを手動で再起動する必要があります。
**注記**
[リリース: 1.2.0.0 (2022-07-21)](engine-releases-1.2.0.0.md) より前は、DB クラスター内のすべてのリードレプリカインスタンスは、プライマリ (ライター) インスタンスが再起動するたびに自動的に再起動されていました。
[リリース: 1.2.0.0 (2022-07-21)](engine-releases-1.2.0.0.md) 以降では、プライマリインスタンスを再起動しても、レプリカインスタンスは再起動しません。つまり、クラスターレベルのパラメータを変更する場合、パラメータの変更を反映するには、各インスタンスを個別に再起動する必要があります。
## DB クラスターパラメータグループまたは DB パラメータグループの編集
1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home) で Amazon Neptune コンソールを開きます。
1. ナビゲーションペインの [**Parameter Groups**] (パラメータグループ) を選択します。
1. 編集する DB パラメータグループの [**Name**] (名前) リンクを選択します。
(オプション) [**Create parameter group**] (パラメータグループの作成) を選択して、新しいクラスターのパラメータグループを作成しその新しいグループを作成します。その後、その新しいパラメータグループの [**Name**] (名前) を選択します。
**重要**
デフォルトの DB クラスターのパラメータグループしかない場合、このステップは*必須*です。デフォルトの DB クラスターのパラメータグループは変更できないためです。
1. パラメータを検索し、**[名前]** 列の横にある **[値]** フィールドをクリックします。
1. 許可された値を入力し、[値] フィールドの横にあるチェックを選択します。
1. **[Save changes]** (変更の保存) をクリックします。
1. DB クラスターパラメータを変更する場合は、Neptune クラスター内のすべての DB インスタンスを再起動し、DB インスタンスパラメータを変更する場合は 1 つ以上の特定のインスタンスを再起動します。
## DB パラメータグループまたは DB クラスターパラメータグループの作成
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**] (DB パラメータグループの作成) を選択します。
[**Create DB parameter group**] (DB パラメータグループの作成) ページが表示されます。
1. **パラメータグループファミリー**リストで、ターゲット Neptune エンジンのバージョン (neptune**1.2、neptune1.****3**、**neptune1.4 など**) に一致するファミリーを選択します。
1. **[タイプ]** リストで、**[DB パラメータグループ]** または **[DB クラスターのパラメータグループ]** を選択します。
1. [**グループ名**] ボックスに、新しい DB パラメータグループの名前を入力します。
1. [**説明**] ボックスに、新しい DB パラメータグループの説明を入力します。
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)
```