DB パラメータグループおよび DB クラスターパラメータグループを使用する
DB エンジンの設定を管理するには、DB インスタンスと Aurora DB クラスターをパラメータグループに関連付けます。Amazon RDS は、新しく作成された DB インスタンスと Aurora DB クラスターに適用されるデフォルト設定でパラメータグループを定義します。
カスタマイズした設定を使用して独自のパラメータグループを定義できます。次に、独自のパラメータグループを使用するように DB インスタンスおよび Aurora クラスターを変更できます。
DB クラスターまたは DB インスタンスの変更については、「Amazon Aurora DB クラスターの変更」を参照してください。
DB パラメータグループは、1 つ以上の DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。DB パラメータグループは、Amazon RDS と Aurora の両方の DB インスタンスに適用されます。これらの構成設定が適用されるプロパティ (メモリバッファのサイズなど) は、Aurora クラスター内の DB インスタンス間で異なる場合があります。
DB クラスターパラメータグループは、Aurora DB クラスター内のすべての DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。たとえば、Aurora 共有ストレージモデルでは、Aurora
クラスター内のすべての DB インスタンスが innodb_file_per_table
などのパラメータで同じ設定を使用することが要求されます。したがって、物理的なストレージレイアウトに影響するパラメータは、クラスターパラメータグループの一部です。DB
クラスターパラメータグループには、インスタンスレベルのすべてのパラメータのデフォルト値も含まれています。
DB パラメータグループを指定せずに DB インスタンスを作成すると、DB インスタンスはデフォルトの DB パラメータグループを使用します。同様に、DB クラスターパラメータグループを指定せずに Aurora DB クラスターを作成すると、DB クラスターはデフォルトの DB クラスターパラメータグループを使用します。 各デフォルト グループには、エンジン、コンピューティングクラス、インスタンスの割り当てストレージに基づいて、データベースエンジンのデフォルトと Amazon RDS システムのデフォルトが含まれています。デフォルトのパラメータグループのパラメータ設定は変更できません。代わりに、独自のパラメータ設定を選択して、独自のパラメータグループを作成します。DB エンジンのすべてのパラメータが、作成した DB パラメータグループで変更できるわけではありません。
独自のパラメータグループを使用する場合は、新しいパラメータグループを作成して必要なパラメータを変更します。次に、新しいパラメータグループを使用するように DB インスタンスまたは DB クラスターを変更します。DB パラメータグループ内のパラメータを更新すると、このパラメータグループに関連付けられたすべての DB インスタンスに変更が適用されます。同様に、DB クラスターパラメータグループ内のパラメータを更新すると、この DB クラスターパラメータグループに関連付けられたすべての Aurora クラスターに変更が適用されます。
AWS CLI の copy-db-parameter-group コマンドで、既存の DB パラメータグループをコピーすることもできます。AWS CLI の copy-db-cluster-parameter-group コマンドで、既存の DB クラスターパラメータグループをコピーすることができます。 パラメータグループをコピーすることは、既存の パラメータグループのカスタムパラメータと値を、新しい パラメータグループに含める場合に便利な方法です。
パラメータグループのパラメータを使用する際の重要なポイントを以下に示します。
-
動的パラメータを変更して パラメータグループを保存すると、[すぐに適用] の設定にかかわらず、変更はすぐに適用されます。静的パラメータを変更して DB パラメータグループを保存すると、パラメータの変更は DB インスタンスを手動で再起動した後に有効になります。DB インスタンスを再起動するには、RDS コンソールを使用するか、
RebootDbInstance
API オペレーションを明示的に呼び出します (DB インスタンスがマルチ AZ 配置になっている場合、フェイルオーバーは行いません)。静的パラメータを変更した後、関連付けられた DB インスタンスの再起動を求める要件は、パラメータの誤った設定が API 呼び出しに影響するリスク (DB インスタンスクラスを変更またはストレージを拡大するModifyDBInstance
の呼び出しなど) の軽減に役立ちます。DB インスタンスが、その関連付けられた DB パラメータグループに対する最新の変更を使用していない場合、AWS マネジメントコンソール は、DB パラメータグループのステータスを [再起動の保留中] と表示します。パラメータグループの [再起動の保留中] のステータスにより、次回のメンテナンスウィンドウで自動的に再起動されることはありません。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。
-
DB インスタンスに関連付けられている DB パラメータグループを変更する場合、DB インスタンスで新しい DB パラメータグループを使用する前に、インスタンスを手動で再起動する必要があります。DB パラメータグループの変更については、「Amazon Aurora DB クラスターの変更」を参照してください。
注記 DB クラスターに関連付けられている DB クラスターパラメータグループを変更した後、クラスター内のプライマリ DB インスタンスを再起動して、クラスター内のすべての DB インスタンスに変更を適用します。
-
パラメータの値は、整数として指定するか、式、変数、関数、および演算子で構成された整数式として指定できます。関数には、数学的なログ式を含めることができます。詳細については、「DB パラメータ値」を参照してください。
-
DB インスタンスを作成する前、および DB インスタンスでデータベースを作成する前に、パラメータグループに含まれるデータベースの文字セットまたは照合に関連するパラメータをすべて設定します。これにより、DB インスタンスのデフォルトデータベースと新しいデータベースで、指定した文字セットと照合値が使用されるようになります。DB インスタンスの文字セットまたは照合パラメータを変更した場合、パラメータの変更は既存のデータベースに適用されません。
ALTER DATABASE
コマンドを使用して、既存のデータベースの文字セットまたは照合値を変更できます。次に例を示します。ALTER DATABASE
database_name
CHARACTER SETcharacter_set_name
COLLATEcollation
; -
パラメータグループに不適切な設定のパラメータがあると、パフォーマンスが低下したりシステムが不安定になったり、予期しない悪影響が生じることがあります。データベースパラメータの変更時には常に注意が必要です。 パラメータグループの変更前にデータをバックアップしてください。テスト DB インスタンスでパラメータグループの設定の変更を試してから、本番稼働用 DB インスタンスにそれらの変更を適用してください。
-
Aurora グローバルデータベースでは、Aurora クラスター別に異なる構成設定を指定できます。セカンダリクラスターをプライマリクラスターに昇格させる場合は、両者を同様の設定にして動作を一貫させてください。たとえば、Aurora グローバルデータベースのすべてのクラスターでタイムゾーンと文字セットに同じ設定を使用します。
-
DB エンジンでサポートされているパラメータを決定するには、の DB クラスターで使用される DB パラメーターグループおよび DB クラスターパラメータグループのパラメータを表示できます。詳細については、「DB パラメータグループのパラメータ値を表示する」および「DB クラスターパラメータグループのパラメータ値を表示する」を参照してください。
トピック
- Amazon Aurora の DB クラスターパラメータと DB インスタンスパラメータ
- DB パラメータグループを作成する
- DB クラスターのパラメータグループの作成
- DB パラメータグループのパラメータの変更
- DB クラスターパラメータグループのパラメータの変更
- DB パラメータグループをコピーする
- DB クラスターのパラメータグループのコピー
- DB パラメータグループを一覧表示する
- DB クラスターのパラメータグループのリスト化
- DB パラメータグループのパラメータ値を表示する
- DB クラスターパラメータグループのパラメータ値を表示する
- パラメータグループを比較する
- DB パラメータ値
Amazon Aurora の DB クラスターパラメータと DB インスタンスパラメータ
Aurora は、以下に示すように、2 レベルシステムの構成設定を使用します。
-
DB クラスターパラメータグループのパラメータは、DB クラスター内のすべての DB インスタンスに適用されます。データは、Aurora 共有ストレージサブシステムに保存されます。このため、テーブルデータの物理レイアウトに関連するすべてのパラメータは、Aurora クラスター内のすべての DB インスタンスで同じにする必要があります。同様に、Aurora DB インスタンスはレプリケーションで接続されているため、レプリケーション設定のすべてのパラメータは Aurora クラスター全体で同じにする必要があります。
-
DB パラメータグループのパラメータは、Aurora DB クラスター内の単一の DB インスタンスに適用されます。これらのパラメータは、同じ Aurora クラスター内の DB インスタンス間で変化させることができるメモリ使用量などの要素に関連しています。たとえば、クラスターには、AWS インスタンスクラスが異なる DB インスタンスが含まれる場合がよくあります。
すべての Aurora クラスターは、DB クラスターパラメータグループに関連付けられます。クラスター内の各 DB インスタンスは、この DB クラスターパラメータグループから設定を継承し、DB パラメータグループに関連付けられます。クラスターまたは新しい DB インスタンスを作成すると、Aurora は、指定されたデータベースエンジンおよびバージョンに基づいて、デフォルトのパラメータグループを割り当てます。パラメータグループは、後で、自分で作成したものに変更し、パラメータ値を編集できます。
DB クラスターパラメータグループには、DB パラメータグループのインスタンスレベルのすべてのパラメータのデフォルト値も含まれています。これらのデフォルトは、主に Aurora Serverless クラスターの設定用であり、DB クラスターパラメータグループにのみ関連付けられ、DB パラメータグループには関連付けられません。インスタンスレベルのパラメータ設定は、DB クラスターパラメータグループで変更できます。次に、Aurora は、サーバーレスクラスターに追加された新しい各 DB インスタンスに、これらの設定を適用します。Aurora Serverless クラスターの構成設定と変更できる設定の詳細については、「Aurora Serverless とパラメータグループ」を参照してください。
非サーバーレスクラスターの場合、DB クラスターパラメータグループで変更した設定値は、DB パラメータグループのデフォルト値を上書きします。DB パラメータグループ内の対応する値を編集すると、これらの値によって DB クラスターパラメータグループの設定が上書きされます。
変更した DB パラメータ設定は、構成設定を変更してデフォルト値に戻した場合でも、DB クラスターパラメータグループ値より優先されます。どのパラメータが上書きされるかは、describe-db-parameters
AWS CLI コマンドまたは DescribeDBParameters RDS API を使用して確認できます。Source
フィールドには、該当するパラメータを変更した場合に、値 user
が含まれます。DB クラスターパラメータグループの値が優先されるように、1 つ以上のパラメータをリセットするには、reset-db-parameter-group
AWS CLI コマンドまたは ResetDBParameterGroup RDS API オペレーションを使用します。
DB クラスターと、Aurora で利用可能な DB インスタンスパラメータは、データベースエンジンの互換性に応じて異なります。
データベースエンジン | パラメータ |
---|---|
Aurora MySQL |
「Aurora MySQL 個のパラメータ」を参照してください。 Aurora Serverless クラスターの詳細については、「Aurora Serverless とパラメータグループ」を参照してください。 |
Aurora PostgreSQL |
「Amazon Aurora PostgreSQL 個のパラメータ」を参照してください。 |
DB パラメータグループを作成する
新しい DB パラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。
DB パラメータグループを作成するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
[Create parameter group] を選択します。
[パラメータグループの作成] ウィンドウが表示されます。
-
[パラメータグループファミリー] リストで、DB パラメータグループファミリーを選択します。
-
[Type] リストで、[DB Parameter Group] を選択します。
-
[グループ名] ボックスに、新しい DB パラメータグループの名前を入力します。
-
[説明] ボックスに、新しい DB パラメータグループの説明を入力します。
-
[作成] を選択します。
DB パラメータグループを作成するには、AWS CLI の create-db-parameter-group
コマンドを使用します。以下の例では、MySQL バージョン 5.6 用に、mydbparametergroup という名前で、「My new parameter group」という説明の新しい DB パラメータグループを作成しています。
以下の必須パラメータを含めます。
-
--db-parameter-group-name
-
--db-parameter-group-family
-
--description
使用可能なすべてのパラメータグループファミリーを一覧表示するには、次のコマンドを使用します。
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
出力は重複が含まれます。
例
Linux、macOS、Unix の場合:
aws rds create-db-parameter-group \ --db-parameter-group-name
mydbparametergroup
\ --db-parameter-group-familyaurora5.6
\ --description"My new parameter group"
Windows の場合:
aws rds create-db-parameter-group ^ --db-parameter-group-name
mydbparametergroup
^ --db-parameter-group-familyaurora5.6
^ --description"My new parameter group"
このコマンドでは、以下のような出力が生成されます。
DBPARAMETERGROUP mydbparametergroup aurora5.6 My new parameter group
DB パラメータグループを作成するには、RDS API の CreateDBParameterGroup
オペレーションを使用します。
以下の必須パラメータを含めます。
-
DBParameterGroupName
-
DBParameterGroupFamily
-
Description
DB クラスターのパラメータグループの作成
新しい DB クラスターパラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。
DB クラスターパラメータグループを作成するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
[Create parameter group] を選択します。
[パラメータグループの作成] ウィンドウが表示されます。
-
[パラメータグループファミリー] リストで、DB パラメータグループファミリーを選択します。
-
[Type] リストで、[DB Cluster Parameter Group] を選択します。
-
[グループ名] ボックスに、新しい DB クラスターパラメータグループの名前を入力します。
-
[説明] ボックスに、新しい DB クラスターパラメータグループの説明を入力します。
-
[Create] を選択します。
DB クラスターパラメータグループを作成するには、AWS CLI の create-db-cluster-parameter-group
コマンドを使用します。以下の例では、MySQL バージョン 5.6 用に、mydbclusterparametergroup という名前で、「My new cluster parameter group」という説明の新しい DB クラスターパラメータグループを作成しています。
以下の必須パラメータを含めます。
-
--db-cluster-parameter-group-name
-
--db-parameter-group-family
-
--description
使用可能なすべてのパラメータグループファミリーを一覧表示するには、次のコマンドを使用します。
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
出力は重複が含まれます。
例
Linux、macOS、Unix の場合:
aws rds create-db-cluster-parameter-group \ --db-cluster-parameter-group-name
mydbclusterparametergroup
\ --db-parameter-group-familyaurora5.6
\ --description"My new cluster parameter group"
Windows の場合:
aws rds create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name
mydbclusterparametergroup
^ --db-parameter-group-familyaurora5.6
^ --description"My new cluster parameter group"
このコマンドでは、以下のような出力が生成されます。
DBCLUSTERPARAMETERGROUP mydbclusterparametergroup mysql5.6 My cluster new parameter group
DB クラスターパラメータグループを作成するには、RDS API の CreateDBClusterParameterGroup
アクションを使用します。
以下の必須パラメータを含めます。
-
DBClusterParameterGroupName
-
DBParameterGroupFamily
-
Description
DB パラメータグループのパラメータの変更
ユーザー定義の DB パラメータグループのパラメータ値は変更できますが、デフォルトの DB パラメータグループのパラメータ値を変更することはできません。ユーザー定義の DB パラメータグループのパラメータの変更は、その DB パラメータグループに関連付けられたすべての DB インスタンスに適用されます。
一部のパラメータへの変更は、再起動せずに直ちに DB インスタンスに適用されます。他のパラメータの変更は、DB インスタンスの再起動後にのみ適用されます。DB インスタンスに関連付けられている DB パラメータグループのステータスは、RDS コンソールの [設定] タブに表示されます。たとえば、DB インスタンスがその関連付けられた DB パラメータグループの最新の変更を使用していない場合、RDS コンソールは、DB パラメータグループのステータスを [再起動の保留中] と表示します。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。

DB パラメータグループを変更するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
リストで、変更するパラメータグループを選択します。
-
[Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。
-
変更するパラメータの値を変更します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。
デフォルトパラメータグループの値を変更することはできません。
-
[Save changes] を選択します。
DB パラメータグループを変更するには、以下の必須パラメータを指定して、AWS CLI の modify-db-parameter-group
コマンドを使用します。
-
--db-parameter-group-name
-
--parameters
以下の例では、mydbparametergroup という名前の DB パラメータグループの max_connections
と max_allowed_packet
の値を変更しています。
例
Linux、macOS、Unix の場合:
aws rds modify-db-parameter-group \ --db-parameter-group-name
mydbparametergroup
\ --parameters "ParameterName=max_connections
,ParameterValue=250
,ApplyMethod=immediate
" \ "ParameterName=max_allowed_packet
,ParameterValue=1024
,ApplyMethod=immediate
"
Windows の場合:
aws rds modify-db-parameter-group ^ --db-parameter-group-name
mydbparametergroup
^ --parameters "ParameterName=max_connections
,ParameterValue=250
,ApplyMethod=immediate
" ^ "ParameterName=max_allowed_packet
,ParameterValue=1024
,ApplyMethod=immediate
"
このコマンドでは、以下のような出力が生成されます。
DBPARAMETERGROUP mydbparametergroup
DB パラメータグループを変更するには、以下の必須パラメータを指定して、RDS API の ModifyDBParameterGroup
コマンドを使用します。
-
DBParameterGroupName
-
Parameters
DB クラスターパラメータグループのパラメータの変更
ユーザーが作成した DB クラスターパラメータグループのパラメータ値は変更できます。デフォルト DB クラスターパラメータグループのパラメータ値は変更できません。ユーザー定義の DB クラスターパラメータグループのパラメータの変更は、その DB クラスターパラメータグループに関連付けられたすべての DB クラスターに適用されます。
DB クラスターパラメータグループを変更するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
リストで、変更するパラメータグループを選択します。
-
[Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。
-
変更するパラメータの値を変更します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。
デフォルトパラメータグループの値を変更することはできません。
-
[Save changes] を選択します。
-
クラスター内のプライマリ DB インスタンスを再起動して、クラスター内のすべての DB インスタンスに変更を適用します。
DB クラスターパラメータグループを変更するには、以下の必須パラメータを指定して、AWS CLI の modify-db-cluster-parameter-group
コマンドを使用します。
-
--db-cluster-parameter-group-name
-
--parameters
以下の例では、mydbclusterparametergroup という名前の DB クラスタパーラメータグループの server_audit_logging
と server_audit_logs_upload
の値を変更しています。
例
Linux、macOS、Unix の場合:
aws rds modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name
mydbclusterparametergroup
\ --parameters "ParameterName=server_audit_logging
,ParameterValue=1
,ApplyMethod=immediate
" \ "ParameterName=server_audit_logs_upload
,ParameterValue=1
,ApplyMethod=immediate
"
Windows の場合:
aws rds modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name
mydbclusterparametergroup
^ --parameters "ParameterName=server_audit_logging
,ParameterValue=1
,ApplyMethod=immediate
" ^ "ParameterName=server_audit_logs_upload
,ParameterValue=1
,ApplyMethod=immediate
"
このコマンドでは、以下のような出力が生成されます。
DBCLUSTERPARAMETERGROUP mydbclusterparametergroup
DB クラスターパラメータグループを変更するには、以下の必須パラメータを指定して、RDS API の ModifyDBClusterParameterGroup
コマンドを使用します。
-
DBClusterParameterGroupName
-
Parameters
DB パラメータグループをコピーする
作成したカスタム DB パラメータグループをコピーできます。パラメータグループのコピーは、作成済みの DB パラメータグループがあり、そのグループの多くのカスタムパラメータと値を新しい DB パラメータグループに含める必要がある場合に便利な方法です。DB パラメータグループをコピーするには、AWS マネジメントコンソール、AWS CLI の copy-db-parameter-group コマンド、RDS API の CopyDBParameterGroup オペレーションのいずれかを使用できます。
DB パラメータグループをコピーした後で、その DB パラメータグループをデフォルトのパラメータグループとして使用する最初の DB インスタンスを作成するまで、最低
5 分待ちます。これにより、パラメータグループを使用する前に、Amazon RDS はコピーアクションが完全に終了できます。これは、DB インスタンスのデフォルトのデータベースを作成する際に不可欠となるパラメータで特に重要です。例としては、character_set_database
パラメータで定義するデフォルトのデータベースの文字セットが挙げられます。DB パラメータグループが作成されたことを確認するには、Amazon RDS コンソール
デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。
現時点では、パラメータグループを別の AWS リージョンにコピーすることはできません。
DB パラメータグループをコピーするには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
リストで、コピーするカスタムパラメータグループを選択します。
-
[Parameter group actions (パラメータグループのアクション)] で、[コピー] を選択します。
-
[新規の DB パラメータグループの識別子] に、新しいパラメータグループの名前を入力します。
-
[説明] に、新しいパラメータグループの説明を入力します。
-
[Copy (コピー)] を選択します。
DB パラメータグループをコピーするには、次の必須オプションを指定して、AWS CLI の copy-db-parameter-group
コマンドを使用します。
-
--source-db-parameter-group-identifier
-
--target-db-parameter-group-identifier
-
--target-db-parameter-group-description
次の例は、DB パラメータグループ mygroup2
のコピーである mygroup1
という名前の新しい DB パラメータグループを作成します。
例
Linux、macOS、Unix の場合:
aws rds copy-db-parameter-group \ --source-db-parameter-group-identifier
mygroup1
\ --target-db-parameter-group-identifiermygroup2
\ --target-db-parameter-group-description"DB parameter group 2"
Windows の場合:
aws rds copy-db-parameter-group ^ --source-db-parameter-group-identifier
mygroup1
^ --target-db-parameter-group-identifiermygroup2
^ --target-db-parameter-group-description"DB parameter group 2"
DB パラメータグループをコピーするには、以下の必須パラメータを指定して、RDS API の CopyDBParameterGroup
オペレーションを使用します。
-
SourceDBParameterGroupIdentifier
-
TargetDBParameterGroupIdentifier
-
TargetDBParameterGroupDescription
DB クラスターのパラメータグループのコピー
作成したカスタム DB クラスターパラメータグループをコピーできます。パラメータグループのコピーは、作成済みの DB クラスターパラメータグループがあり、そのグループの多くのカスタムパラメータと値を新しい DB クラスターパラメータグループに含める必要がある場合に便利な方法です。DB クラスターパラメータグループをコピーするには、AWS CLI copy-db-cluster-parameter-group コマンド、または RDS API CopyDBClusterParameterGroup オペレーションを使用できます。
DB クラスターパラメータグループをコピーした後で、この DB クラスターパラメータグループをデフォルトのパラメータグループとして使用する最初の DB クラスターを作成するまで、最低
5 分待ちます。これにより、パラメータグループを新しい DB クラスターのデフォルトとして使用する前に、Amazon RDS はコピーアクションが完全に終了できます。DB
クラスターパラメータグループが作成されたことを確認するには、Amazon RDS コンソール
デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。
DB クラスターパラメータグループをコピーするには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
リストで、コピーするカスタムパラメータグループを選択します。
-
[Parameter group actions (パラメータグループのアクション)] で、[コピー] を選択します。
-
[新規の DB パラメータグループの識別子] に、新しいパラメータグループの名前を入力します。
-
[説明] に、新しいパラメータグループの説明を入力します。
-
[Copy (コピー)] を選択します。
DB クラスターパラメータグループをコピーするには、以下の必須パラメータを指定して、AWS CLI の copy-db-cluster-parameter-group
コマンドを使用します。
-
--source-db-cluster-parameter-group-identifier
-
--target-db-cluster-parameter-group-identifier
-
--target-db-cluster-parameter-group-description
次の例は、DB クラスターパラメータグループ mygroup1
のコピーである mygroup2
という名前の新しい DB クラスターパラメータグループを作成します。
例
Linux、macOS、Unix の場合:
aws rds copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier
mygroup1
\ --target-db-cluster-parameter-group-identifiermygroup2
\ --target-db-cluster-parameter-group-description"DB parameter group 2"
Windows の場合:
aws rds copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier
mygroup1
^ --target-db-cluster-parameter-group-identifiermygroup2
^ --target-db-cluster-parameter-group-description"DB parameter group 2"
DB クラスターパラメータグループをコピーするには、以下の必須パラメータを指定して、RDS API の CopyDBClusterParameterGroup
オペレーションを使用します。
-
SourceDBClusterParameterGroupIdentifier
-
TargetDBClusterParameterGroupIdentifier
-
TargetDBClusterParameterGroupDescription
DB パラメータグループを一覧表示する
AWS アカウント用に作成した DB パラメータグループを一覧表示できます。
デフォルトのパラメータグループは、特定の DB エンジンとバージョンの DB インスタンスを作成するときに、デフォルトのパラメータテンプレートから自動的に作成されます。これらのデフォルトのパラメータグループには、優先されるパラメータ設定が含まれています。これを変更することはできません。カスタムパラメータグループを作成する場合、パラメータ設定を変更できます。
AWS アカウントのすべての DB パラメータグループを一覧表示するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
DB パラメータグループがリストに表示されます。
AWS アカウントのすべての DB パラメータグループを一覧表示するには、AWS CLI の describe-db-parameter-groups
コマンドを使用します。
例
以下の例では、AWS アカウントに使用できるすべての DB パラメータグループを一覧表示しています。
aws rds describe-db-parameter-groups
このコマンドでは次のようなレスポンスが返されます。
DBPARAMETERGROUP default.mysql5.5 mysql5.5 Default parameter group for MySQL5.5 DBPARAMETERGROUP default.mysql5.6 mysql5.6 Default parameter group for MySQL5.6 DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group
次の例は、mydbparamgroup1 パラメータグループを表しています。
Linux、macOS、Unix の場合:
aws rds describe-db-parameter-groups \ --db-parameter-group-name
mydbparamgroup1
Windows の場合:
aws rds describe-db-parameter-groups ^ --db-parameter-group-name
mydbparamgroup1
このコマンドでは次のようなレスポンスが返されます。
DBPARAMETERGROUP mydbparametergroup1 mysql5.5 My new parameter group
AWS アカウントのすべての DB パラメータグループを一覧表示するには、RDS API の DescribeDBParameterGroups
オペレーションを使用します。
DB クラスターのパラメータグループのリスト化
AWS アカウント用に作成した DB クラスターパラメータグループを一覧表示できます。
デフォルトのパラメータグループは、特定の DB エンジンとバージョンの DB クラスターを作成するときに、デフォルトのパラメータテンプレートから自動的に作成されます。これらのデフォルトのパラメータグループには、優先されるパラメータ設定が含まれています。これを変更することはできません。カスタムパラメータグループを作成する場合、パラメータ設定を変更できます。
AWS アカウントのすべての DB クラスターパラメータグループを一覧表示するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
DB クラスターパラメータグループは、[Type] (タイプ) が [DB cluster parameter group] (DB クラスターパラメータグループ) のリストに表示されます。
AWS アカウントのすべての DB クラスターパラメータグループを一覧表示するには、AWS CLI の describe-db-cluster-parameter-groups
コマンドを使用します。
例
以下の例では、AWS アカウントに使用できるすべての DB クラスターパラメータグループを一覧表示しています。
aws rds describe-db-cluster-parameter-groups
このコマンドでは次のようなレスポンスが返されます。
DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:default.aurora5.6 default.aurora5.6 aurora5.6 Default cluster parameter group for aurora5.6 DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group
次の例は、mydbclusterparametergroup パラメータグループを表しています。
Linux、macOS、Unix の場合:
aws rds describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name
mydbclusterparametergroup
Windows の場合:
aws rds describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name
mydbclusterparametergroup
このコマンドでは次のようなレスポンスが返されます。
DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group
AWS アカウントのすべての DB クラスターパラメータグループを一覧表示するには、RDS API の DescribeDBClusterParameterGroups
アクションを使用します。
DB パラメータグループのパラメータ値を表示する
DB パラメータグループのすべてのパラメータとそれらの値のリストを取得できます。
DB パラメータグループのパラメータ値を表示するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
DB パラメータグループがリストに表示されます。
-
パラメータを一覧表示するパラメータグループの名前を選択します。
DB パラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、AWS CLI の describe-db-parameters
コマンドを使用します。
-
--db-parameter-group-name
例
以下の例では、mydbparametergroup という名前の DB パラメータグループのパラメータとその値を一覧表示しています。
aws rds describe-db-parameters --db-parameter-group-name
mydbparametergroup
このコマンドでは次のようなレスポンスが返されます。
DBPARAMETER Parameter Name Parameter Value Source Data Type Apply Type Is Modifiable DBPARAMETER allow-suspicious-udfs engine-default boolean static false DBPARAMETER auto_increment_increment engine-default integer dynamic true DBPARAMETER auto_increment_offset engine-default integer dynamic true DBPARAMETER binlog_cache_size 32768 system integer dynamic true DBPARAMETER socket /tmp/mysql.sock system string static false
DB パラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、RDS API の DescribeDBParameters
コマンドを使用します。
-
DBParameterGroupName
DB クラスターパラメータグループのパラメータ値を表示する
DB クラスターパラメータグループのすべてのパラメータとそれらの値のリストを取得できます。
DB クラスターパラメータグループのパラメータ値を表示するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
DB クラスターパラメータグループは、[Type] (タイプ) が [DB cluster parameter group] (DB クラスターパラメータグループ) のリストに表示されます。
-
パラメータを一覧表示する DB クラスターパラメータグループの名前を選択します。
DB クラスターパラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、AWS CLI の describe-db-cluster-parameters
コマンドを使用します。
-
--db-cluster-parameter-group-name
例
以下の例では、JSON 形式の mydbclusterparametergroup という名前の DB クラスターパラメータグループのパラメータとその値を一覧表示しています。
このコマンドでは次のようなレスポンスが返されます。
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name
mydbclusterparametergroup
{
"Parameters": [
{
"ApplyMethod": "pending-reboot",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"DataType": "boolean",
"AllowedValues": "0,1",
"SupportedEngineModes": [
"provisioned"
],
"Source": "engine-default",
"IsModifiable": false,
"ParameterName": "allow-suspicious-udfs",
"ApplyType": "static"
},
{
"ApplyMethod": "pending-reboot",
"Description": "Enables new features in the Aurora engine.",
"DataType": "boolean",
"IsModifiable": true,
"AllowedValues": "0,1",
"SupportedEngineModes": [
"provisioned"
],
"Source": "engine-default",
"ParameterValue": "0",
"ParameterName": "aurora_lab_mode",
"ApplyType": "static"
},
...
以下の例では、mydbclusterparametergroup という名前の DB クラスターパラメータグループのパラメータとその値をプレーンテキスト形式で一覧表示しています。
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name
mydbclusterparametergroup
--output text
このコマンドでは次のようなレスポンスが返されます。
PARAMETERS 0,1 pending-reboot static boolean Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded False allow-suspicious-udfs engine-default SUPPORTEDENGINEMODES provisioned
PARAMETERS 0,1 pending-reboot static boolean Enables new features in the Aurora engine. True aurora_lab_mode 0 engine-default SUPPORTEDENGINEMODES provisioned
...
DB クラスターパラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、RDS API の DescribeDBClusterParameters
コマンドを使用します。
-
DBClusterParameterGroupName
パラメータグループを比較する
AWS マネジメントコンソール を使用して、同じ DB エンジンおよびバージョンの 2 つのパラメータグループ間の差異を表示できます。
2 つのパラメータグループを比較するには
-
AWS マネジメントコンソールにサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/
) を開きます。 -
ナビゲーションペインで、[パラメータグループ] を選択します。
-
リストで、比較する 2 つのパラメータグループを選択します。
-
[Parameter group actions (パラメータグループのアクション)] で、[比較] を選択します。
注記 選択した項目が同等でない場合は、比較 を選択することはできません。たとえば、MySQL 5.6 と MySQL 5.7 のパラメータグループを比較することはできません。また、DB パラメータグループと Aurora DB クラスターパラメーターグループを比較することもできません。
DB パラメータ値
DB パラメータの値は、以下のいずれかとして指定できます。
-
整数定数
-
DB パラメータ式
-
DB パラメータ関数
-
文字列定数
-
ログ式 (log 関数は log 基数 2 に相当します)。
value={log(DBInstanceClassMemory/8187281418)*1000}
など。
DB パラメータ式
DB パラメータ式は整数値に解決される式あるいはブール値であり、中かっこ {} で囲まれます。式は、DB パラメータ値で指定したり、DB パラメータ関数の引数として指定したりできます。
構文
{FormulaVariable} {FormulaVariable*Integer} {FormulaVariable*Integer/Integer} {FormulaVariable/Integer}
DB パラメータ式の変数
各式の変数は整数あるいはブール値を返します。変数名では大文字と小文字が区別されます。
- AllocatedStorage
-
データボリュームのサイズをバイト単位で返します。
- DBInstanceClassMemory
-
現在の DB インスタンスに関連付けられている DB インスタンスクラスに割り当てられたメモリから、インスタンスを管理する Amazon RDS プロセスによって使用されるメモリを引いたバイト数を返します。
- EndPointPort
-
DB インスタンスに接続するときに使用されるポートの番号を返します。
DB パラメータ式の演算子
DB パラメータ式では、2 つ演算子 (除算と乗算) がサポートされています。
- 除算演算子: /
-
被除数を除数で割り、整数の商を返します。商の小数部分は四捨五入されず切り捨てられます。
構文
dividend / divisor
被除数と除数の引数は整数式である必要があります。
- 乗算演算子: *
-
式を乗算し、式の積を返します。式の小数部分は四捨五入されず切り捨てられます。
構文
expression * expression
両方の式は整数である必要があります。
DB パラメータ関数
パラメータ引数は整数または式のいずれかとして指定できます。各関数には 1 つ以上の引数が必要です。複数の引数をカンマ区切りのリストとして指定できます。リストには、argument1,,argument3 など、空のメンバーを使用することはできません。関数名では大文字と小文字は区別されません。
DB パラメータ関数は、現在、AWS CLI ではサポートされていません。
- IF()
-
引数を返します。
構文
IF(argument1, argument2, argument3)
最初の引数が true と評価する場合に、2 番目の引数を返します。それ以外の場合には、3 番目の引数を返します。
- GREATEST()
-
整数またはパラメータ式のリストから最大値を返します。
構文
GREATEST(argument1, argument2,...argumentn)
整数を返します。
- LEAST()
-
整数またはパラメータ式のリストから最小値を返します。
構文
LEAST(argument1, argument2,...argumentn)
整数を返します。
- SUM()
-
指定した整数またはパラメータ式の値を加算します。
構文
SUM(argument1, argument2,...argumentn)
整数を返します。
DB パラメータ値の例
以下の例では、DB パラメータ値に式と関数を使用しています。
DB パラメータグループのパラメータを適切に設定しないと、パフォーマンスが低下したりシステムが不安定になったりするなど、予期しない悪影響が生じることがあります。データベースパラメータの変更時には常に注意が必要です。DB パラメータグループの変更前にはデータをバックアップしてください。パラメータグループの変更は、テスト DB インスタンス (ポイントインタイム復元を使用して作成) で試してから、本番稼働用 DB インスタンスに適用してください。
Aurora MySQL table_definition_cache
パラメータ値で LEAST()
関数を指定し、定義キャッシュに保存可能なテーブル定義の数を設定できます。その数は、DBInstanceClassMemory
を 393040 で割った値または 20,000 のいずれか小さい方に設定されます。
LEAST({DBInstanceClassMemory/393040}, 20000)