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 du basculement vers SQL Server
<a name="sqlserver-switchover.initiating"></a>

Vous pouvez passer d'un réplica de lecture RDS pour SQL Server au rôle principal, et l'ancienne instance de base de données principale à un rôle de réplique.

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

Vous pouvez lancer le basculement à l'aide de la console Amazon RDS, AWS CLI, ou l'API Amazon RDS.

## Console
<a name="sqlserver-switchover.initiating.console"></a>

**Pour passer d'une réplique de lecture de SQL Server au rôle de base de données principal**

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

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.

   Lorsque la bascule est terminée, le rôle de la cible de la bascule passe de **Réplica** à **Source**.

## AWS CLI
<a name="sqlserver-switchover.initiating.cli"></a>

Pour passer d'une réplique SQL Server au rôle de base de données principal, utilisez le AWS CLI [switchover-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html) commande. Les exemples suivants donnent au réplica SQL Server le nom {{replica-to-be-made-primary}} dans la nouvelle instance de 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="sqlserver-switchover.initiating.api"></a>

Pour passer d'une réplique SQL Server au rôle de base de données principal, appelez le [SwitchoverReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) fonctionnement de l'API Amazon RDS avec le paramètre requis `DBInstanceIdentifier`. Ce paramètre spécifie le nom du réplica SQL Server auquel vous souhaitez attribuer le rôle de base de données principal.