Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Avvio dello switchover di SQL Server
<a name="sqlserver-switchover.initiating"></a>

È possibile passare da una replica di lettura RDS per SQL Server al ruolo principale e la precedente istanza DB primaria a un ruolo di replica.

Prima di avviare uno switchover, verifica quanto segue:
+ Il `ReplicaLag` CloudWatch la metrica è zero o prossima allo zero.
+ Nessuna transazione di lunga durata è attiva nel database principale.
+ Le stringhe di connessione dell'applicazione sono configurate per gestire la modifica degli endpoint oppure si prevede di aggiornarle dopo il passaggio.
+ È stato verificato che la replica sia integra (lo stato è `available`).

Puoi avviare il passaggio al formato digitale utilizzando la console Amazon RDS, AWS CLI o l'API Amazon RDS.

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

**Per passare da una replica di SQL Server, leggi la replica al ruolo DB primario**

1. Accedere a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nella console Amazon RDS scegliere **Databases (Database)**.

   Verrà visualizzato il riquadro **Databases (Database)**. Ogni replica di lettura mostra la **Replica** nella colonna **Role (Ruolo)**.

1. Scegli la replica di lettura per cui eseguire lo switchover al ruolo primario.

1. In **Actions** (Operazioni), scegli **Switch over replica** (Esegui switchover replica).

1. Scegli **I acknowledge** (Accetto). Scegli quindi **Switch over replica** (Esegui switchover replica).

1. Nella pagina **Databases** (Database), monitora lo stato di avanzamento dello switchover.

   Una volta completato lo switchover, il ruolo di destinazione dello switchover cambia da **Replica** a **Source** (Origine).

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

Per passare da una replica di SQL Server al ruolo DB primario, utilizzare AWS CLI [switchover-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html) comando. Negli esempi seguenti viene denominata la replica di SQL Server {{replica-to-be-made-primary}} nella nuova istanza DB primaria.

**Example**  
Per Linux, macOS o Unix:  

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

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

## API RDS
<a name="sqlserver-switchover.initiating.api"></a>

Per passare da una replica di SQL Server al ruolo DB primario, chiama [SwitchoverReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) funzionamento dell'API Amazon RDS con il parametro richiesto `DBInstanceIdentifier`. Questo parametro specifica il nome della replica di SQL Server che si desidera assumere come ruolo DB primario.