DB パラメータグループおよび DB クラスターパラメータグループを使用する - Amazon Aurora
DB クラスターパラメータと DB インスタンスパラメータDB パラメータグループを作成するDB クラスターのパラメータグループの作成DB パラメータグループを DB インスタンスに関連付けるDB クラスターパラメータグループと DB クラスターの関連付けDB パラメータグループのパラメータの変更DB クラスターパラメータグループのパラメータの変更DB パラメータグループのパラメータをリセットDB クラスターパラメータグループのパラメータのリセットDB パラメータグループをコピーするDB クラスターのパラメータグループのコピーDB パラメータグループを一覧表示するDB クラスターのパラメータグループのリスト化DB パラメータグループのパラメータ値を表示するDB クラスターパラメータグループのパラメータ値を表示する パラメータグループを比較するDB パラメータの指定

DB パラメータグループおよび DB クラスターパラメータグループを使用する

DB インスタンスと Aurora DB クラスターをパラメータグループに関連付けて、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 コンソールを使用するか、reboot-db-instance CLI コマンドを呼び出すか、RebootDbInstance API オペレーションを呼び出します。静的パラメータを変更した後、関連付けられた DB インスタンスの再起動を求める要件は、パラメータの誤った設定が API 呼び出しに影響するリスク (DB インスタンスクラスを変更またはストレージを拡大する ModifyDBInstance の呼び出しなど) の軽減に役立ちます。

    DB インスタンスが、その関連付けられた DB パラメータグループに対する最新の変更を使用していない場合、AWS Management Console は、DB パラメータグループのステータスを [再起動の保留中] と表示します。パラメータグループの [再起動の保留中] のステータスにより、次回のメンテナンスウィンドウで自動的に再起動されることはありません。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。

  • DB インスタンスに関連付けられている DB パラメータグループを変更する場合、DB インスタンスで新しい DB パラメータグループを使用する前に、インスタンスを手動で再起動する必要があります。DB パラメータグループの変更については、「Amazon Aurora DB クラスターの変更」を参照してください。

    注記

    DB クラスターに関連付けられている DB クラスターパラメータグループを変更した後、クラスター内のプライマリ DB インスタンスを再起動して、クラスター内のすべての DB インスタンスに変更を適用します。

    変更を適用するために DB クラスターのプライマリ DB インスタンスを再起動する必要があるかどうかを判断するには、以下の AWS CLI コマンドを実行します。

    aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier

    出力でプライマリ DB インスタンスの DBClusterParameterGroupStatus 値を確認します。値が pending-reboot の場合は、DB クラスターのプライマリ DB インスタンスを再起動します。

  • パラメータの値は、整数として指定するか、式、変数、関数、および演算子で構成された整数式として指定できます。関数には、数学的なログ式を含めることができます。詳細については、「DB パラメータの指定」を参照してください。

  • DB インスタンスを作成する前、および DB インスタンスでデータベースを作成する前に、パラメータグループに含まれるデータベースの文字セットまたは照合に関連するパラメータをすべて設定します。これにより、DB インスタンスのデフォルトデータベースと新しいデータベースで、指定した文字セットと照合値が使用されるようになります。DB インスタンスの文字セットまたは照合パラメータを変更した場合、パラメータの変更は既存のデータベースに適用されません。

    ALTER DATABASE コマンドを使用して、既存のデータベースの文字セットまたは照合値を変更できます。次に例を示します。 

    
ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;

  • パラメータグループに不適切な設定のパラメータがあると、パフォーマンスが低下したりシステムが不安定になったり、予期しない悪影響が生じることがあります。データベースパラメータの変更時には常に注意が必要です。 パラメータグループの変更前にデータをバックアップしてください。テスト DB インスタンスでパラメータグループの設定の変更を試してから、本番稼働用 DB インスタンスにそれらの変更を適用してください。

  • Aurora グローバルデータベースでは、Aurora クラスター別に異なる構成設定を指定できます。セカンダリクラスターをプライマリクラスターに昇格させる場合は、両者を同様の設定にして動作を一貫させてください。例えば、Aurora グローバルデータベースのすべてのクラスターでタイムゾーンと文字セットに同じ設定を使用します。

  • 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 パラメータグループに関連付けられます。Aurora は、指定されたデータベースエンジンおよびバージョンに基づいて、クラスターまたは新しい DB インスタンスを作成すると、デフォルトのパラメータグループを割り当てます。パラメータグループは、後で、自分で作成したものに変更し、パラメータ値を編集できます。

DB クラスターパラメータグループには、DB パラメータグループのインスタンスレベルのすべてのパラメータのデフォルト値も含まれています。これらのデフォルトは、主に Aurora Serverless クラスターの設定用であり、DB クラスターパラメータグループにのみ関連付けられ、DB パラメータグループには関連付けられません。インスタンスレベルのパラメータ設定は、DB クラスターパラメータグループで変更できます。次に、Aurora は、サーバーレスクラスターに追加された新しい各 DB インスタンスに、これらの設定を適用します。Aurora Serverless クラスターの構成設定と変更できる設定の詳細については、「パラメータグループと Aurora Serverless v1」を参照してください。

非サーバーレスクラスターの場合、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 v1」を参照してください。

Aurora PostgreSQL

「Amazon Aurora PostgreSQL 個のパラメータ」を参照してください。

DB パラメータグループを作成する

新しい DB パラメータグループは、AWS Management Console、AWS CLI、または RDS API を使って作成できます。

DB パラメータグループを作成するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. [Create parameter group] を選択します。

    [パラメータグループの作成] ウィンドウが表示されます。

  4. [パラメータグループファミリー] リストで、DB パラメータグループファミリーを選択します。

  5. [Type] リストで、[DB Parameter Group] を選択します。

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

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

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

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-family aurora5.6 \
    --description "My new parameter group"

Windows の場合:

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family aurora5.6 ^
    --description "My new parameter group"

このコマンドでは、以下のような出力が生成されます。

DBPARAMETERGROUP  mydbparametergroup  aurora5.6  My new parameter group

DB パラメータグループを作成するには、RDS API の CreateDBParameterGroup オペレーションを使用します。

以下の必須パラメータを含めます。

  • DBParameterGroupName

  • DBParameterGroupFamily

  • Description

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

新しい DB クラスターパラメータグループは、AWS Management Console、AWS CLI、または RDS API を使って作成できます。

DB クラスターパラメータグループを作成するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. [Create parameter group] を選択します。

    [パラメータグループの作成] ウィンドウが表示されます。

  4. [パラメータグループファミリー] リストで、DB パラメータグループファミリーを選択します。

  5. [Type] リストで、[DB Cluster Parameter Group] を選択します。

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

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

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

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-family aurora5.6 \
    --description "My new cluster parameter group"

Windows の場合:

aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family aurora5.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 パラメータグループを作成できます。AWS Management Console、AWS CLI、または RDS API を使用して、DB パラメータグループを DB インスタンスに関連付けることができます。DB インスタンスを作成または変更するときに、これを行うことができます。

DB パラメータグループの作成については、DB パラメータグループを作成する を参照してください。DB インスタンスの変更については、「DB クラスター内の DB インスタンスの変更」を参照してください。

注記

DB インスタンスに関連付けられている DB パラメータグループを変更する場合、DB インスタンスで新しい DB パラメータグループを使用する前に、インスタンスを手動で再起動する必要があります。

DB パラメータグループを DB インスタンスに関連付けるには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[データベース] を選択し、変更する DB インスタンスを選択します。

  3. [Modify] を選択します。[Modify DB Instance] ページが表示されます。

  4. DB パラメータグループの設定を変更します。

  5. [Continue] を選択して、変更の概要を確認します。

  6. (省略可能) 変更をすぐに適用するには、[すぐに適用] を選択します。このオプションを選択すると、停止状態になる場合があります。

  7. 確認ページで、変更内容を確認します。正しい場合は、[Modify DB Instance (DB インスタンスを変更)] を選択して変更を保存します。

    または、[戻る] を選択して変更を編集するか、[キャンセル] を選択して変更をキャンセルします。

DB パラメータグループを DB インスタンスに関連付けるには、以下のオプションを指定して AWS CLI modify-db-instance コマンドを使用します。

  • --db-instance-identifier

  • --db-parameter-group-name

次の例では、mydbpg DB パラメータグループを database-1 DB インスタンスに関連付けます。--apply-immediately を使用すると変更はすぐに適用されます。--no-apply-immediately を使用して、次のメンテナンス時間中に変更を適用します。

例

Linux、macOS、Unix の場合:

aws rds modify-db-instance \
    --db-instance-identifier database-1 \
    --db-parameter-group-name mydbpg \
    --apply-immediately

Windows の場合:

aws rds modify-db-instance ^
    --db-instance-identifier database-1 ^
    --db-parameter-group-name mydbpg ^
    --apply-immediately

DB パラメータグループを DB インスタンスに関連付けるには、RDS API ModifyDBInstance オペレーションを次のパラメータとともに使用します。

  • DBInstanceName

  • DBParameterGroupName

DB クラスターパラメータグループと DB クラスターの関連付け

カスタマイズした設定を使用して、独自の DB クラスターパラメータグループを作成できます。AWS Management Console、AWS CLI、または RDS API を使用して、DB クラスターパラメータグループを DB クラスターに関連付けることができます。DB クラスターを作成または変更するときに行うことができます。

DB クラスターのパラメータグループの作成については、DB クラスターのパラメータグループの作成 を参照してください。DB クラスターの作成方法については、Amazon Aurora DB クラスターの作成 を参照してください。DB クラスターの変更については、「Amazon Aurora DB クラスターの変更」を参照してください。

注記

DB クラスターに関連付けられている DB クラスターパラメータグループを変更した後、クラスター内のプライマリ DB インスタンスを再起動して、クラスター内のすべての DB インスタンスに変更を適用します。

変更を適用するために DB クラスターのプライマリ DB インスタンスを再起動する必要があるかどうかを判断するには、以下の AWS CLI コマンドを実行します。

aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier

出力でプライマリ DB インスタンスの DBClusterParameterGroupStatus 値を確認します。値が pending-reboot の場合は、DB クラスターのプライマリ DB インスタンスを再起動します。

DB クラスターパラメータグループを DB クラスターに関連付けるには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[データベース] を選択し、変更する DB クラスターを選択します。

  3. [Modify] を選択します。[DB クラスターの変更] ページが表示されます。

  4. DB クラスターパラメータグループの設定を変更します。

  5. [Continue] を選択して、変更の概要を確認します。

    [Scheduling of modifications (変更のスケジュール)] 設定に関係なく、変更はすぐに適用されます。

  6. 確認ページで、変更内容を確認します。正しい場合は、[クラスターの変更] を選択して変更を保存します。

    または、[Back] を選択して変更を編集するか、[Cancel] を選択して変更をキャンセルします。

DB クラスターパラメータグループを DB クラスターに関連付けるには、以下のオプションを指定して AWS CLI modify-db-cluster コマンドを使用します。

  • --db-cluster-name

  • --db-cluster-parameter-group-name

次の例では、mydbclpg DB パラメータグループを mydbcluster DB クラスターに関連付けます。

例

Linux、macOS、Unix の場合:

aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --db-cluster-parameter-group-name mydbclpg

Windows の場合:

aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --db-cluster-parameter-group-name mydbclpg

DB クラスターパラメータグループを DB クラスターに関連付けるには、RDS API ModifyDBCluster オペレーションを次のパラメータと共に使用します。

  • DBClusterIdentifier

  • DBClusterParameterGroupName

DB パラメータグループのパラメータの変更

ユーザー定義の DB パラメータグループのパラメータ値は変更できますが、デフォルトの DB パラメータグループのパラメータ値を変更することはできません。ユーザー定義の DB パラメータグループのパラメータの変更は、その DB パラメータグループに関連付けられたすべての DB インスタンスに適用されます。

一部のパラメータへの変更は、再起動せずに直ちに DB インスタンスに適用されます。他のパラメータの変更は、DB インスタンスの再起動後にのみ適用されます。DB インスタンスに関連付けられている DB パラメータグループのステータスは、RDS コンソールの [設定] タブに表示されます。例えば、DB インスタンスがその関連付けられた DB パラメータグループの最新の変更を使用していない場合、RDS コンソールは、DB パラメータグループのステータスを [再起動の保留中] と表示します。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。

再起動保留中のパラメータ変更のシナリオ

DB パラメータグループを変更するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストで、変更するパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。

  5. 変更するパラメータの値を変更します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。

    デフォルトパラメータグループの値を変更することはできません。

  6. [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 クラスターパラメータグループを変更するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストで、変更するパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。

  5. 変更するパラメータの値を変更します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。

    デフォルトパラメータグループの値を変更することはできません。

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

  7. クラスター内のプライマリ 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 インスタンスに適用されます。

コンソールを使用すると、特定のパラメータをデフォルト値にリセットできますが、DBパラメータグループ内のすべてのパラメータを一度にリセットするのは簡単ではありません。AWS CLIまたは RDS API を使用すると、特定のパラメータをデフォルト値にリセットでき、DB パラメータグループ内のすべてのパラメータを一度にリセットできます。

一部のパラメータへの変更は、再起動せずに直ちに DB インスタンスに適用されます。他のパラメータの変更は、DB インスタンスの再起動後にのみ適用されます。DB インスタンスに関連付けられている DB パラメータグループのステータスは、RDS コンソールの [設定] タブに表示されます。例えば、DB インスタンスがその関連付けられた DB パラメータグループの最新の変更を使用していない場合、RDS コンソールは、DB パラメータグループのステータスを [再起動の保留中] と表示します。パラメータの最新の変更を DB インスタンスに適用するには、DB インスタンスを手動で再起動します。

再起動保留中のパラメータ変更のシナリオ
注記

デフォルトの DB パラメータグループでは、パラメーターは常にデフォルト値に設定されます。

DB パラメータグループのパラメータをデフォルト値にリセットするには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストからパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。

  5. デフォルト値にリセットするパラメータを選択します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。

    デフォルトのパラメータグループの値をリセットすることはできません。

  6. リセットを選択し、パラメータをリセットを選択して確定します。

DB パラメータグループの一部またはすべてのパラメータをリセットするには、AWS CLIreset-db-parameter-groupコマンドに必須オプション--db-parameter-group-nameを指定します。

DB パラメータグループのすべてのパラメータをリセットするには、--reset-all-parametersオプションを指定します。特定のパラメータをリセットするには、--parametersオプションを指定します。

次の例では、mydbparametergroupという名前の DB パラメータグループ内のすべてのパラメータをデフォルト値にリセットします。

例

Linux、macOS、Unix の場合:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Windows の場合:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --reset-all-parameters

次の例では、mydbparametergroupという名前のDBパラメータグループのmax_connectionsおよびmax_allowed_packetオプションをデフォルト値にリセットします。

例

Linux、macOS、Unix の場合:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Windows の場合:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

このコマンドでは、以下のような出力が生成されます。

DBParameterGroupName  mydbparametergroup

DBパラメータグループ内のパラメータをデフォルト値にリセットするには、RDS APIResetDBParameterGroupコマンドに必須パラメータDBParameterGroupNameを指定します。

DB パラメータグループのすべてのパラメータをリセットするには、ResetAllParametersパラメータをtrueに設定します。特定のパラメータをリセットするには、Parametersパラメータを指定します。

DB クラスターパラメータグループのパラメータのリセット

顧客が作成した DB クラスターパラメータグループの、デフォルト値のパラメータはリセットできます。ユーザー定義の DB クラスターパラメータグループのパラメータの変更は、その DB クラスターパラメータグループに関連付けられたすべての DB クラスターに適用されます。

注記

デフォルトの DB クラスターパラメータグループでは、パラメータは常にデフォルト値に設定されます。

DB クラスターパラメータグループのパラメータをデフォルト値にリセットするには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストからパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[編集] を選択します。

  5. デフォルト値にリセットするパラメータを選択します。ダイアログボックスの右上にある矢印キーを使用して、パラメータをスクロールできます。

    デフォルトのパラメータグループの値をリセットすることはできません。

  6. リセットを選択し、パラメータをリセットを選択して確定します。

  7. DB クラスター内のプライマリ DB インスタンスを再起動して、DB クラスター内のすべての DB インスタンスに変更を適用します。

DB クラスターパラメータグループのパラメータをデフォルト値にリセットするには、以下の必須オプションを指定して AWS CLIreset-db-cluster-parameter-group コマンドを使用します。--db-cluster-parameter-group-name

DB クラスターパラメータグループのパラメータをすべてリセットするには、--reset-all-parameters オプションを指定します。特定のパラメータをリセットするには、--parametersオプションを指定します。

次の例では、mydbparametergroupという名前の DB パラメータグループ内のすべてのパラメータをデフォルト値にリセットします。

例

Linux、macOS、Unix の場合:

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Windows の場合:

aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbparametergroup ^
    --reset-all-parameters

以下の例では、mydbclusterparametergroup という名前の DB クラスターパラメータグループにある server_audit_logging と server_audit_logs_upload をデフォルト値にリセットしています。

例

Linux、macOS、Unix の場合:

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Windows の場合:

aws rds reset-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"

このコマンドでは、以下のような出力が生成されます。

DBClusterParameterGroupName  mydbclusterparametergroup

DB クラスターパラメータグループのパラメータをデフォルト値にリセットするには、以下の必須パラメータを指定して、RDS API ResetDBClusterParameterGroupコマンドを使用します。DBClusterParameterGroupName

DB クラスターパラメータグループのパラメータをすべてリセットするには、ResetAllParameters パラメータを true に設定します。特定のパラメータをリセットするには、Parametersパラメータを指定します。

DB パラメータグループをコピーする

作成したカスタム DB パラメータグループをコピーできます。パラメータグループのコピーは、作成済みの DB パラメータグループがあり、そのグループの多くのカスタムパラメータと値を新しい DB パラメータグループに含める必要がある場合に便利な方法です。DB パラメータグループをコピーするには、AWS Management Console、AWS CLI の copy-db-parameter-group コマンド、RDS API の CopyDBParameterGroup オペレーションのいずれかを使用できます。

DB パラメータグループをコピーした後で、その DB パラメータグループをデフォルトのパラメータグループとして使用する最初の DB インスタンスを作成するまで、最低 5 分待ちます。これにより、パラメータグループを使用する前に、Amazon RDS はコピーアクションが完全に終了できます。これは、DB インスタンスのデフォルトのデータベースを作成する際に不可欠となるパラメータで特に重要です。例としては、character_set_database パラメータで定義するデフォルトのデータベースの文字セットが挙げられます。DB パラメータグループが作成されたことを確認するには、Amazon RDS コンソールの [パラメータグループ] オプション、または describe-db-parameters コマンドを使用します。

注記

デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。

現時点では、パラメータグループを別の AWS リージョンにコピーすることはできません。

DB パラメータグループをコピーするには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストで、コピーするカスタムパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[コピー] を選択します。

  5. [新規の DB パラメータグループの識別子] に、新しいパラメータグループの名前を入力します。

  6. [説明] に、新しいパラメータグループの説明を入力します。

  7. [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-identifier mygroup2 \
    --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-identifier mygroup2 ^
    --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 コンソールの [パラメータグループ] オプションまたは describe-db-cluster-parameters コマンドを使用できます。

注記

デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。

DB クラスターパラメータグループをコピーするには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストで、コピーするカスタムパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[コピー] を選択します。

  5. [新規の DB パラメータグループの識別子] に、新しいパラメータグループの名前を入力します。

  6. [説明] に、新しいパラメータグループの説明を入力します。

  7. [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 クラスターパラメータグループ mygroup2 のコピーである mygroup1 という名前の新しい DB クラスターパラメータグループを作成します。

例

Linux、macOS、Unix の場合:

aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mygroup1 \
    --target-db-cluster-parameter-group-identifier mygroup2 \
    --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-identifier mygroup2 ^
    --target-db-cluster-parameter-group-description "DB parameter group 2"

DB クラスターパラメータグループをコピーするには、以下の必須パラメータを指定して、RDS API の CopyDBClusterParameterGroup オペレーションを使用します。

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

DB パラメータグループを一覧表示する

AWS アカウント用に作成した DB パラメータグループを一覧表示できます。

注記

デフォルトのパラメータグループは、特定の DB エンジンとバージョンの DB インスタンスを作成するときに、デフォルトのパラメータテンプレートから自動的に作成されます。これらのデフォルトのパラメータグループには、優先されるパラメータ設定が含まれています。これを変更することはできません。カスタムパラメータグループを作成する場合、パラメータ設定を変更できます。

AWS アカウントのすべての DB パラメータグループを一覧表示するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

    DB パラメータグループがリストに表示されます。

AWS アカウントのすべての DB パラメータグループを一覧表示するには、AWS CLI の describe-db-parameter-groups コマンドを使用します。

例

以下の例では、AWS アカウントに使用できるすべての DB パラメータグループを一覧表示しています。

aws rds describe-db-parameter-groups

このコマンドでは次のようなレスポンスが返されます。

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.6  My new parameter group

AWS アカウントのすべての DB パラメータグループを一覧表示するには、RDS API の DescribeDBParameterGroups オペレーションを使用します。

DB クラスターのパラメータグループのリスト化

AWS アカウント用に作成した DB クラスターパラメータグループを一覧表示できます。

注記

デフォルトのパラメータグループは、特定の DB エンジンとバージョンの DB クラスターを作成するときに、デフォルトのパラメータテンプレートから自動的に作成されます。これらのデフォルトのパラメータグループには、優先されるパラメータ設定が含まれています。これを変更することはできません。カスタムパラメータグループを作成する場合、パラメータ設定を変更できます。

AWS アカウントのすべての DB クラスターパラメータグループを一覧表示するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

    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 パラメータグループのパラメータ値を表示するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

    DB パラメータグループがリストに表示されます。

  3. パラメータを一覧表示するパラメータグループの名前を選択します。

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 クラスターパラメータグループのパラメータ値を表示するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

    DB クラスターパラメータグループは、[Type] (タイプ) が [DB cluster parameter group] (DB クラスターパラメータグループ) のリストに表示されます。

  3. パラメータを一覧表示する 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 Management Console を使用して、同じ DB エンジンおよびバージョンの 2 つのパラメータグループ間の差異を表示できます。

2 つのパラメータグループを比較するには

  1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. リストで、比較する 2 つのパラメータグループを選択します。

  4. [Parameter group actions (パラメータグループのアクション)] で、[比較] を選択します。

    注記

    選択した項目が同等でない場合は、比較 を選択することはできません。例えば、MySQL 5.6 と MySQL 5.7 のパラメータグループを比較することはできません。また、DB パラメータグループと Aurora DB クラスターパラメーターグループを比較することもできません。

DB パラメータの指定

DB パラメータの種類には、次のものがあります。

  • integer

  • ブール値

  • 文字列

  • long

  • double

  • timestamp

  • 他の定義されたデータ型のオブジェクト

  • 整数、ブール値、文字列、長整数、倍精度、タイムスタンプ、オブジェクト型の値の配列

式、数式、関数を使用して、整数およびブール型 DB パラメータを指定することもできます。

DB パラメータ式

DB パラメータ式は整数値に解決される式あるいはブール値です。式は中かっこ {} で囲みます。式は、DB パラメータ値、またはDB パラメータ関数の引数として使用できます。

構文
{FormulaVariable}
{FormulaVariable*Integer}
{FormulaVariable*Integer/Integer}
{FormulaVariable/Integer}

DB パラメータ式の変数

各式の変数は整数あるいはブール値を返します。変数名では大文字と小文字が区別されます。

AllocatedStorage

データボリュームのサイズ (バイト単位) を表す整数を返します。

DBInstanceClassMemory

現在の DB インスタンスに関連付けられている DB インスタンスクラスに割り当てられたメモリから、インスタンスを管理する RDS プロセスによって使用されるメモリを引いたバイト数を整数で返します。

EndPointPort

DB インスタンスに接続するときに使用されるポートを表す整数を返します。

DB パラメータ式の演算子

DB パラメータ式では、2 つ演算子 (除算と乗算) がサポートされています。

除算演算子: /

被除数を除数で割り、整数の商を返します。商の小数部分は四捨五入されず切り捨てられます。

構文

dividend / divisor

被除数と除数の引数は整数式である必要があります。

乗算演算子: *

式を乗算し、式の積を返します。式の小数部分は四捨五入されず切り捨てられます。

構文

expression * expression

両方の式は整数である必要があります。

DB パラメータ関数

DB パラメータ関数の引数は、整数または数式で指定します。各関数には 1 つ以上の引数が必要です。複数の引数をカンマ区切りのリストで指定します。リストには、argument1,,argument3 など、空のメンバーを使用することはできません。関数名では大文字と小文字は区別されません。

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 パラメータ値をログ式に設定できます。式は中かっこ {} で囲みます。次に例を示します。 

{log(DBInstanceClassMemory/8187281418)*1000}

log 関数はログベース 2 を表します。この例では、DBInstanceClassMemory 数式変数も使用しています。「DB パラメータ式の変数」を参照してください。

DB パラメータ値の例

これらの例は、DB パラメータの値に対して数式、関数、および式を使用していることを示しています。

注記

DB パラメータ関数は現在、コンソールでのみサポートされており、AWS CLI ではサポートされていません。

警告

DB パラメータグループのパラメータを不適切に設定すると、意図しない悪影響が生じる可能性があります。これには、パフォーマンスの低下やシステムの不安定化が含まれます。データベースパラメータの変更時には注意が必要です。DB パラメータグループの変更前にはデータをバックアップしてください。パラメータグループの変更は、テスト DB インスタンス (ポイントインタイム復元を使用して作成) で試してから、本番稼働用 DB インスタンスに適用してください。

例 DB パラメータ関数 LEAST の使用

Aurora MySQL LEAST パラメータ値で table_definition_cache 関数を指定できます。これを使用して、定義キャッシュに保管できるテーブル定義の数を DBInstanceClassMemory/393040 または 20,000 のいずれか少ない方に設定します。 

LEAST({DBInstanceClassMemory/393040}, 20000)