# Promover uma réplica do RDS Custom para Oracle a uma instância de banco de dados autônoma
Assim como com o RDS para Oracle, você pode promover uma réplica do RDS Custom para Oracle a uma instância de banco de dados autônoma. Ao promover uma réplica do Oracle, a instância de banco de dados é reiniciada antes que ela seja disponibilizada. Para ter mais informações sobre como promover réplicas do Oracle, consulte [Promoção de uma réplica de leitura a uma instância de banco de dados autônoma](USER_ReadRepl.Promote.md).
Ao promover uma réplica, observe as seguintes diretrizes:
+ Não inicie um failover enquanto o RDS Custom para Oracle estiver promovendo sua réplica. Caso contrário, o fluxo de trabalho da promoção poderá travar.
+ Não alterne sua instância de banco de dados primária enquanto o RDS Custom para Oracle estiver promovendo sua réplica do Oracle. Caso contrário, o fluxo de trabalho da promoção poderá travar.
+ Não interrompa sua instância de banco de dados primária enquanto o RDS Custom para Oracle estiver promovendo sua réplica do Oracle. Caso contrário, o fluxo de trabalho da promoção poderá travar.
+ Não tente reiniciar a replicação com sua instância de banco de dados recém-promovida como destino. Depois que o RDS Custom para Oracle promover sua réplica do Oracle, ela se tornará uma instância de banco de dados autônoma e não terá mais a função de réplica.
Observe as seguintes limitações da promoção de réplicas do RDS Custom para Oracle:
+ Você não pode promover uma réplica enquanto o RDS Custom para Oracle estiver fazendo backup dela.
+ Ao promover sua réplica do Oracle, você não pode alterar o período de retenção de backup para `0`.
+ Você não pode promover sua réplica quando ela não está em um estado íntegro.
Se você chamar `delete-db-instance` na instância de banco de dados primária, o RDS Custom para Oracle valida que cada réplica gerenciada do Oracle está íntegra e disponível para promoção. Uma réplica pode não estar qualificada para promoção porque a automação está pausada ou está fora do perímetro de suporte. Nesses casos, o RDS Custom para Oracle publica um evento explicando o problema para que você possa reparar sua réplica do Oracle manualmente.
As etapas a seguir mostram o processo geral para promover uma réplica do Oracle a uma instância de banco de dados:
1. Pare a gravação de transações na instância de banco de dados primária.
1. Aguarde até que o RDS Custom para Oracle aplique todas as atualizações à sua réplica do Oracle.
1. Promova a réplica do Oracle escolhendo a opção **Promote** (Promover) no console do Amazon RDS, o comando [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) da AWS CLI ou a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html) do Amazon RDS.
A promoção de uma réplica do Oracle leva alguns minutos para ser concluída. Durante o processo, o RDS Custom para Oracle interrompe a replicação e reinicializa sua réplica. Quando a reinicialização for concluída, a réplica do Oracle estará disponível como uma nova instância de banco de dados. Consulte mais informações sobre como solucionar problemas de promoção de réplicas em [Solucionar problemas de promoção de réplicas no RDS Custom para Oracle](custom-troubleshooting.md#custom-troubleshooting-promote).
## Console
**Para promover uma réplica do RDS Custom para Oracle a uma instância de banco de dados autônoma**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No console do Amazon RDS, escolha **Databases** (Bancos de dados).
O painel **Databases** (Bancos de dados) é exibido. Todas as réplicas do Oracle exibem **Replica** (Réplica) na coluna **Role** (Função).
1. Escolha a réplica do RDS Custom para Oracle que você deseja promover.
1. Em **Actions** (Ações), selecione **Promote** (Promover).
1. Na página **Promote Oracle replica** (Promover réplica do Oracle), insira o período de retenção de backup e a janela de backup para a instância de banco de dados recém-promovida. Você não pode definir esse valor como **0**.
1. Quando estiver satisfeito com as configurações, escolha **Promote Oracle replica** (Promover réplica do Oracle).
## AWS CLI
Para promover sua réplica do RDS Custom para Oracle a uma instância de banco de dados autônoma, use o comando [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) da AWS CLI.
**Example**
Para Linux, macOS ou Unix:
```
aws rds promote-read-replica \
--db-instance-identifier my-custom-read-replica \
--backup-retention-period 2 \
--preferred-backup-window 23:00-24:00
```
Para Windows:
```
aws rds promote-read-replica ^
--db-instance-identifier my-custom-read-replica ^
--backup-retention-period 2 ^
--preferred-backup-window 23:00-24:00
```
## API do RDS
Para promover sua réplica do RDS Custom para Oracle a uma instância de banco de dados autônoma, chame a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplica.html) do Amazon RDS com o parâmetro obrigatório `DBInstanceIdentifier`.