# Oracle Data Guard のスイッチオーバーの開始
<a name="oracle-switchover.initiating"></a>

RDS for Oracle リードレプリカをプライマリロールに切り替え、以前のプライマリ DB インスタンスをレプリカロールに切り替えることができます。

## コンソール
<a name="USER_ReadRepl.Promote.Console"></a>

**Oracle リードレプリカをプライマリ DB ロールに切り替えるには**

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

1. Amazon RDS コンソールで、[**Databases (データベース)**] を選択します。

   [**Databases (データベース)**] ペインが表示されます。各リードレプリカには､[**Role (ロール)**] 列に [**Replica (レプリカ)**] があります｡

1. プライマリロールに切り替えるリードレプリカを選択します。

1. **[Actions]** (アクション) で、**[Switch over replica]** (レプリカを切り替える) を選択します。

1. **[I acknowledge]** (承認します) を選択します。次に、**[Switch over replica]** (レプリカを切り替える) を選択します。

1. **[Databases]** (データベース) ページで、スイッチオーバーの進行状況をモニタリングします。  
![Oracle Data Guard のスイッチオーバーの進行状況をモニタリングする](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   スイッチオーバーが完了すると、ターゲットのロールが**レプリカ**から**ソース**に変わります。  
![ソースデータベースとレプリカデータベースのロールが変更されます。](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

## AWS CLI
<a name="USER_ReadRepl.Promote.CLI"></a>

Oracle レプリカをプライマリ DB ロールに切り替えるには、AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html](https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html) コマンドを使用します。次の例では、{{replica-to-be-made-primary}} という名前の Oracle レプリカを新しいプライマリデータベースに切り替えます。

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

```
aws rds switchover-read-replica \
    --db-instance-identifier {{replica-to-be-made-primary}}
```
Windows の場合:  

```
aws rds switchover-read-replica ^
    --db-instance-identifier {{replica-to-be-made-primary}}
```

## RDS API
<a name="USER_ReadRepl.Promote.API"></a>

Oracle レプリカをプライマリ DB ロールに切り替えるには、必須パラメータ `DBInstanceIdentifier` を使用して、Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) 操作を呼び出します。このパラメータは、プライマリ DB ロールを継承する Oracle レプリカの名前を指定します。