# Inicio de la conmutación de Oracle Data Guard
<a name="oracle-switchover.initiating"></a>

Puede cambiar una réplica de lectura de RDS para Oracle al rol principal y la anterior instancia de base de datos principal a un rol de réplica.

Antes de iniciar una transición, compruebe lo siguiente:
+ La métrica `ReplicaLag` de CloudWatch es cero o casi cero.
+ No hay transacciones de larga duración activas en la base de datos principal.
+ Las cadenas de conexión de la aplicación están configuradas para gestionar el cambio de punto de conexión, o tiene previsto actualizarlas después de la transición.
+ Ha comprobado que la réplica esté en buen estado (el estado es `available`).

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

**Para cambiar una réplica de lectura de Oracle al rol de la base de datos principal**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En la consola de Amazon RDS, seleccione **Databases (Bases de datos)**.

   Aparece el panel **Databases (Bases de datos)**. Cada réplica de lectura muestra **Replica (Réplica)** en la columna **Role (Rol)**.

1. Elija la réplica de lectura que desea cambiar al rol principal.

1. En **Actions** (Acciones), elija **Switch over replica** (Réplica de conmutación).

1. Elija **I acknowledge** (Confirmo). A continuación, elija **Switch over replica** (Réplica de conmutación).

1. En la página **Databases** (Bases de datos), supervise el progreso de la conmutación.  
![Supervise el progreso de la conmutación de Oracle Data Guard.](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   Cuando se complete la conmutación, el rol del objetivo de la conmutación cambiará de **Replica** (Réplica) a **Primary** (Principal).  
![Las bases de datos de origen y de réplica cambian de rol.](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

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

Para cambiar una réplica de Oracle al rol de la base de datos principal, utilice el 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) de la AWS CLI. Los siguientes ejemplos hacen que la réplica de Oracle se llame {{replica-to-be-made-primary}} en la nueva base de datos principal.

**Example**  
Para Linux, macOS o 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 de RDS
<a name="USER_ReadRepl.Promote.API"></a>

Para cambiar una réplica de Oracle al rol de base de datos principal, llame a la operación [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) de la API de Amazon RDS con el parámetro requerido `DBInstanceIdentifier`. Este parámetro especifica el nombre de la réplica de Oracle que desea que asuma el rol de base de datos principal.