本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 啟動 Oracle Data Guard 容錯移轉
<a name="oracle-switchover.initiating"></a>

您可以將 RDS for Oracle 僅供讀取複本容錯移轉為主要角色，將原主要資料庫執行個體容錯移轉為複本角色。

啟動切換之前，請確認下列事項：
+ `ReplicaLag` CloudWatch 指標為零或接近零。
+ 主要資料庫上沒有作用中的長時間執行交易。
+ 您的應用程式連線字串已設定為處理端點變更，或者您有計畫在切換後更新它們。
+ 您已驗證複本處於運作狀態 （狀態為 `available`)。

## 主控台
<a name="USER_ReadRepl.Promote.Console"></a>

**若要將 Oracle 僅供讀取複本容錯移轉為主要資料庫角色**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon 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/zh_tw/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   容錯移轉完成時，容錯移轉目標的角色會從 **Replica** (複本) 變成 **Source** (來源)。  
![來源資料庫和複本資料庫會變更角色。](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

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

若要將 Oracle 複本切換至主要資料庫角色，請使用 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 複本容錯移轉為主要資料庫角色，請使用必要參數 `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) 操作。此參數指定您要擔任主要資料庫角色之 Oracle 複本的名稱。