#
ドキュメント

Document

自分のための備忘録です。

パラメータグループ

ドキュメント

DB クラスターパラメーターグループ / DB (インスタンス)パラメータグループ

  • DB クラスターパラメータグループ
    • 「Aurora DB クラスター内のすべての DB インスタンスに適用されるエンジン設定値」
  • DB (インスタンス)パラメータグループ
    • 「1 つ以上の DB インスタンスに適用されるエンジン設定値」

デフォルトクラスターパラメターグループにだけに設定項目があり、インスタンスパラメータグループに設定項目がないパラメータがある。その逆はない。

注意

DB クラスターパラメータグループには、インスタンスレベルのすべてのパラメータのデフォルト値も含まれています。

ref. パラメータグループの概要

デフォルトパラメータグループ / カスタムパラメータグループ

デフォルトおよびカスタムパラメータグループ

  • デフォルトパラメータグループ:クラスター / インスタンス ともにパラメータグループを指定しない場合に適用されるパラメータグループ
    • 「デフォルトのパラメータグループのパラメータ設定は変更できません。」
  • カスタムパラメータグループ:変更可能なパラメータグループ

カスタムパラメータグループを使用するように DB インスタンスを変更して、DB インスタンスを起動すると、RDS は起動プロセスの一環として DB インスタンスを自動的に再起動します。

パラメーターグループの適用

  • 新しい DB パラメータグループの関連付け – 新しい DB パラメータグループを DB インスタンスに関連付ける場合、RDS は、DB インスタンスが再起動された後にのみ、変更された静的および動的パラメータを適用します。ただし、DB インスタンスに関連付けた後に DB パラメータグループの動的パラメータを変更すると、これらの変更は再起動せずに直ちに適用されます。詳細については、「「パラメータグループを使用する」 」を参照してください。

  • 既存の DB パラメータグループの静的パラメータへの変更適用 – 静的パラメータを変更して DB パラメータグループを保存すると、コンソールでこのパラメータグループに関連付けられた DB インスタンスのステータスが [再起動を保留中] に変わります。パラメータの変更は、関連付けられた DB インスタンスが再起動された後にのみ有効になります。動的パラメータを変更すると、デフォルトでパラメータの変更が直ちに有効になります。再起動は不要です。

注記 [再起動を保留中] のステータスにより、次回のメンテナンスウィンドウで自動的に再起動されることはありません。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。パラメータグループの詳細については、「「パラメータグループを使用する」 」を参照してください。

ref. DB インスタンスの再起動のユースケース

パラメーターグループをコピー

パラメータグループを最初から作成したくない場合は、AWS CLI copy-db-parameter-group コマンドまたは copy-db-cluster-parameter-group コマンドを使用して、既存のパラメータグループをコピーできます。

静的パラメータ / 動的パラメータ

静的および動的 DB クラスターパラメータ

DB (インスタンス)パラメータグループ

  • 静的パラメータ: DB インスタンスを再起動後に適用
  • 動的パラメータ: 再起動なしで適用

DB クラスターパラメータグループ

  • 静的パラメータ: 「関連付けられている各 DB クラスター内の DB インスタンスを手動で再起動した後に有効になります。」
  • 動的パラメータ: 再起動なしで適用

文字セットパラメータ

文字セットパラメータ

サポートされるパラメータとパラメータ値

サポートされるパラメータとパラメータ値

インスタンスパラメータグループ設定一覧

# ParameterValue プロパティが未定義のものを除外するサンプル
aws rds describe-db-parameters --db-parameter-group-name {{ instance parameter groups name }}  --profile personal | jq '.Parameters[] | select(.ParameterValue != null) | .ParameterName, .ParameterValue'

クラスターパラメータグループ設定一覧

# ParameterValue プロパティが未定義のものを除外するサンプル
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name {{ cluster parameter groups name }} --profile personal |  | jq '.Parameters[] | select(.ParameterValue != null) | .ParameterName, .ParameterValue'

サポートされるパラメータ

多くの場合、表現、数式、関数を使用して、整数およびブール型パラメータを指定することができます。関数には、数学的なログ式を含めることができます。ただし、すべてのパラメータが、パラメータ値の表現、数式、関数をサポートしているわけではありません。詳細については、「DB パラメータの指定」を参照してください。

DB パラメータの指定