# 启动 Oracle Data Guard 切换
<a name="oracle-switchover.initiating"></a>

您可以将 RDS for Oracle 只读副本切换为主角色，并将以前的主数据库实例切换为副本角色。

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

**将 Oracle 只读副本切换为主数据库角色**

1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。

1. 在 Amazon RDS 控制台中，选择**数据库**。

   随后会显示**数据库**窗格。每个只读副本在**角色**列中显示**副本**。

1. 选择要切换为主角色的只读副本。

1. 对于 **Actions**（操作），选择 **Switch over replica**（切换副本）。

1. 选择 **I acknowledge**（我确认）。然后选择 **Switch over replica**（切换副本）。

1. 在 **Databases**（数据库）页面，监控切换的进度。  
![\[监控 Oracle Data Guard 切换的进度。\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   切换完成后，切换目标的角色将从 **Replica**（副本）更改为 **Source**（源）。  
![\[源数据库和副本数据库会更改角色。\]](http://docs.aws.amazon.com/zh_cn/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 副本的名称。