CloudConsole

RDS のパラメータグループの仕組み

更新日 2026年11月17日 · ガイドの執筆と確認の方法

要点

DB パラメータグループは、RDS インスタンスのエンジンの設定を保持します。デフォルトのグループは変更できないため、適切なファミリー(たとえば mysql8.0 や postgres16)のカスタムグループを作成し、そこでパラメータを変更してインスタンスに関連付けます。動的パラメータはすぐに適用されます。静的パラメータと、新しく関連付けたグループは、再起動のあとでしか有効にならず、それまでインスタンスは pending-reboot と表示されます。グループの変更は、それを使うすべてのインスタンスに影響します。

図:パラメータの変更が有効になるタイミング。動的パラメータ:カスタムグループで変更 → すぐに適用…
この設定が作用する場所を、このページのデフォルト値と設定可能な値とともに示したもの。

主な概念

概念意味
デフォルトのパラメータグループ(default.mysql8.0)読み取り専用。カスタムグループなしで作成したインスタンスはすべてこれを使う
カスタム DB パラメータグループ編集できるデフォルトのコピー。1 つのファミリーに紐づく
ファミリーエンジンとメジャーバージョン(mysql8.0、postgres16)。メジャーバージョンのアップグレードには新しいファミリーのグループが必要
動的パラメータ関連付けたすべてのインスタンスにすぐ適用される(ApplyMethod=immediate)
静的パラメータ各インスタンスを再起動してから適用される(pending-reboot)
数式の値{DBInstanceClassMemory/12582880} のようなデフォルト値はインスタンスのサイズに比例する
DB クラスターパラメータグループマルチ AZ DB クラスターと Aurora 用。クラスター全体の設定

新しいグループのインスタンスへの関連付けはすぐに行われますが、その値(静的も動的も)が適用されるのは次の再起動のあとです。

よく変更されるパラメータ

エンジンパラメータ理由
MySQLmax_connections通常は数式のままにする。最大接続数 (EN)を参照
MySQLslow_query_log, long_query_time遅いクエリを見つける(動的)
MySQLwait_timeout, interactive_timeoutアイドル状態の接続を閉じる
MySQLbinlog_formatレプリケーションのツールの要件
PostgreSQLlog_min_duration_statement遅いステートメントをログに出す(動的)
PostgreSQLidle_in_transaction_session_timeout開いたトランザクションで止まったセッションを終了する
PostgreSQLshared_preload_librariespg_stat_statements などの拡張機能を読み込む(静的)
PostgreSQLrds.force_sslTLS 接続を必須にする
PostgreSQLmax_connections, work_mem接続ごと、ソートごとのメモリ。慎重に変更する

作成、変更、適用

# Create a custom group and attach it
aws rds create-db-parameter-group --db-parameter-group-name app-postgres16 \
  --db-parameter-group-family postgres16 --description "orders-db settings"

aws rds modify-db-parameter-group --db-parameter-group-name app-postgres16 \
  --parameters "ParameterName=log_min_duration_statement,ParameterValue=500,ApplyMethod=immediate" \
               "ParameterName=shared_preload_libraries,ParameterValue=pg_stat_statements,ApplyMethod=pending-reboot"

aws rds modify-db-instance --db-instance-identifier orders-db \
  --db-parameter-group-name app-postgres16 --apply-immediately

# Is a reboot pending?
aws rds describe-db-instances --db-instance-identifier orders-db \
  --query 'DBInstances[0].DBParameterGroups[].[DBParameterGroupName,ParameterApplyStatus]'

# What you changed from the defaults
aws rds describe-db-parameters --db-parameter-group-name app-postgres16 --source user \
  --query 'Parameters[].[ParameterName,ParameterValue,ApplyType]' --output table

静かな時間帯に再起動するか、次のメンテナンスウィンドウに任せます。マルチ AZ のインスタンスはフェイルオーバー付きで再起動し、停止時間を短くできます。

CloudFormation:Family、Description、Parameters(名前と値のマップ)を持つ AWS::RDS::DBParameterGroup を、AWS::RDS::DBInstance の DBParameterGroupName で参照します。Terraform:family と parameter { name, value, apply_method } を持つ aws_db_parameter_group を、aws_db_instance の parameter_group_name で参照します。

障害を招く間違い

  • 共有のグループ:本番とステージングで 1 つのカスタムグループを使うと、「ステージング」の変更が本番に及びます。環境やワークロードごとにグループを分けましょう。
  • 忘れられた pending-reboot:静的な変更は、誰かが再起動するかメンテナンスが走るまで黙って待ち、そのときに予期せず動作を変えます。変更のたびに ParameterApplyStatus を確認しましょう。
  • メモリを多く使う値:max_connections、work_mem、バッファのサイズをインスタンスのメモリを超えて引き上げると、インスタンスが起動できず incompatible-parameters の状態になることがあります。
  • メジャーアップグレード:新しいファミリーのパラメータグループを作成して指定しないと、アップグレードが失敗するか、デフォルト値が使われます。
  • 固定の数値:大きなインスタンスに合わせた固定の max_connections は、スケールダウン後に危険になります。数式ならインスタンスのサイズに追従します。

よくある質問

RDS のデフォルトのパラメータグループは変更できますか?

いいえ。デフォルトのパラメータグループは読み取り専用です。カスタムのパラメータグループを作成して変更し、DB インスタンスに関連付けます。

RDS インスタンスが pending-reboot と表示されるのはなぜですか?

静的パラメータを変更したか、新しいパラメータグループを関連付けたためです。変更はインスタンスを再起動してから適用されます。

RDS のパラメータグループのファミリーとは何ですか?

グループが適用されるエンジンとメジャーバージョンで、mysql8.0 や postgres16 などです。グループはそのファミリーのインスタンスでしか使えません。

デスクを離れているときに起きたら

再起動を待つパラメータの変更は、何週間もあとのメンテナンス中に誰かを驚かせがちです。AWS 用のスマホアプリ CloudConsole は、RDS のイベントとアラームをスマホで確認できるよう開発中です。

アプリについて → · App Storeからダウンロード

出典