# Iniciar a alternância do Oracle Data Guard
<a name="oracle-switchover.initiating"></a>

Você pode alternar uma réplica de leitura do RDS para Oracle para a função primária e a antiga instância de banco de dados primária para uma função de réplica.

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

**Como alternar uma réplica de leitura da Oracle para a função de banco de dados primária**

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 de leitura exibem **Replica** (Réplica) na coluna **Role** (Função).

1. Escolha a réplica de leitura que você deseja alternar para a função primária.

1. Para **Actions** (Ações), escolha **Switch over replica** (Alternar réplica).

1. Escolha **I acknowledge** (Eu aceito). Depois, escolha **Switch over replica** (Alternar réplica).

1. Na página **Databases** (Bancos de dados), monitore o progresso da transição.  
![Monitore o andamento da transição do Oracle Data Guard.](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   Quando a transição é concluída, a função do destino da alternância muda de **Replica** (Réplica) para **Primary** (Principal).  
![Os bancos de dados de origem e réplica alteram as funções.](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

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

Para mudar uma réplica do Oracle para a função de banco de dados primária, use o comando [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) do AWS CLI. Os exemplos a seguir tornam a réplica do Oracle chamada {{replica-to-be-made-primary}} no novo banco de dados primário.

**Example**  
Para Linux, macOS ou Unix:  

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

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

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

Para alternar uma réplica do Oracle para a função de banco de dados primária, chame a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) do Amazon RDS com o parâmetro necessário `DBInstanceIdentifier`. Esse parâmetro especifica o nome da réplica do Oracle que você deseja assumir como função de banco de dados primária.