Amazon Neptune パラメータグループ - Amazon Neptune
パラメータグループを編集するパラメータグループを作成する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Neptune パラメータグループ

パラメータグループのパラメータを使用して、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 クラスターをアップグレードするときは、ターゲットエンジンバージョンのリリースノートをチェックして、新しいパラメータグループファミリーが必要かどうかを確認します。その場合は、アップグレードする前に新しいファミリー内のすべてのカスタムパラメータグループを再作成する必要があります。

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) より前は、DB クラスター内のすべてのリードレプリカインスタンスは、プライマリ (ライター) インスタンスが再起動するたびに自動的に再起動されていました。

    リリース: 1.2.0.0 (2022-07-21) 以降では、プライマリインスタンスを再起動しても、レプリカインスタンスは再起動しません。つまり、クラスターレベルのパラメータを変更する場合、パラメータの変更を反映するには、各インスタンスを個別に再起動する必要があります。

DB クラスターパラメータグループまたは DB パラメータグループの編集

  1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/neptune/home で Amazon Neptune コンソールを開きます。

  2. ナビゲーションペインの [Parameter Groups] (パラメータグループ) を選択します。

  3. 編集する DB パラメータグループの [Name] (名前) リンクを選択します。

    (オプション) [Create parameter group] (パラメータグループの作成) を選択して、新しいクラスターのパラメータグループを作成しその新しいグループを作成します。その後、その新しいパラメータグループの [Name] (名前) を選択します。

    重要

    デフォルトの DB クラスターのパラメータグループしかない場合、このステップは必須です。デフォルトの DB クラスターのパラメータグループは変更できないためです。

  4. パラメータを検索し、[名前] 列の横にある [値] フィールドをクリックします。

  5. 許可された値を入力し、[値] フィールドの横にあるチェックを選択します。

  6. [Save changes] (変更の保存) をクリックします。

  7. DB クラスターパラメータを変更する場合は、Neptune クラスター内のすべての DB インスタンスを再起動し、DB インスタンスパラメータを変更する場合は 1 つ以上の特定のインスタンスを再起動します。

DB パラメータグループまたは DB クラスターパラメータグループの作成

Neptune コンソールを使用して、新しいパラメータグループを簡単に作成できます。

  1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/neptune/home で Amazon Neptune コンソールを開きます。

  2. 左のナビゲーションペインの [Parameter Groups] (パラメータグループ) を選択します。

  3. [Create DB parameter group] (DB パラメータグループの作成) を選択します。

    [Create DB parameter group] (DB パラメータグループの作成) ページが表示されます。

  4. パラメータグループファミリーリストで、ターゲット Neptune エンジンのバージョン (neptune1.2、neptune1.3、neptune1.4 など) に一致するファミリーを選択します。

  5. [タイプ] リストで、[DB パラメータグループ] または [DB クラスターのパラメータグループ] を選択します。

  6. [グループ名] ボックスに、新しい DB パラメータグループの名前を入力します。

  7. [説明] ボックスに、新しい DB パラメータグループの説明を入力します。

  8. [作成] を選択します。

また、 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)