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 エンジンバージョンと互換性のあるファミリーで作成されます。デフォルトのパラメータグループファミリーは neptune1 であり、1.2.0.0 より前のすべてのエンジンバージョンと互換性があります。リリース: 1.2.0.0 (2022-07-21) 以降では、代わりに neptune1.2 パラメータグループファミリーを使用する必要があります。つまり、1.2.0.0 以上にアップグレードするときには、まず、すべてのカスタムパラメータグループを neptune1.2 ファミリーで作成して、アップグレード時にアタッチできるようにする必要があります。

Neptune のパラメータには、静的なものと動的なものがあります。違いは次のとおりです。

静的パラメータ

  • 静的パラメータは、DB インスタンスが再起動された後にのみ有効になるパラメータです。言い換えると、静的パラメータを変更してインスタンスの DB パラメータグループを保存したとき、パラメータの変更を有効にするには、DB インスタンスを手動で再起動する必要があります。現在、Neptune インスタンスレベルのパラメータ (DB クラスターパラメータグループではなく DB パラメータグループ内) はすべて静的です。

  • クラスターレベルの静的パラメータを変更して、DB クラスターのパラメータグループを保存したとき、パラメータの変更は、クラスター内のすべての DB インスタンスを手動で再起動した後に有効になります。

動的パラメータ

  • 動的パラメータとは、パラメータグループ内のパラメータが更新されたほぼ直後に有効になるパラメータです。つまり、動的パラメータを更新した後、DB インスタンスを再起動しなくてもパラメータの変更が有効になります。

  • 動的クラスターパラメータの変更がすべての DB インスタンスに適用されるまで、多少の遅延が予想されます。

  • 更新された動的パラメータ値は、現在実行中のリクエストには適用されず、変更が行われた後に送信されたリクエストにのみ適用されます。

  • クラスターレベルの動的パラメータを変更すると、デフォルトでは、パラメータの変更は直ちに DB クラスターに適用され、再起動を必要としません。パラメータの変更を、クラスター内の DB インスタンスが再起動されるまで延期するには、AWS CLI を使用して、パラメータの変更について ApplyMethodpending-reboot に設定します。

現在、以下の新しいクラスターパラメータを除くすべてのパラメータは静的です。

  • 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 マネジメントコンソールにサインインして Amazon Neptune コンソール (https://console.aws.amazon.com/neptune/home) を開きます。

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

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

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

    重要

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

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

  5. 使用できる値を入力し、値フィールドの横にあるチェックを選択します。

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

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

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

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

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

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

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

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

  4. [パラメータグループファミリー] リストで [neptune1] を選択するか、エンジンバージョン 1.2.0.0 以降をターゲットにする場合は [neptune1.2] を選択します。

  5. [Type] (タイプ) リストで、[DB Parameter Group] (DB パラメータグループ) または [DB Cluster Parameter Group] (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 (either neptune1 or neptune1.2, depending on the engine version) \ --description (a description for the new DB parameter group)