# RDS for Db2 レプリカモードの変更
<a name="db2-replicas-changing-replica-mode"></a>

既存の Db2 レプリカのレプリカモードは、読み取り専用モードとスタンバイモードの間で変更できます。この柔軟性により、読み取りワークロードやディザスタリカバリのニーズの変化する要件に基づいてレプリカ設定を適応させることができます。

以下のシナリオでは、レプリカモードを変更することができます。
+ **読み取り専用からスタンバイ** – 読み取り容量が不要になったが、ディザスタリカバリ機能を維持したい場合
+ **読み取り専用へのスタンバイ** – レポートまたは分析ワークロードの読み取り容量を追加する必要がある場合

レプリカモードを変更する前に、次の条件が満たされていることを確認してください。
+ レプリカは使用可能な状態です。
+ レプリカでアクティブなメンテナンスオペレーションが実行されていません。
+ DB インスタンスを変更するために必要なアクセス許可があります。

変更には数分かかる場合があります。オペレーション中、DB インスタンスのステータスは **modifying** に変わります。ステータス変更の詳細については、「[ Amazon RDS DB インスタンスのステータスの表示](accessing-monitoring.md#Overview.DBInstance.Status)」を参照してください。読み取り専用モードからスタンバイモードに変更すると、レプリカはすべてのアクティブな接続を切断します。

**重要**  
レプリカモードを変更するとサービスが一時的に中断されるため、メンテナンスウィンドウ中に変更を計画して、アプリケーションへの影響を最小限に抑えます。

レプリカモードは、AWS マネジメントコンソール、AWS CLI、または RDS API を使用して変更できます。

## コンソール
<a name="db2-replicas-changing-replica-mode-console"></a>

**Db2 レプリカのレプリカモードを変更するには**

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

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

1. 変更するレプリカデータベースを選択します。

1. **[Modify]** (変更) を選択します。

1. **[レプリカモード]** では、目的のモードを選択します。
   + **読み取り専用** – 読み取りワークロード用
   + **スタンバイ** — ディザスタリカバリ用

1. 変更する他の設定を選択します。

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

1. [**変更のスケジューリング**] で、[**すぐに適用**] を選択します。

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

1. 変更が完了したら、**[データベース]** ページでレプリカモードの変更を確認します。変更が完了すると、レプリカのステータスが **[利用可能]** と表示されます。

## AWS CLI
<a name="db2-replicas-changing-replica-mode-cli"></a>

Db2 レプリカを読み取り専用モードからスタンバイモードに変更するには、AWS CLI コマンド [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) で `--replica-mode` を `mounted` に設定します。Db2 レプリカをスタンバイモードから読み取り専用モードに変更するには、`--replica-mode` を `open-read-only` に設定します。

次の例では、レプリカを読み取り専用モードからスタンバイモードに変更します。

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

```
aws rds modify-db-instance \
    --db-instance-identifier {{my_db2_replica}} \
    --replica-mode mounted
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my_db2_replica}} ^
    --replica-mode mounted
```

次の例では、レプリカをスタンバイモードから読み取り専用モードに変更します。

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

```
aws rds modify-db-instance \
    --db-instance-identifier {{my_db2_replica}} \
    --replica-mode open-read-only
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my_db2_replica}} ^
    --replica-mode open-read-only
```

## RDS API
<a name="db2-replicas-changing-replica-mode-api"></a>

Db2 レプリカを読み取り専用モードからスタンバイモードに変更するには、[ModifyDBInstance](AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) で `ReplicaMode=mounted` に設定します。Db2 レプリカをスタンバイモードから読み取り専用モードに変更するには、`ReplicaMode=open-read-only` に設定します。

以下は、レプリカモードを読み取り専用からスタンバイに変更するための API コールの例です。

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "mounted",
    "ApplyImmediately": true
}
```

以下は、レプリカモードをスタンバイモードから読み取り専用モードに変更するための API コールの例です。

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "open-read-only",
    "ApplyImmediately": true
}
```

レプリカモードの違いについては、「[Amazon RDS for Db2 のレプリカの使用](db2-replication.md)」を参照してください。レプリカの問題のトラブルシューティングについては、「[RDS for Db2 レプリケーションの問題のトラブルシューティング](db2-troubleshooting-replicas.md)」を参照してください。