# Amazon RDS で Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurningOnAdvanced"></a>

Amazon RDS で Database Insights のアドバンストモードを有効にするには、次の手順を使用します。

## DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurnOnCreateDatabase"></a>

Amazon RDS のデータベースを作成するときに、Database Insights のアドバンストモードを有効にします。

------
#### [ Console ]

コンソールで、DB インスタンスまたマルチ AZ DB クラスターを作成するときに Database Insights のアドバンストモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを作成するときに Database Insights のアドバンストモードを有効にするには**

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

1. [**データベース**] をクリックします。

1. **[データベースの作成]** を選択します。

1. **[Database Insights]** セクションで **[アドバンストモード]** を選択し、次のいずれかのオプションを選択します。
   + **保持期間** - Performance Insights データを保持する期間。Database Insights のアドバンストモードでは、保持期間は 15 か月とする必要があります。
   + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**データベースの作成**] を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にするには、[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) または [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode advanced` – Database Insights のアドバンストモードを有効にします。
+ `--engine` – DB インスタンス のデータベースエンジン。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` – Database Insights の Performance Insights を有効にします。
+ `--performance-insights-retention-period` – DB インスタンスまたはマルチ AZ DB クラスターのデータの保持期間。Database Insights を有効にするには、保持期間を 465 日以上にする必要があります。

次の例では、DB インスタンスの作成時に Database Insights のアドバンストモードを有効にします。

Linux、macOS、Unix の場合:

```
aws rds create-db-instance \
    --database-insights-mode advanced \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Windows の場合:

```
aws rds create-db-instance ^
    --database-insights-mode advanced ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にするには、[CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) または [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`advanced`
+ `EnablePerformanceInsights`～`True`
+ `PerformanceInsightsRetentionPeriod` – 465 日以上

------

## DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurnOnModifyDatabase"></a>

Amazon RDS のデータベースを変更するときに Database Insights を有効にします。DB インスタンスを変更して Database Insights のアドバンストモードを有効にしても、ダウンタイムは発生しません。

**注記**  
Database Insights を有効にするには、マルチ AZ DB クラスター内の各 DB インスタンスに、同じ Performance Insights と拡張モニタリング設定が必要です。

------
#### [ Console ]

コンソールで、DB インスタンスまたマルチ AZ DB クラスターを変更するときに Database Insights のアドバンストモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを変更するときに Database Insights のアドバンストモードを有効にするには**

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

1. [**データベース**] をクリックします。

1. DB インスタンスまたはマルチ AZ DB クラスターを選択した上で、**[Modify]** (変更) を選択します。

1. **[Database Insights]** セクションで **[アドバンストモード]** を選択し、次のいずれかのオプションを選択します。
   + **保持期間** - Performance Insights データを保持する期間。Database Insights のアドバンストモードでは、保持期間は 15 か月とする必要があります。
   + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**続行**] を選択します。

1. [**Scheduling of Modifications**] で、[**Apply immediately**] を選択します。**[スケジュールされた次回のメンテナンス時間帯に適用]** を選択すると、データベースではこの設定が無視され、Database Insights のアドバンストモードが直ちに有効になります。

1. **[インスタンスの変更]** を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にするには、[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) または [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode advanced` – Database Insights のアドバンストモードを有効にします。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` – Database Insights の Performance Insights を有効にします。
+ `--performance-insights-retention-period` – DB インスタンスのデータの保持期間。Database Insights のアドバンストモードを有効にするには、保持期間を 465 日以上にする必要があります。

次の例では、DB インスタンスの変更時に Database Insights のアドバンストモードを有効にします。

Linux、macOS、Unix の場合:

```
aws rds modify-db-instance \
    --database-insights-mode advanced \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Windows の場合:

```
aws rds modify-db-instance ^
    --database-insights-mode advanced ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にするには、[ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) または [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`advanced`
+ `EnablePerformanceInsights`～`True`
+ `PerformanceInsightsRetentionPeriod` ～ 465 日以上

------