Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Lancement de la bascule d’Oracle Data Guard
<a name="oracle-switchover.initiating"></a>

Vous pouvez faire basculer un réplica en lecture RDS for Oracle vers le rôle principal, et l'ancienne instance de base de données principale vers un rôle de réplica.

Avant de lancer une commutation, vérifiez les points suivants :
+ La `ReplicaLag` CloudWatch métrique est nulle ou proche de zéro.
+ Aucune transaction de longue durée n'est active sur la base de données principale.
+ Les chaînes de connexion de votre application sont configurées pour gérer la modification du point de terminaison, ou vous avez prévu de les mettre à jour après le passage au numérique.
+ Vous avez vérifié que le réplica est en bon état (le statut est`available`).

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

**Pour basculer un réplica en lecture Oracle vers le rôle de base de données principale**

1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

1. Dans la console Amazon RDS, choisissez **Bases de données**.

   Le volet **Bases de données** s'affiche. Chaque réplica en lecture affiche **Réplica** dans la colonne **Rôle**.

1. Sélectionnez la réplica en lecture que vous souhaitez faire basculer vers le rôle principal.

1. Pour **Actions**, sélectionnez **Switch over replica** (Basculer le réplica).

1. Sélectionnez **I acknowledge** (Je confirme). Sélectionnez ensuite **Switch over replica** (Basculer le réplica).

1. Sur la page **Bases de données**, surveillez la progression de la bascule.  
![Surveillez la progression de la bascule d’Oracle Data Guard.](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   Lorsque la bascule est terminée, le rôle de la cible de la bascule passe de **Réplica** à **Source**.  
![Les bases de données source et de réplica échangent leurs rôles.](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

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

Pour passer d'une réplique Oracle au rôle de base de données principal, utilisez la 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)commande. Les exemples suivants intègrent le réplica Oracle nommé {{replica-to-be-made-primary}} dans la nouvelle base de données principale.

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

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

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

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

Pour faire passer un réplica Oracle au rôle de base de données principale, appelez l'opération d'API Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) avec le paramètre `DBInstanceIdentifier` requis. Ce paramètre spécifie le nom du réplica Oracle qui doit assumer le rôle de base de données principale.