

# Amazon Aurora のパラメータグループ
<a name="USER_WorkingWithParamGroups"></a>

*データベースパラメータ*は、データベースの設定方法を指定します。データベースパラメータでは、データベースに割り当てるメモリなどのリソースの量を指定できます。

DB インスタンスとAurora DB クラスターをパラメータグループに関連付けて、データベースの設定を管理します。Aurora は、デフォルト設定を使用してパラメータグループを定義します。カスタマイズした設定を使用して独自のパラメータグループを定義できます。

**Topics**
+ [

# パラメータグループの概要
](parameter-groups-overview.md)
+ [

# Amazon Aurora DB クラスターの DB クラスターパラメータグループ
](USER_WorkingWithDBClusterParamGroups.md)
+ [

# Amazon Aurora DB インスタンスの DB パラメータグループ
](USER_WorkingWithDBInstanceParamGroups.md)
+ [

# DB パラメータグループを比較する
](USER_WorkingWithParamGroups.Comparing.md)
+ [

# DB パラメータの指定
](USER_ParamValuesRef.md)

# パラメータグループの概要
<a name="parameter-groups-overview"></a>

*DB クラスターパラメータグループ*は、Aurora DB クラスター内のすべての DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。例えば、Aurora 共有ストレージモデルでは、Aurora クラスター内のすべての DB インスタンスが `innodb_file_per_table` などのパラメータで同じ設定を使用することが要求されます。したがって、物理的なストレージレイアウトに影響するパラメータは、クラスターパラメータグループの一部です。DB クラスターパラメータグループには、インスタンスレベルのすべてのパラメータのデフォルト値も含まれています。

*DB パラメータグループ*は、1 つ以上の DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。DB パラメータグループは、Amazon RDS と Aurora の両方の DB インスタンスに適用されます。これらの構成設定が適用されるプロパティ (メモリバッファのサイズなど) は、Aurora クラスター内の DB インスタンス間で異なる場合があります。



**Topics**
+ [

## デフォルトおよびカスタムパラメータグループ
](#parameter-groups-overview.custom)
+ [

## 静的および動的 DB クラスターパラメータ
](#parameter-groups-overview.db-cluster)
+ [

## 静的および動的 DB インスタンスパラメータ
](#parameter-groups-overview.db-instance)
+ [

## 文字セットパラメータ
](#parameter-groups-overview.char-sets)
+ [

## サポートされるパラメータとパラメータ値
](#parameter-groups-overview.supported)

## デフォルトおよびカスタムパラメータグループ
<a name="parameter-groups-overview.custom"></a>

DB パラメータグループを指定せずに DB インスタンスを作成すると、DB インスタンスはデフォルトの DB パラメータグループを使用します。同様に、DB クラスターパラメータグループを指定せずにAurora DB クラスターを作成すると、DB クラスターではデフォルトの DB クラスターパラメータグループが使用されます。デフォルトの各パラメータグループには、エンジン、コンピューティングクラス、およびインスタンスの割り当てストレージに基づいた、データベースエンジンのデフォルトと Amazon RDS システムのデフォルトが含まれています。

デフォルトのパラメータグループのパラメータ設定は変更できません。代わりに、以下を実行できます。

1. 新しいパラメータグループを作成します。

1. 必要なパラメータの設定を変更します。パラメータグループ内のすべての DB エンジンパラメータが変更できるわけではありません。

1. DB インスタンスまたは DB クラスターを変更して、新しいパラメータグループを関連付けます。

   DB クラスターまたは DB インスタンスの変更については、「[Amazon Aurora DB クラスターの変更](Aurora.Modifying.md)」を参照してください。
**注記**  
カスタムパラメータグループを使用するように DB インスタンスを変更して、DB インスタンスを起動すると、RDS は起動プロセスの一環として DB インスタンスを自動的に再起動します。常時オプションやミラーリングオプションが有効になっている RDS for SQL Server のマルチ AZ インスタンスの場合、スタートアッププロセス後にインスタンスを再起動すると、フェイルオーバーが予想されます。

RDS は、DB インスタンスの再起動後にのみ、変更された静的パラメータと動的パラメータを新しく関連付けられたパラメータグループに適用します。ただし、DB インスタンスに関連付けた後に DB パラメータグループの動的パラメータを変更すると、これらの変更は再起動せずに直ちに適用されます。DB パラメータグループの変更については、「[Amazon Aurora DB クラスターの変更](Aurora.Modifying.md)」を参照してください。

DB パラメータグループ内のパラメータを更新すると、このパラメータグループに関連付けられたすべての DB インスタンスに変更が適用されます。同様に、Aurora DB クラスターパラメータグループ内のパラメータを更新すると、この DB クラスターパラメータグループに関連付けられたすべての Aurora DB クラスターに変更が適用されます。

パラメータグループを最初から作成したくない場合は、AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) コマンドまたは [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) コマンドを使用して、既存のパラメータグループをコピーできます。場合によっては、パラメータグループをコピーすると便利なことがあります。例えば、既存の パラメータグループのカスタムパラメータと値のほとんどを新しい パラメータグループに含めたい場合です。

## 静的および動的 DB クラスターパラメータ
<a name="parameter-groups-overview.db-cluster"></a>

DB クラスターパラメータは静的または動的に使用することができます。これらは次の点で異なります。
+ 静的パラメータを変更して DB クラスターのパラメータグループを保存する場合、パラメータの変更は、関連付けられている各 DB クラスター内の DB インスタンスを手動で再起動した後に有効になります。AWS マネジメントコンソール を使用して静的 DB クラスターパラメータ値を変更するときには、常に `ApplyMethod` として `pending-reboot` を使用します。
+ 動的パラメータを変更すると、デフォルトでは、パラメータの変更は直ちに有効になり、再起動は不要です。コンソールを使用する場合、常に `ApplyMethod` として `immediate` を使用します。パラメータの変更を、関連付けられている DB クラスター内の DB インスタンスが再起動されるまで延期するには、AWS CLI または RDS API を使用します。パラメータを変更する場合は、`ApplyMethod` を `pending-reboot` に設定します。

AWS CLI を使用してパラメータ値を変更する方法については、「[modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html)」を参照してください。RDS API を使用してパラメータ値を変更する方法については、「[ModifyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html)」を参照してください。

DB クラスターに関連付けられている 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 インスタンスパラメータ
<a name="parameter-groups-overview.db-instance"></a>

DB インスタンスパラメータは静的または動的に使用することができます。違いについては下記をご覧ください。
+ 静的パラメータを変更して DB パラメータグループを保存すると、パラメータの変更は関連付けられている DB インスタンスを手動で再起動した後に有効になります。静的パラメータの場合、コンソールは常に `ApplyMethod` として `pending-reboot` を使用します。
+ 動的パラメータを変更すると、デフォルトでは、パラメータの変更は直ちに有効になり、再起動は不要です。AWS マネジメントコンソール を使用して DB インスタンスのパラメータ値を変更するときには、常に動的パラメータ向けの `ApplyMethod` として `immediate` を使用します。パラメータの変更を、関連付けられている DB インスタンスが再起動されるまで延期するには、AWS CLI または RDS API を使用します。パラメータを変更する場合は、`ApplyMethod` を `pending-reboot` に設定します。

AWS CLI を使用してパラメータ値を変更する方法については、「[modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html)」を参照してください。RDS API を使用してパラメータ値を変更する方法については、「[ModifyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html)」を参照してください。

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

## 文字セットパラメータ
<a name="parameter-groups-overview.char-sets"></a>

DB クラスターを作成する前に、パラメータグループに含まれるデータベースの文字セットまたは照合に関するパラメータを設定します。また、その中にデータベースを作成する前にも行ってください。これにより、デフォルトのデータベースと新しいデータベースで、指定した文字セットと照合順序が使用されるようになります。文字セットまたは照合パラメータを変更した場合、パラメータの変更は既存のデータベースに適用されません。

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

```
ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
```

データベースの文字セットまたは照合値の変更の詳細については、DB エンジンのドキュメントを参照してください。

## サポートされるパラメータとパラメータ値
<a name="parameter-groups-overview.supported"></a>

DB エンジンでサポートされているパラメータを決定するには、DB インスタンスまたは DB クラスターで使用される DB パラメータグループおよび DB クラスターパラメータグループのパラメータを表示します。詳細については、「[Amazon Aurora のDB パラメータグループのパラメータ値の表示](USER_WorkingWithParamGroups.Viewing.md)」および「[Amazon Aurora での DB クラスターパラメータグループのパラメータ値の表示](USER_WorkingWithParamGroups.ViewingCluster.md)」を参照してください。

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

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

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

# Amazon Aurora DB クラスターの DB クラスターパラメータグループ
<a name="USER_WorkingWithDBClusterParamGroups"></a>

Amazon Aurora DB クラスターでは、DB クラスターパラメータグループが使用されます。次のセクションでは、DB クラスターパラメータグループの設定と管理について説明します。

**Topics**
+ [

## Amazon Aurora の DB クラスターパラメータと DB インスタンスパラメータ
](#Aurora.Managing.ParameterGroups)
+ [

# Amazon Aurora での DB クラスターパラメータグループの作成
](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループと DB クラスターの関連付け
](USER_WorkingWithParamGroups.AssociatingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループのパラメータの変更
](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループのパラメータのリセット
](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループのコピー
](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループの一覧表示
](USER_WorkingWithParamGroups.ListingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループのパラメータ値の表示
](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [

# Amazon Aurora での DB クラスターパラメータグループの削除
](USER_WorkingWithParamGroups.DeletingCluster.md)

## Amazon Aurora の DB クラスターパラメータと DB インスタンスパラメータ
<a name="Aurora.Managing.ParameterGroups"></a>

 Aurora は、以下に示すように、2 レベルシステムの構成設定を使用します。
+  *DB クラスターパラメータグループ*のパラメータは、DB クラスター内のすべての DB インスタンスに適用されます。データは、Aurora 共有ストレージサブシステムに保存されます。このため、テーブルデータの物理レイアウトに関連するすべてのパラメータは、Aurora クラスター内のすべての DB インスタンスで同じにする必要があります。同様に、Aurora DB インスタンスはレプリケーションで接続されているため、レプリケーション設定のすべてのパラメータは Aurora クラスター全体で同じにする必要があります。
+  *DB パラメータグループ*のパラメータは、Aurora DB クラスター内の単一の DB インスタンスに適用されます。これらのパラメータは、同じ Aurora クラスター内の DB インスタンス間で変化させることができるメモリ使用量などの要素に関連しています。例えば、クラスターには、AWS インスタンスクラスが異なる DB インスタンスが含まれる場合がよくあります。

 すべての Aurora クラスターは、DB クラスターパラメータグループに関連付けられます。このパラメータグループは、対応する DB エンジンのすべての設定値にデフォルト値を割り当てます。クラスターパラメータグループには、クラスターレベルとインスタンスレベル両方のパラメータのデフォルトも含まれています。プロビジョニングされたクラスターまたは Aurora Serverless v2 クラスター内の各 DB インスタンスは、その DB クラスターパラメータグループから設定を継承します。

 各 DB インスタンスにも DB パラメータグループが関連付けられます。DB パラメータグループの値によって、クラスターパラメータグループのデフォルト値をオーバーライドできます。例えば、クラスター内の 1 つのインスタンスに問題が発生した場合、そのインスタンスにカスタム DB パラメータグループを割り当てることができます。カスタムパラメータグループには、デバッグまたはパフォーマンスチューニングに関連するパラメータとして特定の設定を含めることができます。

 Aurora は、指定されたデータベースエンジンおよびバージョンに基づいて、クラスターまたは新しい DB インスタンスを作成すると、デフォルトのパラメータグループを割り当てます。カスタムパラメータグループを指定することもできます。これらのパラメータグループは自分で作成し、パラメータ値を編集できます。これらのカスタムパラメータグループは、作成時に指定できます。DB クラスターまたはインスタンスを後で変更して、カスタムパラメータグループを使用することもできます。

 プロビジョニングされたインスタンスと Aurora Serverless v2 インスタンス化の場合、DB クラスターパラメータグループで変更した設定値は、DB パラメータグループのデフォルト値をオーバーライドします。DB パラメータグループ内の対応する値を編集すると、これらの値によって DB クラスターパラメータグループの設定が上書きされます。

 変更した DB パラメータ設定は、構成設定を変更してデフォルト値に戻した場合でも、DB クラスターパラメータグループ値より優先されます。どのパラメータがオーバーライドされるかは、[describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI コマンドまたは [DescribeDBParameters](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) RDS API を使用して確認できます。`Source` フィールドには、該当するパラメータを変更した場合に、値 `user` が含まれます。DB クラスターパラメータグループの値が優先されるように、1 つ以上のパラメータをリセットするには、[reset-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) AWS CLI コンポーネントまたは [ResetDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) RDS API オペレーションを使用します。

DB クラスターと、Aurora で利用可能な DB インスタンスパラメータは、データベースエンジンの互換性に応じて異なります。


| データベースエンジン | パラメータ | 
| --- | --- | 
|  Aurora MySQL  |  「[Aurora MySQL 設定パラメータ](AuroraMySQL.Reference.ParameterGroups.md)」を参照してください。  Aurora Serverless クラスターの詳細については、[Aurora Serverless v2 のパラメータグループを使用する](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) と [Aurora Serverless v1 のパラメータグループ](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups) のその他の詳細を参照してください。  | 
|  Aurora PostgreSQL  |  「[Amazon Aurora PostgreSQL のパラメータ](AuroraPostgreSQL.Reference.ParameterGroups.md)」を参照してください。  Aurora Serverless クラスターの詳細については、[Aurora Serverless v2 のパラメータグループを使用する](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) と [Aurora Serverless v1 のパラメータグループ](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups) のその他の詳細を参照してください。  | 

**注記**  
 Aurora Serverless v1 クラスターには、DB クラスターパラメータグループのみ関連付けられており、DB パラメータグループは関連付けられていません。Aurora Serverless v2 クラスターでは、すべての変更は、DB クラスターパラメータグループ内のカスタムパラメータに対して行います。  
 Aurora Serverless v2 は、DB クラスターパラメータグループと DB パラメータグループの両方を使用します。Aurora Serverless v2 では、ほぼすべての構成パラメータを変更できます。Aurora Serverless v2 は、一部の容量関連の構成パラメータの設定をオーバーライドして、Aurora Serverless v2 インスタンスがスケールダウンしたときにワークロードが中断されないようにします。  
 Aurora Serverless クラスターの構成設定と変更できる設定の詳細については、[Aurora Serverless v2 のパラメータグループを使用する](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) と [Aurora Serverless v1 のパラメータグループ](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups) を参照してください。

# Amazon Aurora での DB クラスターパラメータグループの作成
<a name="USER_WorkingWithParamGroups.CreatingCluster"></a>

新しい DB クラスターパラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。

DB クラスターパラメータグループの作成後、その DB クラスターパラメータグループを使用する最初の DB クラスターが作成されるまで、5 分以上かかります。これにより、Amazon RDS は新しい DB クラスターによって使用される前に、パラメータグループを完全に作成することができます。DB クラスターパラメータグループが作成されたことを確認するには、[Amazon RDS コンソール](https://console.aws.amazon.com/rds/)の **[パラメータグループ]** ページまたは [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) コマンドを使用できます。

DB クラスターパラメータグループ名には、次の制限事項が適用されます。
+ 名前は、1～255 の英字、数字、ハイフンである必要があります。

  デフォルトのパラメータグループ名には、`default.aurora-mysql5.7` のようなピリオドを含めることができます。ただし、カスタムパラメータグループ名にはピリオドを含めることはできません。
+ 1 字目は文字である必要があります。
+ 名前の最後にハイフンを使用したり、ハイフンを 2 つ続けて使用したりすることはできません。

## コンソール
<a name="USER_WorkingWithParamGroups.CreatingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. **[パラメータグループの作成]** を選択します。

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

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

1. **[エンジンタイプ]** でデータベースエンジンを選択します。

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.CreatingCluster.CLI"></a>

DB クラスターのパラメータグループを作成するには、AWS CLI​ の [​`create-db-cluster-parameter-group`](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html)​ コマンドを使用します。

次の例では、Aurora MySQL バージョン 5.7 用に、*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"
```

**注記**  
出力は重複が含まれます。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new cluster parameter group"
```
Windows の場合:  

```
aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new cluster parameter group"
```
このコマンドでは、以下のような出力が生成されます。  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "aurora-mysql5.7",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
    }
}
```

## RDS API
<a name="USER_WorkingWithParamGroups.CreatingCluster.API"></a>

DB クラスターのパラメータグループを作成するには、​RDS API の ​[https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html) アクションを使用します。

以下の必須パラメータを含めます。
+ `DBClusterParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`

# Amazon Aurora での DB クラスターパラメータグループと DB クラスターの関連付け
<a name="USER_WorkingWithParamGroups.AssociatingCluster"></a>

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

DB クラスターのパラメータグループの作成については、[Amazon Aurora での DB クラスターパラメータグループの作成](USER_WorkingWithParamGroups.CreatingCluster.md) を参照してください。DB クラスターの作成方法については、[Amazon Aurora DB クラスターの作成](Aurora.CreateInstance.md) を参照してください。DB クラスターの変更については、「[Amazon Aurora DB クラスターの変更](Aurora.Modifying.md)」を参照してください。

**注記**  
Aurora PostgreSQL 15.2、14.7、13.10、12.14、および 11 のすべてのバージョンでは、DB クラスターに関連付けられている DB クラスターパラメータグループを変更するときに、各レプリカインスタンスを再起動して変更を適用します。  
変更を適用するために DB クラスターのプライマリ DB インスタンスを再起動する必要があるかどうかを判定するには、以下の AWS CLI コマンドを実行します。  
`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`  
出力でプライマリ DB インスタンスの `DBClusterParameterGroupStatus` 値を確認します。値が `pending-reboot` の場合は、DB クラスターのプライマリ DB インスタンスを再起動します。

## コンソール
<a name="USER_WorkingWithParamGroups.AssociatingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.AssociatingCluster.CLI"></a>

DB クラスターのパラメータグループと DB クラスターを関連付けるには、以下のオプションを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) コマンドを使用します。
+ `--db-cluster-name`
+ `--db-cluster-parameter-group-name`

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

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.AssociatingCluster.API"></a>

DB クラスターパラメータグループと DB クラスターを関連付けるには、以下のパラメータを指定しながら RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) オペレーションを使用します。
+ `DBClusterIdentifier`
+ `DBClusterParameterGroupName`

# Amazon Aurora での DB クラスターパラメータグループのパラメータの変更
<a name="USER_WorkingWithParamGroups.ModifyingCluster"></a>

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

## コンソール
<a name="USER_WorkingWithParamGroups.ModifyingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

1. **[変更を保存]** をクリックします。

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

1. 次に、リーダー DB インスタンスを再起動して、変更を適用します。

   DB インスタンスを再起動しない場合、フェイルオーバーオペレーションに通常よりも時間がかかることがあります。

## AWS CLI
<a name="USER_WorkingWithParamGroups.ModifyingCluster.CLI"></a>

DB クラスターパラメータグループを変更するには、以下の必須パラメータを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) コマンドを使用します。
+ `--db-cluster-parameter-group-name`
+ `--parameters`

以下の例では、*mydbclusterparametergroup *という名前の DB クラスターパラメータグループの `server_audit_logging` と `server_audit_logs_upload` の値を変更しています。

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.ModifyingCluster.API"></a>

DB クラスターのパラメータグループを変更するには、以下の必須パラメータを指定しながら RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) コマンドを使用します。
+ `DBClusterParameterGroupName`
+ `Parameters`

# Amazon Aurora での DB クラスターパラメータグループのパラメータのリセット
<a name="USER_WorkingWithParamGroups.ResettingCluster"></a>

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

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

## コンソール
<a name="USER_WorkingWithParamGroups.ResettingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.ResettingCluster.CLI"></a>

DB クラスターのパラメータグループにおいて、パラメータをデフォルト値にリセットするには、以下の `--db-cluster-parameter-group-name` オプション (必須) を指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html) コマンドを使用します。

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

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

**Example**  
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` をデフォルト値にリセットしています。

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.ResettingCluster.API"></a>

DB クラスターパラメータグループのパラメータをデフォルト値にリセットするには、以下の必須パラメータを指定して、RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html)コマンドを使用します。`DBClusterParameterGroupName`

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

# Amazon Aurora での DB クラスターパラメータグループのコピー
<a name="USER_WorkingWithParamGroups.CopyingCluster"></a>

作成したカスタム DB クラスターパラメータグループをコピーできます。パラメータグループのコピーは、作成済みの DB クラスターパラメータグループがあり、そのグループの多くのカスタムパラメータと値を新しい DB クラスターパラメータグループに含める必要がある場合に便利な方法です。DB クラスターパラメータグループをコピーするには、AWS CLI [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) コマンド、または RDS API [CopyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) オペレーションを使用できます。

DB クラスターパラメータグループをコピーした後で、この DB クラスターパラメータグループを使用する DB クラスターを作成するまで、5 分以上かかります。これにより、Amazon RDS は新しい DB クラスターによって使用される前に、パラメータグループを完全にコピーすることができます。DB クラスターパラメータグループが作成されたことを確認するには、[Amazon RDS コンソール](https://console.aws.amazon.com/rds/)の **[Parameter groups]** (パラメータグループ) ページまたは [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) コマンドを使用できます。

**注記**  
デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。  
DB クラスターパラメータグループを別の AWS アカウント または AWS リージョン にコピーすることはできません。

## コンソール
<a name="USER_WorkingWithParamGroups.CopyingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

1. [**Copy (コピー)**] を選択します。

## AWS CLI
<a name="USER_WorkingWithParamGroups.CopyingCluster.CLI"></a>

DB クラスターのパラメータグループをコピーするには、以下の必須パラメータを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) コマンドを使用します。
+ `--source-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-description`

次の例は、DB クラスターパラメータグループ `mygroup2` のコピーである `mygroup1` という名前の新しい DB クラスターパラメータグループを作成します。

**Example**  
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"
```

## RDS API
<a name="USER_WorkingWithParamGroups.Copying.API"></a>

DB クラスターパラメータグループをコピーするには、以下の必須パラメータを指定して、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) オペレーションを使用します。
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`

# Amazon Aurora での DB クラスターパラメータグループの一覧表示
<a name="USER_WorkingWithParamGroups.ListingCluster"></a>

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

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

## コンソール
<a name="USER_WorkingWithParamGroups.ListingCluster.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.ListingCluster.CLI"></a>

AWS アカウントにある、すべての DB クラスターのパラメータグループを一覧表示するには、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html) コマンドを使用します。

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

```
aws rds describe-db-cluster-parameter-groups
```
次の例は、*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": [
        {
            "DBClusterParameterGroupName": "mydbclusterparametergroup",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}
```

## RDS API
<a name="USER_WorkingWithParamGroups.ListingCluster.API"></a>

AWS アカウントにある、すべての DB クラスターのパラメータグループを一覧表示するには、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html) アクションを使用します。

# Amazon Aurora での DB クラスターパラメータグループのパラメータ値の表示
<a name="USER_WorkingWithParamGroups.ViewingCluster"></a>

DB クラスターパラメータグループのすべてのパラメータとそれらの値のリストを取得できます。

## コンソール
<a name="USER_WorkingWithParamGroups.ViewingCluster.CON"></a>

**DB クラスターパラメータグループのパラメータ値を表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.ViewingCluster.CLI"></a>

DB クラスターのパラメータグループについて、そのパラメータ値を表示するには、以下の必須パラメータを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) コマンドを使用します。
+ `--db-cluster-parameter-group-name`

**Example**  
以下の例では、JSON 形式の *mydbclusterparametergroup* という名前の DB クラスターパラメータグループのパラメータとその値を一覧表示しています。  
このコマンドでは次のようなレスポンスが返されます。  

```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
```

```
{
    "Parameters": [
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "aurora_binlog_read_buffer_size",
            "ParameterValue": "5242880",
            "Description": "Read buffer size used by master dump thread when the switch aurora_binlog_use_large_read_buffer is ON.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "8192-536870912",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },

...
```

## RDS API
<a name="USER_WorkingWithParamGroups.ViewingCluster.API"></a>

DB クラスターパラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) コマンドを使用します。
+ `DBClusterParameterGroupName`

場合によっては、パラメータに指定できる値が表示されないことがあります。これらは常にソースがデータベースエンジンのデフォルトであるパラメータです。

これらのパラメータの値を表示するには、次の SQL ステートメントを実行します。
+ MySQL:

  ```
  -- Show the value of a particular parameter
  mysql$ SHOW VARIABLES LIKE '%parameter_name%';
  
  -- Show the values of all parameters
  mysql$ SHOW VARIABLES;
  ```
+ PostgreSQL:

  ```
  -- Show the value of a particular parameter
  postgresql=> SHOW parameter_name;
  
  -- Show the values of all parameters
  postgresql=> SHOW ALL;
  ```

# Amazon Aurora での DB クラスターパラメータグループの削除
<a name="USER_WorkingWithParamGroups.DeletingCluster"></a>

DB クラスターパラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使用して削除できます。DB クラスターパラメータグループは、DB クラスターに関連付けられていない場合にのみ削除できます。

## コンソール
<a name="USER_WorkingWithParamGroups.DeletingCluster.CON"></a>

**パラメータグループを削除するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

1. 削除する DB クラスターパラメータグループの名前を選択します。

1. **[アクション]** を選択し、**[削除]** を選択します。

1. パラメータグループ名を確認して、**[削除]** を選択します。

## AWS CLI
<a name="USER_WorkingWithParamGroups.DeletingCluster.CLI"></a>

DB クラスターパラメータグループを削除するには、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html) コマンドを使用して、次の必須パラメータを指定します。
+ `--db-parameter-group-name`

**Example**  
次の例では、**mydbparametergroup という名前の DB クラスターパラメータグループを削除します。  

```
aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup
```

## RDS API
<a name="USER_WorkingWithParamGroups.DeletingCluster.API"></a>

DB クラスターパラメータグループを削除するには、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) コマンドを使用して、次の必須パラメータを指定します。
+ `DBParameterGroupName`

# Amazon Aurora DB インスタンスの DB パラメータグループ
<a name="USER_WorkingWithDBInstanceParamGroups"></a>

DB インスタンスでは DB パラメータグループが使用されます。次のセクションでは、DB インスタンスパラメータグループの設定と管理について説明します。

**Topics**
+ [

# Amazon Aurora での DB パラメータグループの作成
](USER_WorkingWithParamGroups.Creating.md)
+ [

# Amazon Aurora で DB パラメータグループを DB インスタンスに関連付ける
](USER_WorkingWithParamGroups.Associating.md)
+ [

# Amazon Aurora の DB パラメータグループのパラメータの変更
](USER_WorkingWithParamGroups.Modifying.md)
+ [

# Amazon Aurora の DB パラメータグループのパラメータをデフォルト値にリセットします
](USER_WorkingWithParamGroups.Resetting.md)
+ [

# Amazon Aurora での DB パラメータグループのコピー
](USER_WorkingWithParamGroups.Copying.md)
+ [

# Amazon Aurora での DB パラメータグループの一覧表示
](USER_WorkingWithParamGroups.Listing.md)
+ [

# Amazon Aurora のDB パラメータグループのパラメータ値の表示
](USER_WorkingWithParamGroups.Viewing.md)
+ [

# Amazon Aurora での DB パラメータグループの削除
](USER_WorkingWithParamGroups.Deleting.md)

# Amazon Aurora での DB パラメータグループの作成
<a name="USER_WorkingWithParamGroups.Creating"></a>

新しい DB パラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。

DB パラメータグループ名には、次の制限事項が適用されます。
+ 名前は、1～255 の英字、数字、ハイフンである必要があります。

  デフォルトのパラメータグループ名には、`default.mysql8.0` のようなピリオドを含めることができます。ただし、カスタムパラメータグループ名にはピリオドを含めることはできません。
+ 1 字目は文字である必要があります。
+ 名前の最後にハイフンを使用したり、ハイフンを 2 つ続けて使用したりすることはできません。

## コンソール
<a name="USER_WorkingWithParamGroups.Creating.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. **[パラメータグループの作成]** を選択します。

1. **[パラメータグループ名]** に、新しい DB パラメータグループの名前を入力します。

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

1. **[エンジンタイプ]** で DB エンジンを選択します。

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

1. 該当する場合、**[タイプ]** で **[DB パラメータグループ]** を選択します。

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Creating.CLI"></a>

DB パラメータグループを作成するには、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) コマンドを使用します。以下の例では、MySQL バージョン 8.0 用に、*mydbparametergroup* という名前で、「*My new parameter group*」という説明の新しい DB パラメータグループを作成しています。

以下の必須パラメータを含めます。
+ `--db-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`

使用可能なすべてのパラメータグループファミリーを一覧表示するには、次のコマンドを使用します。

```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```

**注記**  
出力は重複が含まれます。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new parameter group"
```
Windows の場合:  

```
aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new parameter group"
```
このコマンドでは、以下のような出力が生成されます。  

```
DBPARAMETERGROUP  mydbparametergroup  aurora-mysql5.7  My new parameter group					
```

## RDS API
<a name="USER_WorkingWithParamGroups.Creating.API"></a>

DB パラメータグループを作成するには、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) オペレーションを使用します。

以下の必須パラメータを含めます。
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`

# Amazon Aurora で DB パラメータグループを DB インスタンスに関連付ける
<a name="USER_WorkingWithParamGroups.Associating"></a>

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

DB パラメータグループの作成については、[Amazon Aurora での DB パラメータグループの作成](USER_WorkingWithParamGroups.Creating.md) を参照してください。DB インスタンスの変更については、[DB クラスター内の DB インスタンスの変更](Aurora.Modifying.md#Aurora.Modifying.Instance)を参照してください。

**注記**  
新しい DB パラメータグループを DB インスタンスに関連付ける場合、変更された静的パラメータと動的パラメータは、DB インスタンスが再起動された後にのみ適用されます。ただし、DB インスタンスに関連付けた後に DB パラメータグループの動的パラメータを変更すると、これらの変更は再起動せずに直ちに適用されます。

## コンソール
<a name="USER_WorkingWithParamGroups.Associating.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. **[Modify]** (変更) を選択します。**Modify DB instance** ページが表示されます。

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Associating.CLI"></a>

DB パラメータグループを DB インスタンスに関連付けるには、以下のオプションを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) コマンドを使用します。
+ `--db-instance-identifier`
+ `--db-parameter-group-name`

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

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.Associating.API"></a>

DB パラメータグループを DB インスタンスに関連付けるには、以下のパラメータを指定しながら RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) オペレーションを使用します。
+ `DBInstanceName`
+ `DBParameterGroupName`

# Amazon Aurora の DB パラメータグループのパラメータの変更
<a name="USER_WorkingWithParamGroups.Modifying"></a>

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

パラメータには、動的パラメータと静的パラメータの 2 種類があります。動的パラメータへの変更は、再起動せずに直ちに DB インスタンスに適用されます。静的パラメータへの変更は、DB インスタンスの再起動後にのみ適用されます。

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

![\[再起動保留中のパラメータ変更のシナリオ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/db-cluster-instance-param-group.png)


## コンソール
<a name="USER_WorkingWithParamGroups.Modifying.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Modifying.CLI"></a>

DB パラメータグループを変更するには、次の必須オプションを指定して、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) コマンドを使用します。
+ `--db-parameter-group-name`
+ `--parameters`

以下の例では、*mydbparametergroup *という名前の DB パラメータグループの ` max_connections` と `max_allowed_packet` の値を変更しています。

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.Modifying.API"></a>

DB パラメータグループを変更するには、以下の必須パラメータを指定しながら RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) オペレーションを使用します。
+ `DBParameterGroupName`
+ `Parameters`

# Amazon Aurora の DB パラメータグループのパラメータをデフォルト値にリセットします
<a name="USER_WorkingWithParamGroups.Resetting"></a>

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

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

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

![\[再起動保留中のパラメータ変更のシナリオ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/db-cluster-instance-param-group.png)


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

## コンソール
<a name="USER_WorkingWithParamGroups.Resetting.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Resetting.CLI"></a>

DB パラメータグループの一部またはすべてのパラメータをリセットするには、AWS CLI[https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html)コマンドに必須オプション`--db-parameter-group-name`を指定します。

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

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

**Example**  
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`をデフォルト値にリセットします。

**Example**  
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
```

## RDS API
<a name="USER_WorkingWithParamGroups.Resetting.API"></a>

DB パラメータグループ内のパラメータをデフォルト値にリセットするには、RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) コマンドに必須パラメータ `DBParameterGroupName` を指定します。

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

# Amazon Aurora での DB パラメータグループのコピー
<a name="USER_WorkingWithParamGroups.Copying"></a>

作成したカスタム DB パラメータグループをコピーできます。パラメータグループのコピーは便利なソリューションです。例としては、作成済みの DB パラメータグループがあり、そのほとんどのカスタムパラメータと値を、新しい DB パラメータグループに含める場合です。AWS マネジメントコンソール を使用して、DB パラメータグループをコピーできます。AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) コマンド、または RDS API [CopyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) オペレーションも使用できます。

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

**注記**  
デフォルトのパラメータグループをコピーすることはできません。ただし、デフォルトのパラメータグループに基づく新しいパラメータグループを作成できます。  
DB パラメータグループを別の AWS アカウント または AWS リージョン にコピーすることはできません。

## コンソール
<a name="USER_WorkingWithParamGroups.Copying.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

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

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

1. [**Copy (コピー)**] を選択します。

## AWS CLI
<a name="USER_WorkingWithParamGroups.Copying.CLI"></a>

DB パラメータグループをコピーするには、次の必須オプションを指定しながら AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) コマンドを使用します。
+ `--source-db-parameter-group-identifier`
+ `--target-db-parameter-group-identifier`
+ `--target-db-parameter-group-description`

次の例は、DB パラメータグループ `mygroup2` のコピーである `mygroup1` という名前の新しい DB パラメータグループを作成します。

**Example**  
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"
```

## RDS API
<a name="USER_WorkingWithParamGroups.Copying.API"></a>

DB パラメータグループをコピーするには、以下の必須パラメータを指定して、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) オペレーションを使用します。
+ `SourceDBParameterGroupIdentifier`
+ `TargetDBParameterGroupIdentifier`
+ `TargetDBParameterGroupDescription`

# Amazon Aurora での DB パラメータグループの一覧表示
<a name="USER_WorkingWithParamGroups.Listing"></a>

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

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

## コンソール
<a name="USER_WorkingWithParamGroups.Listing.CON"></a>

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Listing.CLI"></a>

AWS アカウントのすべての DB パラメータグループを一覧表示するには、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html) コマンドを使用します。

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

```
aws rds describe-db-parameter-groups
```
このコマンドでは次のようなレスポンスが返されます。  

```
DBPARAMETERGROUP  default.mysql8.0     mysql8.0  Default parameter group for MySQL8.0
DBPARAMETERGROUP  mydbparametergroup   mysql8.0  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  mysql8.0  My new parameter group
```

## RDS API
<a name="USER_WorkingWithParamGroups.Listing.API"></a>

AWS アカウントのすべての DB パラメータグループを一覧表示するには、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html) オペレーションを使用します。

# Amazon Aurora のDB パラメータグループのパラメータ値の表示
<a name="USER_WorkingWithParamGroups.Viewing"></a>

DB パラメータグループのすべてのパラメータとそれらの値のリストを取得できます。

## コンソール
<a name="USER_WorkingWithParamGroups.Viewing.CON"></a>

**DB パラメータグループのパラメータ値を表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Viewing.CLI"></a>

DB パラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) コマンドを使用します。
+ `--db-parameter-group-name`

**Example**  
以下の例では、*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
```

## RDS API
<a name="USER_WorkingWithParamGroups.Viewing.API"></a>

DB パラメータグループのパラメータ値を表示するには、以下の必須パラメータを指定して、RDS API の [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) コマンドを使用します。
+ `DBParameterGroupName`

# Amazon Aurora での DB パラメータグループの削除
<a name="USER_WorkingWithParamGroups.Deleting"></a>

DB パラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使用して削除できます。パラメータグループは、DB インスタンスに関連付けられていない場合にのみ削除できます。

## コンソール
<a name="USER_WorkingWithParamGroups.Deleting.CON"></a>

**DB パラメータグループを削除するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

1. 削除するパラメータグループの名前を選択します。

1. **[アクション]** を選択し、**[削除]** を選択します。

1. パラメータグループ名を確認して、**[削除]** を選択します。

## AWS CLI
<a name="USER_WorkingWithParamGroups.Deleting.CLI"></a>

DB パラメータグループを削除するには、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html) コマンドを使用して、次の必須パラメータを指定します。
+ `--db-parameter-group-name`

**Example**  
次の例では、**mydbparametergroup という名前の DB パラメータグループを削除します。  

```
aws rds delete-db-parameter-group --db-parameter-group-name mydbparametergroup
```

## RDS API
<a name="USER_WorkingWithParamGroups.Deleting.API"></a>

DB パラメータグループを削除するには、RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html) コマンドを使用して、次の必須パラメータを指定します。
+ `DBParameterGroupName`

# DB パラメータグループを比較する
<a name="USER_WorkingWithParamGroups.Comparing"></a>

AWS マネジメントコンソール を使用して、2 つの DB パラメータグループ間の差異を表示できます。

指定されたパラメータグループは、両方とも DB パラメータグループであるか、両方とも DB クラスターパラメータグループである必要があります。DB エンジンとバージョンが同じであっても当てはまります。例えば、`aurora-mysql8.0` (Aurora MySQL バージョン 3) DB パラメータグループと `aurora-mysql8.0` DB クラスターパラメータグループを比較することはできません。

Aurora MySQL と RDS for MySQL DB のパラメータグループは、バージョンが異なっていても比較できますが、Aurora PostgreSQL と RDS for PostgreSQL DB のパラメータグループは比較できません。

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

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。

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

1. リストで、比較する 2 つのパラメータグループを選択します。
**注記**  
デフォルトのパラメータグループとカスタムパラメータグループを比較するには、まず、**[デフォルト]** タブでデフォルトパラメータグループを選択し、次に **[カスタム]** タブでカスタムパラメータグループを選択します。

1. **[アクション]** で、**[比較]** を選択します。

# DB パラメータの指定
<a name="USER_ParamValuesRef"></a>

DB パラメータの種類には、次のものがあります。
+ 整数
+ ブール値
+ 文字列
+ Long
+ ダブル
+ タイムスタンプ
+ 他の定義されたデータ型オブジェクト
+ 整数、ブール値、文字列、長整数、倍精度、タイムスタンプ、オブジェクト型の値の配列

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

**Contents**
+ [

## DB パラメータ式
](#USER_ParamFormulas)
  + [

### DB パラメータ式の変数
](#USER_FormulaVariables)
  + [

### DB パラメータ式の演算子
](#USER_FormulaOperators)
+ [

## DB パラメータ関数
](#USER_ParamFunctions)
+ [

## DB パラメータログ式
](#USER_ParamLogExpressions)
+ [

## DB パラメータ値の例
](#USER_ParamValueExamples)

## DB パラメータ式
<a name="USER_ParamFormulas"></a>

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

**構文**  

```
{FormulaVariable}
{FormulaVariable*Integer}
{FormulaVariable*Integer/Integer}
{FormulaVariable/Integer}
```

### DB パラメータ式の変数
<a name="USER_FormulaVariables"></a>

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

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

*DBInstanceClassMemory*  
データベースプロセスに対し、使用可能なメモリのバイト数を整数で返します。この数値は、DB インスタンスクラスの合計メモリ量から始めて内部的に計算されます。この数から、インスタンスを管理する RDS プロセスとオペレーティングシステム用に予約されているメモリ量を減算します。したがって、この数値は、「[Amazon Aurora DB インスタンスクラス](Concepts.DBInstanceClass.md)」のインスタンスクラステーブルに示されているメモリ値よりも、常にやや低くなります。正確な値は、複数の要因の組み合わせによって異なります。これらには、インスタンスクラスと DB エンジンが含まれ、この値が適用されるのが RDS インスタンスなのか、Aurora クラスターに含まれているインスタンスなのかによっても異なります。

*DBInstanceVCPU*  
Amazon RDS がインスタンスの管理に使用する仮想中央演算装置 (vCPU) の数を表す整数を返します。

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

*TrueIfReplica*  
DB インスタンスがリードレプリカである場合は `1`、リードレプリカでない場合は `0` が返されます。これは Aurora MySQL の`read_only` パラメータのデフォルト値です。

### DB パラメータ式の演算子
<a name="USER_FormulaOperators"></a>

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

*除算演算子: /*  
被除数を除数で割り、整数の商を返します。商の小数部分は四捨五入されず切り捨てられます。  
構文  

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

*乗算演算子: \$1*  
式を乗算し、式の積を返します。式の小数部分は四捨五入されず切り捨てられます。  
構文  

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

## DB パラメータ関数
<a name="USER_ParamFunctions"></a>

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 パラメータログ式
<a name="USER_ParamLogExpressions"></a>

整数 DB パラメータ値をログ式に設定できます。式は中かっこ \$1\$1 で囲みます。次に例を示します。

```
{log(DBInstanceClassMemory/8187281418)*1000}
```

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

## DB パラメータ値の例
<a name="USER_ParamValueExamples"></a>

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

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

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

```
LEAST({DBInstanceClassMemory/393040}, 20000)
```