

# 将 RDS Custom for Oracle 副本提升为独立的数据库实例
<a name="custom-rr.promoting"></a>

就像使用 RDS for Oracle 一样，您可以将 RDS Custom for Oracle 副本提升为独立的数据库实例。提升 Oracle 副本时，RDS Custom for Oracle 会在数据库实例变为可用之前重新启动数据库实例。有关提升 Oracle 副本的更多信息，请参阅[将只读副本提升为独立的数据库实例](USER_ReadRepl.Promote.md)。

提升副本时，请注意以下指南：
+ 在 RDS Custom for Oracle 提升您的副本时不要启动失效转移。否则，提升工作流可能会卡住。
+ 在 RDS Custom for Oracle 提升 Oracle 副本时，不要切换主数据库实例。否则，提升工作流可能会卡住。
+ 在 RDS Custom for Oracle 提升 Oracle 副本时，不要关闭主数据库实例。否则，提升工作流可能会卡住。
+ 不要尝试将新提升的数据库实例作为目标来重新开始复制。在 RDS Custom for Oracle 提升 Oracle 副本后，它将成为一个独立的数据库实例，不再具有副本角色。

注意 RDS Custom for Oracle 副本提升存在以下限制：
+ 当 RDS Custom for Oracle 正在备份副本时，您无法提升副本。
+ 提升 Oracle 副本时，不能将备份保留期更改为 `0`。
+ 当副本未处于正常运行状态时，您无法提升它。

  如果您在主数据库实例上发出 `delete-db-instance`，RDS Custom for Oracle 会验证每个托管式 Oracle 副本是否正常运行以及是否可供提升。副本可能不符合提升资格，因为自动化已暂停或它不在支持外围内。在这种情况下，RDS Custom for Oracle 会发布一个事件来解释此问题，以便您可以手动修复 Oracle 副本。

以下步骤说明将 Oracle 副本提升为数据库实例的一般过程：

1. 停止将任何事务写入到主数据库实例。

1. 等待 RDS Custom for Oracle 将所有更新应用到 Oracle 副本。

1. 通过在 Amazon RDS 控制台上选择 **Promote**（提升）选项、AWS CLI 命令 [https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica.html](https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica.html) 或 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html) Amazon RDS API 操作来提升 Oracle 副本。

提升一个 Oracle 副本需要几分钟才能完成。在此过程中，RDS Custom for Oracle 会停止复制并重启您的副本。完成重启后，Oracle 副本即可用作独立的数据库实例。有关排查副本提升问题的信息，请参阅[排查 RDS Custom for Oracle 的副本提升问题](custom-troubleshooting.md#custom-troubleshooting-promote)。

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

**将 RDS Custom for Oracle 副本提升为独立的数据库实例**

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

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

   随后会显示**数据库**窗格。每个 Oracle 副本在 **Role**（角色）列中显示 **Replica**（副本）。

1. 选择您要提升的 RDS Custom for Oracle 副本。

1. 对于**操作**，请选择**提升**。

1. 在 **Promote Oracle replica**（提升 Oracle 副本）页面上，输入新提升的数据库实例的备份保留期和备份时段。您不能将此值设置为 **0**。

1. 根据需要完成设置后，选择 **Promote Oracle replica**（提升 Oracle 副本）。

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

要将 RDS Custom for Oracle 副本提升为独立的数据库实例，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica.html](https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica.html) 命令。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds promote-read-replica \
--db-instance-identifier my-custom-read-replica \
--backup-retention-period 2 \
--preferred-backup-window 23:00-24:00
```
对于 Windows：  

```
aws rds promote-read-replica ^
--db-instance-identifier my-custom-read-replica ^
--backup-retention-period 2 ^
--preferred-backup-window 23:00-24:00
```

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

要将 RDS Custom for Oracle 副本提升为独立的数据库实例，请调用具有必要参数 `PromoteReadReplica` 的 Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html) 操作。