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

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 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 パラメータグループに関連付けられます。クラスターまたは新しい 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 パラメータグループを作成するには

  1. AWS マネジメントコンソールにサインインし、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 マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。

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

  1. AWS マネジメントコンソールにサインインし、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. [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-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 パラメータグループのパラメータ値を変更することはできません。ユーザー定義の DB パラメータグループのパラメータの変更は、その DB パラメータグループに関連付けられたすべての DB インスタンスに適用されます。

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

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

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

  1. AWS マネジメントコンソールにサインインし、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 マネジメントコンソールにサインインし、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 パラメータグループをコピーするには、AWS マネジメントコンソール、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 マネジメントコンソールにサインインし、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 マネジメントコンソールにサインインし、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 クラスターパラメータグループ 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-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 マネジメントコンソールにサインインし、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.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 クラスターパラメータグループを一覧表示するには

  1. AWS マネジメントコンソールにサインインし、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 マネジメントコンソールにサインインし、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 マネジメントコンソールにサインインし、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 マネジメントコンソール を使用して、同じ DB エンジンおよびバージョンの 2 つのパラメータグループ間の差異を表示できます。

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

  1. AWS マネジメントコンソールにサインインし、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 パラメータの値は、以下のいずれかとして指定できます。

  • 整数定数

  • 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)