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à.
# Panoramica dei cluster globali di Amazon DocumentDB
## Cos'è un cluster globale?
Un cluster globale è composto da una regione principale e da un massimo di 10 aree secondarie di sola lettura. Le operazioni di scrittura vengono eseguite direttamente sul cluster primario nella regione primaria e Amazon DocumentDB replica automaticamente i dati nelle regioni secondarie utilizzando un'infrastruttura dedicata. La latenza è in genere inferiore a un secondo.
## In che modo sono utili i cluster globali?
+ **Ripristino da interruzioni a livello regionale: in caso di interruzione** a livello regionale, è possibile promuovere uno dei cluster secondari a cluster primario in pochi minuti, con un Recovery Time Objective (RTO) tipico inferiore a un minuto. Il Recovery Point Objective (RPO) viene in genere misurato in secondi, ma dipende dal ritardo della rete al momento dell'errore.
+ **Letture globali con latenza locale**: se hai uffici in tutto il mondo, puoi utilizzare un cluster globale per mantenere aggiornate le principali fonti di informazioni nella regione principale. Gli uffici delle altre aree geografiche possono accedere alle informazioni nella propria regione, con latenza locale.
+ **Cluster secondari scalabili: è possibile scalare i** cluster secondari aggiungendo altre istanze di sola lettura a un'area secondaria. Il cluster secondario è di sola lettura, quindi può supportare fino a 16 istanze di replica in sola lettura anziché il normale limite di 15 per un singolo cluster.
+ **Replica rapida dai cluster primari a quelli secondari: la replica eseguita da un cluster** globale ha un impatto minimo sulle prestazioni del cluster di database primario. Le risorse delle istanze database sono totalmente dedicate a servire carichi di lavoro di lettura e scrittura delle applicazioni.
## Quali sono gli attuali limiti dei cluster globali?
+ I cluster globali non sono supportati su Amazon DocumentDB v3.6.
+ I cluster globali sono supportati su tutti i tipi di istanze ad eccezione di db.t3, db.t4g e db.r4.
+ I cluster globali non sono disponibili nelle seguenti regioni: Sud America (San Paolo), Europa (Milano), Cina (Pechino) e Cina (Ningxia).
+ Lo switchover e il failover globale non sono supportati quando le regioni utilizzano versioni del motore diverse. Il failover manuale è supportato in caso di mancata corrispondenza tra le versioni del motore.
+ Solo il cluster primario eseguire operazioni di scrittura. I client che eseguono operazioni di scrittura si connettono all'endpoint del cluster primario.
+ È possibile disporre di un massimo di 10 regioni secondarie e una regione principale per il cluster.
+ Un cluster secondario non può essere fermato. Un cluster primario non può essere interrotto se è associato a cluster secondari. È possibile interrompere solo un cluster regionale che non ha cluster secondari.
+ Le repliche collegate al cluster secondario possono essere riavviate in determinate circostanze. Se l'istanza dell'area primaria si riavvia o esegue il failover, vengono riavviate anche le repliche nell'area secondaria. Il cluster non sarà quindi disponibile finché tutte le repliche non saranno nuovamente sincronizzate con l'istanza writer del cluster di database primario. Si tratta di un comportamento normale. Assicurati di comprendere l'impatto sul cluster globale prima di apportare modifiche al cluster primario.
+ Non è possibile utilizzare i flussi di modifica sui cluster secondari.
**Topics**
+ [
## Cos'è un cluster globale?
](#w2aac33b9b3)
+ [
## In che modo sono utili i cluster globali?
](#w2aac33b9b5)
+ [
## Quali sono gli attuali limiti dei cluster globali?
](#w2aac33b9b7)
+ [Guida rapida di avvio](global-clusters.get-started.md)
+ [Gestione di cluster globali](global-clusters.manage.md)
+ [Connessione di cluster globali](global-clusters-connect.md)
+ [Monitoraggio dei cluster globali](global-clusters-monitor.md)
+ [Ripristino di emergenza](global-clusters-disaster-recovery.md)
# Guida rapida: cluster globali
**Topics**
+ [Configurazione](#global-clusters.config)
+ [Creazione di un cluster globale](#global-clusters-create)
+ [Aggiungere una regione a un cluster globale](#global-clusters.add-region)
+ [Utilizzo di uno snapshot](#global-clusters.snapshot)
## Configurazione
Il cluster globale di Amazon DocumentDB si estende su almeno due. Regioni AWS La regione primaria supporta un cluster con un'istanza primaria (writer) e fino a 15 istanze di replica, mentre una regione secondaria gestisce un cluster di sola lettura composto interamente da un massimo di 16 istanze di replica. Un cluster globale può avere fino a cinque regioni secondarie. La tabella elenca il numero massimo di cluster, istanze e repliche consentiti in un cluster globale.
| Description | Primario Regione AWS | Secondario Regione AWS |
| --- | --- | --- |
| Cluster | 1 | 5 massimo |
| Istanze di scrittura | 1 | 0 |
| Istanze di sola lettura (repliche Amazon DocumentDB), per cluster | 15 (massimo) | 16 (totali) |
| Istanze di sola lettura (massimo consentito, dato il numero effettivo di Regioni secondarie) | 15 - s | s = numero totale di unità secondarie Regioni AWS |
I cluster hanno i seguenti requisiti specifici:
+ **Requisiti delle classi di istanze di database**: è possibile utilizzare solo le classi di `db.r6g` istanze `db.r5` e.
+ **Regione AWS requisiti**: il cluster primario deve trovarsi in una regione e almeno un cluster secondario deve trovarsi in una regione diversa dello stesso account. È possibile creare fino a cinque cluster secondari (di sola lettura) e ognuno deve trovarsi in una regione diversa. In altre parole, non possono trovarsi due cluster nella stessa regione.
+ **Requisiti di denominazione**: i nomi scelti per ciascuno dei cluster devono essere unici, in tutte le regioni. Non puoi usare lo stesso nome per cluster diversi anche se si trovano in regioni diverse.
## Creazione di un cluster globale Amazon DocumentDB
Sei pronto a creare il tuo primo cluster globale? In questa sezione spiegheremo come creare un cluster globale nuovo di zecca con nuovi cluster e istanze di database, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni.
### Usando il Console di gestione AWS
1. Nel Console di gestione AWS, accedi ad **Amazon DocumentDB**.
1. **Quando accedi alla console Amazon DocumentDB, scegli Clusters.**
![\[La pagina Clusters nella console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Scegli **Create** (Crea).
![\[Il pulsante Crea mostrato nell'angolo superiore destro della tabella Clusters.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Compila di **conseguenza la sezione Configurazione** del modulo **Crea cluster Amazon DocumentDB**:
+ **Identificatore del cluster**: puoi inserire un identificatore univoco per questa istanza o consentire ad Amazon DocumentDB di fornire l'identificatore dell'istanza basato sull'identificatore del cluster.
+ **Versione del motore: scegli 4.0.0**
+ **Classe di istanza: scegli db.r5.large**
+ **Numero di istanze: scegli 3.**
![\[Modulo di opzioni di configurazione per la creazione di un cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. Nella sezione **Autenticazione**, inserisci un nome utente e una password principali.
![\[Modulo di autenticazione per specificare un nome utente e una password principali per un nuovo cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Scegli **Mostra impostazioni avanzate.**
![\[Mostra il pulsante di attivazione delle impostazioni avanzate accanto ai pulsanti Annulla e Crea cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. Nella **sezione Impostazioni di rete**:
+ **Mantieni le opzioni predefinite per **Virtual Private Cloud (VPC)** e Subnet group.**
![\[Modulo delle impostazioni di rete che mostra le opzioni VPC, gruppo di sottorete e gruppi di sicurezza VPC. Nei campi VPC e Subnet group sono selezionate le opzioni predefinite.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Per i **gruppi di sicurezza VPC**, l'**impostazione predefinita (VPC)** dovrebbe già essere aggiunta.
![\[Modulo delle impostazioni di rete che mostra il VPC predefinito già aggiunto.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Digita `DocDB` nel campo **Gruppi di sicurezza VPC** e seleziona **DOCDB-Inbound** (VFC).
![\[VFC in ingresso DOCDB selezionato nel menu a discesa dei gruppi di sicurezza VPC.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. **Per le **opzioni Cluster** ed E, lascia le selezioni predefinite. ncryption-at-rest**
![\[Opzioni e Encryption-at-rest moduli del cluster con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Per le **esportazioni di **Backup** e Log**, lascia le selezioni predefinite.
![\[Moduli di esportazione di Backup and Log con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Per la **protezione da **manutenzione**, **tag** ed eliminazione**, lascia le selezioni predefinite.
![\[Moduli di protezione da manutenzione, tag ed eliminazione con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Ora fai clic sul pulsante che dice **Crea cluster**.
![\[Il pulsante Crea cluster mostrato alla fine del processo di creazione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Utilizzando il AWS CLI
Per creare un cluster regionale Amazon DocumentDB, chiama il. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato. `global-cluster-id` Per ulteriori informazioni sulla protezione da eliminazione, consulta[Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
Inoltre, `--engine-version` è un parametro opzionale che utilizza per impostazione predefinita l'ultima versione principale del motore. L'attuale versione predefinita del motore è `5.0.0` (nota: Amazon DocumentDB 8.0 è disponibile ma deve essere specificata esplicitamente come). `8.0.0` Quando vengono rilasciate nuove versioni principali del motore, la versione del motore di default di `--engine-version` viene aggiornata in modo da riflettere l'ultima versione principale del motore. Di conseguenza, per i carichi di lavoro di produzione, in particolare quelli che dipendono da script, automazione o CloudFormation modelli, si consiglia di specificare esplicitamente la versione `--engine-version` principale desiderata.
Se non `vpc-security-group-id` viene specificato un `db-subnet-group-name` or, Amazon DocumentDB utilizzerà il gruppo di sottoreti e il gruppo di sicurezza Amazon VPC predefiniti per la regione specificata.
Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Per Windows:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La creazione del cluster richiede diversi minuti. È possibile utilizzare Console di gestione AWS o AWS CLI per monitorare lo stato del cluster. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Importante**
Quando si utilizza AWS CLI per creare un cluster regionale Amazon DocumentDB, non viene creata alcuna istanza. Di conseguenza, devi creare esplicitamente un'istanza primaria e le eventuali istanze di replica di cui hai bisogno. Puoi utilizzare la console o AWS CLI creare le istanze. Per ulteriori informazioni, consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) e [CreateDBCluster](API_CreateDBCluster.md) consulta Amazon DocumentDB API Reference.
Una volta che il cluster regionale è disponibile, puoi aggiungere un cluster secondario in un'altra regione con le seguenti istruzioni:[Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB](#global-clusters.add-region). Quando aggiungi una regione, il tuo cluster regionale diventa il tuo cluster principale, e hai un nuovo cluster secondario nella regione che hai scelto.
## Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB
Un cluster globale necessita di almeno un cluster secondario in una regione diversa da quella del cluster primario ed è possibile aggiungere fino a cinque cluster secondari. Tieni presente che per ogni cluster secondario che aggiungi, devi ridurre di una il numero di repliche consentite nel cluster primario. Ad esempio, se il cluster globale ha cinque regioni secondarie, il cluster primario può avere solo 10 (anziché 15) repliche. Per ulteriori informazioni, consulta [Requisiti di configurazione di un cluster globale Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Utilizzando il Console di gestione AWS
1. Accedi Console di gestione AWS e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
![\[La pagina Clusters nella console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Scegli il cluster a cui desideri aggiungere un cluster secondario. Assicurati che il cluster sia`Available`.
![\[Elenco di cluster regionali e globali che mostrano lo stato disponibile, con mydocdbglobalcluster evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. **Seleziona l'elenco a discesa per **Azioni**, quindi scegli Aggiungi regione.**
![\[Il menu a discesa Azioni nell'interfaccia Clusters mostra l'opzione Aggiungi regione.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. Nella Regione AWS pagina **Aggiungi una**, scegli la regione secondaria. Tieni presente che non puoi scegliere una regione che abbia già un cluster secondario per lo stesso cluster globale. Inoltre, non può essere la stessa regione del cluster primario. Se questa è la prima regione che aggiungi, dovrai anche specificare un identificatore globale del cluster a tua scelta.
![\[Scegli una regione secondaria utilizzando il menu a discesa del modulo Aggiungi un Regione AWS modulo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Completa i campi rimanenti per il cluster secondario nella nuova regione, quindi seleziona **Crea cluster**. Dopo aver aggiunto la regione, puoi visualizzarla nell'elenco dei **cluster** in. Console di gestione AWS
![\[Fasi finali dell'aggiunta di una regione a un cluster, visualizzazione del modulo di configurazione, della stima dei costi orari e del pulsante Crea cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Utilizzando il AWS CLI
+ Usa il comando `create-db-cluster` CLI con il nome `(--global-cluster-identifier)` del tuo cluster globale. Per gli altri parametri, effettuare le seguenti operazioni:
+ Perché`--region`, scegli una regione Regione AWS diversa da quella della tua regione principale.
+ Scegli i valori specifici per i parametri `--engine` e `--engine-version`.
+ Per un cluster crittografato, specifica il tuo primario Regione AWS come quello `--source-region` per la crittografia.
L'esempio seguente crea un nuovo cluster Amazon DocumentDB e lo collega al cluster globale come cluster secondario di sola lettura. Nell'ultimo passaggio, l'istanza viene aggiunta al nuovo cluster.
Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Per Windows:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Utilizzo di uno snapshot per il cluster globale Amazon DocumentDB
Puoi ripristinare uno snapshot di un cluster Amazon DocumentDB da utilizzare come punto di partenza per il tuo cluster globale. A tale scopo, è necessario ripristinare lo snapshot e creare un nuovo cluster. Questo fungerà da cluster principale del cluster globale. È quindi possibile aggiungere un'altra regione al cluster ripristinato, convertendola così in un cluster globale.
# Gestione di un cluster globale Amazon DocumentDB
La maggior parte delle operazioni di gestione vengono eseguite sui singoli cluster che costituiscono un cluster globale. Quando si sceglie **Risorse correlate al gruppo** nella pagina **Cluster** della console, vengono visualizzati il cluster primario e i cluster secondari raggruppati nel cluster globale associato.
La scheda **Configurazione** per un cluster globale mostra Regioni AWS dove sono in esecuzione i cluster, la versione e l'identificatore globale del cluster.
**Topics**
+ [Modifica dei cluster globali](#global-clusters.modify)
+ [Modifica dei parametri](#global-clusters.modify-parameters)
+ [Rimozione di cluster globali](#global-clusters.remove)
+ [Eliminazione di cluster globali](#global-clusters.delete)
+ [Cluster headless](#global-clusters.headless)
## Modifica di un cluster globale Amazon DocumentDB
La pagina **Cluster** Console di gestione AWS elenca tutti i cluster globali, mostrando il cluster primario e i cluster secondari per ciascuno di essi. Il cluster globale ha le proprie impostazioni di configurazione. In particolare, ha regioni associate ai suoi cluster primari e secondari.
Quando apporti modifiche al cluster globale, hai la possibilità di annullare le modifiche.
Quando si sceglie Continue (Continua), si confermano le modifiche.
## Modifica dei parametri di un cluster globale Amazon DocumentDB
È possibile configurare i gruppi di parametri del cluster in modo indipendente per ogni cluster all'interno del cluster globale. La maggior parte dei parametri funziona come per altri tipi di cluster Amazon DocumentDB. Si consiglia di mantenere le impostazioni coerenti tra tutti i cluster di un database globale. In questo modo è possibile evitare modifiche impreviste del comportamento se si promuove un cluster secondario come primario.
Ad esempio, utilizzare le stesse impostazioni per fusi orari e set di caratteri per evitare comportamenti incoerenti se un cluster diverso diventa un cluster primario.
## Rimozione di un cluster da un cluster globale Amazon DocumentDB
Esistono diverse situazioni in cui potresti voler rimuovere i cluster dal tuo cluster globale. Ad esempio, potresti voler rimuovere un cluster da un cluster globale se il cluster primario diventa degradato o isolato. Diventa quindi un cluster autonomo con provisioning che può essere utilizzato per creare un nuovo cluster globale. Per ulteriori informazioni, consulta [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover).
Potresti anche voler rimuovere i cluster perché desideri eliminare un cluster globale che non ti serve più. Puoi eliminare il cluster globale solo dopo aver scollegato tutti i cluster associati, lasciando il cluster primario per ultimo. Per ulteriori informazioni, consulta [Eliminazione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.delete).
**Nota**
Quando un cluster viene scollegato dal cluster globale, non è più sincronizzato con il cluster primario. Diventa un cluster con provisioning autonomo con funzionalità complete. read/write Inoltre, non è più visibile nella console Amazon DocumentDB. È visibile solo quando si seleziona la regione nella console in cui si trovava il cluster.
È possibile rimuovere i cluster dal cluster globale utilizzando l' Console di gestione AWS API RDS o AWS CLI l'API RDS.
------
#### [ Using the Console di gestione AWS ]
1. Accedi Console di gestione AWS e accedi alla console Amazon DocumentDB.
1. Scegli **Clusters** nella barra di navigazione a sinistra.
![\[Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Espandi il cluster globale in modo da poter vedere tutti i cluster secondari. Seleziona i cluster secondari che desideri rimuovere. Scegli **Azioni** e, nel menu a discesa, scegli **Rimuovi da globale**.
![\[Immagine: la casella di navigazione Cluster che mostra la selezione di un cluster secondario esistente ed evidenzia l'azione «Rimuovi dal globale».\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. Apparirà un messaggio che ti chiederà di confermare che desideri scollegare il cluster secondario dal cluster globale. Scegli **Rimuovi e promuovi** per rimuovere il cluster dal cluster globale.
![\[Immagine: il prompt Rimuovi e promuovi.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
Ora quel cluster non funge più da cluster secondario e non è più sincronizzato con il cluster primario. È un cluster autonomo con funzionalità complete read/write .
Dopo aver rimosso o eliminato tutti i cluster secondari, è possibile rimuovere il cluster primario nello stesso modo. È possibile scollegare o rimuovere il cluster primario dal cluster globale solo dopo aver rimosso tutti i cluster secondari. Il cluster globale potrebbe rimanere nell'elenco dei cluster, con zero regioni e. AZs È possibile eliminare se non si desidera più utilizzare questo cluster globale.
------
#### [ Using the AWS CLI ]
Per rimuovere un cluster da un cluster globale, esegui il comando `remove-from-global-cluster` CLI con i seguenti parametri:
+ `--global-cluster-identifier`— Il nome (identificatore) del cluster globale.
+ `--db-cluster-identifier`— Il nome di ogni cluster da rimuovere dal cluster globale.
Gli esempi seguenti rimuovono prima un cluster secondario e poi il cluster primario da un cluster globale.
Per Linux, macOS o Unix:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
Ripeti il `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` comando per ogni regione secondaria del cluster globale.
Per Windows:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
Ripeti il `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` comando per ogni regione secondaria del cluster globale.
------
## Eliminazione di un cluster da un cluster globale Amazon DocumentDB
Per eliminare un cluster globale, procedi come segue:
+ Rimuovi tutti i cluster secondari dal cluster globale. Ogni cluster diventa un cluster autonomo. Vedi la sezione precedente,[Rimozione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.remove).
+ Da ogni cluster autonomo, elimina tutte le repliche.
+ Rimuovi il cluster primario dal cluster globale. Questo diventa un cluster autonomo.
+ Dal cluster primario, elimina prima tutte le repliche, quindi elimina l'istanza principale. L'eliminazione dell'istanza primaria dal nuovo cluster autonomo in genere rimuove anche sia il cluster che il cluster globale.
------
#### [ Using the Console di gestione AWS ]
1. Accedi Console di gestione AWS e accedi alla console Amazon DocumentDB.
1. Scegli **Clusters** e trova il cluster globale che desideri eliminare.
![\[Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Con il cluster globale selezionato, scegli **Elimina** dal menu **Azioni**.
![\[Immagine: la casella di navigazione dei cluster che mostra la selezione di un cluster globale ed evidenzia l'azione «Elimina».\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
Conferma che tutti i cluster siano stati rimossi dal cluster globale. Il cluster globale dovrebbe mostrare zero regioni AZs e una dimensione pari a zero cluster. Se il cluster globale contiene dei cluster, non puoi ancora eliminarlo. Dovrai prima seguire le istruzioni del passaggio precedente, **[Rimozione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.remove)**.
------
#### [ Using the AWS CLI ]
Per eliminare un cluster globale, esegui il comando `delete-global-cluster` CLI con il nome Regione AWS e l'identificatore globale del cluster, come illustrato nell'esempio seguente.
Per Linux, macOS o Unix:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Per Windows:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## Creazione di un cluster Amazon DocumentDB headless in una regione secondaria
Sebbene un cluster globale Amazon DocumentDB richieda almeno un cluster secondario in un cluster Regione AWS diverso da quello primario, è possibile utilizzare una configurazione headless per il cluster secondario. Un cluster secondario headless di Amazon DocumentDB è un cluster senza istanza. Questo tipo di configurazione può ridurre le spese per un cluster globale. In un cluster Amazon DocumentDB, elaborazione e storage sono disaccoppiati. Senza l'istanza, non ti viene addebitato alcun costo per l'elaborazione, ma solo per lo storage. Se è configurato correttamente, il volume di archiviazione di un secondario headless viene mantenuto sincronizzato con il cluster primario.
Aggiungi il cluster secondario come fai normalmente quando crei un cluster globale Amazon DocumentDB. Tuttavia, dopo che il cluster primario inizia la replica sul cluster secondario, elimini l'istanza di sola lettura dal cluster secondario. Questo cluster secondario è ora considerato «headless» perché non dispone più di un'istanza. Tuttavia, il volume di storage viene mantenuto sincronizzato con il cluster Amazon DocumentDB principale.
**Importante**
Consigliamo i cluster headless solo per i clienti che possono tollerare guasti a livello regionale per più di 15 minuti. Questo perché il ripristino da un errore a livello regionale con un cluster secondario headless richiederà all'utente di creare una nuova istanza dopo il failover. Una nuova istanza può impiegare circa 10-15 minuti per diventare disponibile.
### Come aggiungere un cluster secondario headless al cluster globale
1. Accedi Console di gestione AWS e apri la console [Amazon DocumentDB.](https://console.aws.amazon.com/rds/)
1. Scegli **Clusters** nella barra di navigazione a sinistra.
1. Scegli il cluster globale che necessita di un cluster secondario. Assicurati che il cluster primario sia`Available`.
1. Per **Actions (Operazioni)**, scegliere **Add region (Aggiungi regione)**.
1. Nella pagina **Aggiungi una regione**, scegli la regione secondaria.
**Nota**
Non puoi scegliere una regione che abbia già un cluster secondario per lo stesso cluster globale. Inoltre, non può essere la stessa regione del cluster primario.
1. Completa i campi rimanenti per il cluster secondario nella nuova regione. Queste sono le stesse opzioni di configurazione di qualsiasi istanza del cluster.
1. Aggiungi una regione. Dopo aver aggiunto la regione al cluster globale, la vedrai nell'elenco di `Clusters` Console di gestione AWS.
1. Controlla lo stato del cluster secondario e della relativa istanza di lettura prima di continuare, utilizzando Console di gestione AWS o il AWS CLI. Ecco un esempio di comando se si utilizza AWS CLI:
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
Possono essere necessari diversi minuti prima che lo stato di un cluster secondario appena aggiunto cambi da creazione a disponibile. Quando il cluster è disponibile, puoi eliminare l'istanza del lettore.
1. Seleziona l'istanza del lettore nel cluster secondario, quindi scegli **Elimina**.
1. Dopo aver eliminato l'istanza del lettore, il cluster secondario rimane parte del cluster globale. Non dovrebbe avere alcuna istanza associata.
**Nota**
Puoi utilizzare questo cluster secondario headless di Amazon DocumentDB per ripristinare manualmente il cluster globale Amazon DocumentDB da un'interruzione non pianificata nella regione principale, se si verifica un'interruzione di questo tipo.
# Connect a un cluster globale Amazon DocumentDB
Il modo in cui ci si connette a un cluster globale dipende dal fatto che sia necessario scrivere sul cluster o leggere dal cluster:
+ Per richieste o interrogazioni di sola lettura, ti connetti all'endpoint di lettura per il cluster del tuo. Regione AWS
+ Per eseguire le istruzioni DML (Data Manipulation Language) o DDL (Data Definition Language), esegui la connessione all'endpoint del cluster per il cluster primario. Questo endpoint potrebbe trovarsi in un'applicazione diversa da quella in uso. Regione AWS
Quando si visualizza un cluster globale nella console, è possibile visualizzare tutti gli endpoint generici associati a tutti i relativi cluster.
Il modo in cui ci si connette a un cluster globale dipende dal fatto che sia necessario scrivere sul database o leggere dal database. Per le operazioni DDL, DML e di lettura che desideri eseguire dalla regione primaria, devi connetterti al cluster primario. Si consiglia di connettersi al cluster primario utilizzando l'endpoint del cluster in modalità set di replica, con una preferenza di lettura di. `secondaryPreferred=true` Questo indirizzerà il traffico di scrittura verso l'istanza writer del cluster primario e il traffico di lettura verso l'istanza di replica del cluster primario.
Per il traffico interregionale e di sola lettura, è necessario connettersi a uno dei cluster secondari. Ti consigliamo di connetterti al cluster secondario utilizzando l'endpoint del cluster in modalità set di repliche. Poiché tutte le istanze sono istanze di replica di sola lettura, non è necessario specificare una preferenza di lettura. Per ridurre al minimo la latenza, scegli l'endpoint di lettura che si trova nella tua regione o nella regione più vicina a te.
# Monitoraggio dei cluster globali di Amazon DocumentDB
Amazon DocumentDB (con compatibilità con MongoDB) si integra per CloudWatch consentirti di raccogliere e analizzare i parametri operativi per i tuoi cluster. Puoi monitorare questi parametri utilizzando la CloudWatch console, la console Amazon DocumentDB, AWS Command Line Interface il AWS CLI() o CloudWatch l'API.
Per monitorare un cluster globale, utilizza le seguenti CloudWatch metriche.
| Metrica | Description |
| --- | --- |
| GlobalClusterReplicatedWriteIO | Il numero medio di I/O operazioni di scrittura fatturate replicate dal volume del cluster nel volume primario Regione AWS al volume del cluster in un volume secondario Regione AWS, riportato a intervalli di 5 minuti. Il numero di repliche ReplicatedWriteIOs in ciascuna regione secondaria è uguale al numero di repliche interne VolumeWriteIOPs eseguite dall'area principale. |
| GlobalClusterDataTransferBytes | La quantità di dati trasferiti dal cluster primario Regione AWS a quello secondario Regione AWS, misurata in byte. |
| GlobalClusterReplicationLag | La quantità di ritardo, in millisecondi, durante la replica degli eventi di modifica dal cluster primario a quello di un cluster secondario Regione AWS Regione AWS |
[Per ulteriori informazioni su come visualizzare queste metriche, consulta Visualizzazione dei dati. CloudWatch ](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data)
# Disaster recovery e cluster globali Amazon DocumentDB
**Topics**
+ [
## Esecuzione di un failover gestito per un cluster globale Amazon DocumentDB
](#managed-failover)
+ [
## Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB
](#manual-failover)
+ [
## Esecuzione di uno switchover per un cluster globale Amazon DocumentDB
](#global-cluster-switchover)
+ [
## Sblocco dello switchover o del failover di un cluster globale
](#unblocking-gc-so-fo)
Utilizzando un cluster globale, puoi eseguire rapidamente il ripristino da disastri come i guasti regionali. Il ripristino da emergenza viene in genere misurato utilizzando i valori per RTO e RPO.
+ **Obiettivo del tempo di ripristino (RTO)**: il tempo necessario a un sistema per tornare in uno stato funzionante dopo un'emergenza. In altre parole, l'RTO misura i tempi di inattività. Per un cluster globale, RTO in pochi minuti.
+ **Obiettivo del punto di ripristino (RPO)**: la quantità di dati che possono essere persi (misurata nel tempo). Per un cluster globale, l'RPO viene in genere misurato in secondi.
+ Per ripristinare il sistema dopo un'interruzione non pianificata, è possibile eseguire un failover interregionale su uno dei sistemi secondari del cluster globale. Se il cluster globale ha più regioni secondarie, assicurati di scollegare tutte le regioni secondarie che desideri promuovere come principali. Quindi, promuovi una di queste regioni secondarie affinché diventi la nuova principale. Regione AWS Infine, crei nuovi cluster in ciascuna delle altre regioni secondarie e colleghi tali cluster al tuo cluster globale.
## Esecuzione di un failover gestito per un cluster globale Amazon DocumentDB
Questo approccio è destinato alla continuità aziendale in caso di una reale emergenza a livello regionale o di un'interruzione completa del livello di servizio.
Durante un failover gestito, il cluster primario viene eseguito il failover nella regione secondaria prescelta, mentre viene mantenuta la topologia di replica esistente del cluster globale Amazon DocumentDB. Il cluster secondario scelto promuove uno dei suoi nodi di sola lettura allo stato di istanza di scrittura completa. Questo passaggio consente al cluster di assumere il ruolo di cluster primario. Il database non sarà disponibile per un breve periodo di tempo mentre il cluster sta assumendo il suo nuovo ruolo. I dati che non sono stati replicati dal vecchio cluster primario al cluster secondario scelto potrebbero mancare quando questo secondario diventa il nuovo primario. Il vecchio volume primario fa del suo meglio per scattare un'istantanea prima di sincronizzarsi con il nuovo volume primario, in modo che i dati non replicati vengano conservati nell'istantanea.
**Nota**
È possibile eseguire un failover di cluster interregionale gestito su un cluster globale Amazon DocumentDB solo se i cluster primari e tutti i cluster secondari hanno le stesse versioni del motore. Se le versioni del motore non sono compatibili, puoi eseguire il failover manualmente seguendo i passaggi indicati in [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](#manual-failover).
Se le versioni del motore della regione non corrispondono, il failover verrà bloccato. Verifica la presenza di eventuali aggiornamenti in sospeso e applicali per assicurarti che le versioni del motore di tutte le regioni corrispondano e che il failover globale del cluster sia sbloccato. Per ulteriori informazioni, consulta [Sblocco dello switchover o del failover di un cluster globale](#unblocking-gc-so-fo).
Per ridurre al minimo la perdita di dati, è consigliabile eseguire le seguenti operazioni prima di utilizzare questa funzionalità:
+ Metti offline le applicazioni per evitare che le scritture vengano inviate al cluster primario del cluster globale Amazon DocumentDB.
+ Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB. La scelta della regione secondaria con il minor ritardo di replica può ridurre al minimo la perdita di dati relativamente all'attuale regione primaria in stato di errore. Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB nel cluster globale visualizzando la `GlobalClusterReplicationLag` metrica in Amazon. CloudWatch Questi parametri mostrano quanto sia indietro (in millisecondi) la replica su un cluster secondario rispetto al cluster primario.
Per ulteriori informazioni sui CloudWatch parametri per Amazon DocumentDB, consulta. [Metriche di Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante un failover gestito, il cluster secondario scelto viene promosso al suo nuovo ruolo di primario. Tuttavia, non eredita le varie opzioni di configurazione del cluster primario. Una mancata corrispondenza nella configurazione può causare problemi di prestazioni, incompatibilità dei carichi di lavoro e altri comportamenti anomali. Per evitare tali problemi, ti consigliamo di risolvere le differenze tra i cluster globali di Amazon DocumentDB per quanto segue:
+ **Se necessario, configura un gruppo di parametri del cluster Amazon DocumentDB per il nuovo cluster primario**: puoi configurare i gruppi di parametri del cluster Amazon DocumentDB in modo indipendente per ogni cluster nei cluster globali Amazon DocumentDB. Pertanto, quando promuovi un cluster secondario affinché assuma il ruolo principale, il gruppo di parametri del secondario potrebbe essere configurato in modo diverso rispetto a quello primario. In tal caso, modifica il gruppo di parametri del cluster secondario promosso in modo che sia conforme alle impostazioni del cluster primario. Per scoprire come, consulta [Modifica dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ **Configura strumenti e opzioni di monitoraggio, come CloudWatch eventi e allarmi Amazon**: configura il cluster promosso con la stessa capacità di registrazione, allarmi e così via necessari per il cluster globale. Come per i gruppi di parametri, la configurazione di queste funzionalità non viene ereditata dal primario durante il processo di failover. Alcune CloudWatch metriche, come il ritardo di replica, sono disponibili solo per le regioni secondarie. Pertanto, un failover modifica il modo in cui visualizzare tali metriche e impostare i relativi allarmi e potrebbe richiedere modifiche da apportare a qualsiasi dashboard predefinito. Per ulteriori informazioni sui cluster e sul monitoraggio di Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md)
In genere, il cluster secondario scelto assume il ruolo principale entro un minuto. Non appena il nodo di scrittura della nuova regione primaria è disponibile, puoi connettervi le tue applicazioni e riprendere i tuoi carichi di lavoro. Dopo aver promosso il nuovo cluster primario, Amazon DocumentDB ricostruisce automaticamente tutti i cluster regionali secondari aggiuntivi.
Poiché i cluster globali di Amazon DocumentDB utilizzano la replica asincrona, il ritardo di replica in ciascuna regione secondaria può variare. Amazon DocumentDB ricostruisce queste regioni secondarie in modo che abbiano esattamente gli stessi point-in-time dati del nuovo cluster Region primario. La durata dell'attività di ricostruzione completa può richiedere da alcuni minuti a diverse ore, a seconda delle dimensioni del volume di archiviazione e della distanza tra regioni. Quando i cluster regionali secondari terminano la ricostruzione in base alla nuova regione primaria, diventano disponibili per l'accesso in lettura. Non appena il nuovo writer primario viene promosso e reso disponibile, il cluster della nuova regione primaria può gestire le operazioni di lettura e scrittura per il cluster globale Amazon DocumentDB.
Per ripristinare la topologia originale del cluster globale, Amazon DocumentDB monitora la disponibilità della vecchia regione primaria. Non appena la regione è di nuovo integra e disponibile, Amazon DocumentDB la riaggiunge automaticamente al cluster globale come regione secondaria. Prima di creare il nuovo volume di storage nella vecchia regione primaria, Amazon DocumentDB tenta di scattare un'istantanea del vecchio volume di storage nel punto in cui si è verificato l'errore. Ciò consente di usare lo snapshot per recuperare i dati mancanti. Se questa operazione ha esito positivo, Amazon DocumentDB inserisce questa istantanea denominata «rds: docdb-unplanned-global-failover - name-of-old-primary -DB-Cluster-Timestamp» nella sezione snapshot di. Console di gestione AWS Puoi anche vedere questa istantanea elencata nelle informazioni restituite dall'operazione API. `DescribeDBClusterSnapshots`
**Nota**
Lo snapshot del vecchio volume di archiviazione è uno snapshot del sistema soggetto al periodo di conservazione del backup configurato sul vecchio cluster primario. Per conservare questo snapshot oltre il periodo di conservazione, puoi copiarlo e salvarlo come snapshot manuale. Per ulteriori informazioni sulla copia degli snapshot, inclusi i prezzi, consulta [Copiare uno snapshot del cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Dopo il ripristino della topologia originale, è possibile eseguire il failback del cluster globale nella regione primaria originale eseguendo un'operazione di switchover nel momento più opportuno per l'azienda e il carico di lavoro. A tale scopo, segui la procedura in [Esecuzione di uno switchover per un cluster globale Amazon DocumentDB](#global-cluster-switchover).
Puoi eseguire il failover del cluster globale Amazon DocumentDB utilizzando l' Console di gestione AWS API Amazon DocumentDB o Amazon DocumentDB. AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Esegui un failover gestito sul tuo cluster globale Amazon DocumentDB**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. Trova e scegli il cluster globale Amazon DocumentDB di cui desideri eseguire il failover.
![\[Immagine: tabella del cluster con cluster globale selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. **Scegli **Switchover o Failover dal menu** Azioni.**
1. Nella finestra di dialogo che appare, scegli **Failover**, quindi scegli il cluster secondario dall'elenco a discesa del campo **Nuovo cluster primario**.
![\[Immagine: finestra di dialogo di switchover o failover del cluster globale.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Digita «conferma» nell'ultimo campo. Quindi scegli **Conferma**.
Lo stato del cluster primario cambia in "**Failing-over**». Questa condizione dovrebbe richiedere circa un minuto. Durante questo periodo, lo stato del nuovo cluster primario mostra "**Modifica** in corso... ». Una volta promosso, il nuovo primario mostrerà "**Disponibile**" e sarà in grado di fornire transazioni di lettura e scrittura. Le regioni secondarie, inclusa la vecchia primaria, mostreranno "**Risincronizzazione**... «mentre si risincronizza con il nuovo primario. **Analogamente al nuovo primario, sarà in grado di eseguire la transazione solo quando lo stato passerà a "Disponibile».**
1. Una volta completato, il cluster primario originale diventa il cluster secondario. Il cluster secondario selezionato diventa il cluster primario.
![\[Immagine: tabella dei cluster che mostra il nuovo cluster primario.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Esegui un failover gestito sul tuo cluster globale Amazon DocumentDB**
Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI per eseguire il failover del cluster globale Amazon DocumentDB. Con il comando, passa i valori per le seguenti opzioni:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster.
Per Linux, macOS o Unix:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Per Windows:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB
Se un intero cluster in uno non è Regione AWS più disponibile, puoi promuovere un altro cluster del cluster globale affinché read/write disponga delle funzionalità.
È possibile attivare manualmente il meccanismo di failover globale del cluster se un cluster in un altro Regione AWS è la scelta migliore come cluster principale. Ad esempio, potrebbe essere necessario incrementare la capacità di uno dei cluster secondari e quindi promuoverlo a cluster primario. Oppure l'equilibrio delle attività tra i due Regioni AWS potrebbe cambiare, in modo che il passaggio dal cluster primario a un altro Regione AWS potrebbe comportare una minore latenza per le operazioni di scrittura.
La procedura seguente descrive cosa fare per promuovere uno dei cluster secondari in un cluster globale Amazon DocumentDB.
Per promuovere un cluster secondario:
1. Interrompi l'emissione di istruzioni DML e altre operazioni di scrittura sul cluster primario in caso Regione AWS di interruzione.
1. Identifica un cluster da un cluster secondario da Regione AWS utilizzare come nuovo cluster primario. Se hai due (o più) cluster secondari Regioni AWS nel tuo cluster globale, scegli il cluster secondario con il minor ritardo.
1. Scollega il cluster secondario scelto dal cluster globale.
La rimozione di un cluster secondario da un cluster globale interrompe immediatamente la replica dal primario a questo secondario e la promuove in un cluster autonomo con funzionalità complete. read/write Qualsiasi altro cluster secondario associato al cluster primario nella regione interessata dall'interruzione è ancora disponibile e può accettare chiamate dall'applicazione. Inoltre consumano risorse. Poiché state ricreando il cluster globale, per evitare problemi di tipo split-brain e di altro tipo, rimuovete gli altri cluster secondari prima di creare il nuovo cluster globale nei passaggi seguenti.
Per i passaggi dettagliati per lo scollegamento, consulta [Rimozione di un cluster da un cluster globale Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
1. Questo cluster diventa il cluster principale di un nuovo cluster globale quando inizi ad aggiungervi regioni, nel passaggio successivo.
1. Aggiungi un Regione AWS al cluster. Quando esegui questa operazione, inizia il processo di replica da primario a secondario.
1. Aggiungine altro Regioni AWS se necessario per ricreare la topologia necessaria per supportare l'applicazione. Assicurati che le scritture delle applicazioni vengano inviate al cluster corretto prima, durante e dopo aver apportato modifiche come queste, per evitare incongruenze di dati tra i cluster del cluster globale (problemi di split-brain).
1. Quando l'interruzione è stata risolta e sei pronto a riassegnare il cluster originale Regione AWS come cluster primario, esegui la stessa procedura in senso inverso.
1. Rimuovi uno dei cluster secondari dal cluster globale. Ciò gli consentirà di servire il read/write traffico.
1. Reindirizza tutto il traffico di scrittura al cluster primario dell'originale Regione AWS.
1. Aggiungi un Regione AWS per configurare uno o più cluster secondari nello stesso modo di prima Regione AWS .
I cluster globali di Amazon DocumentDB possono essere gestiti utilizzando AWS SDKs, il che consente di creare soluzioni per automatizzare il processo di failover globale dei cluster per i casi d'uso di Disaster Recovery e Business Continuity Planning. [Una di queste soluzioni è disponibile per i nostri clienti con licenza Apache 2.0 ed è accessibile dal nostro repository di strumenti qui.](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation) Questa soluzione sfrutta Amazon Route 53 per la gestione degli endpoint e fornisce AWS Lambda funzioni che possono essere attivate in base a eventi appropriati.
## Esecuzione di uno switchover per un cluster globale Amazon DocumentDB
Utilizzando gli switchover, è possibile modificare regolarmente la Regione del cluster primario. Questo approccio è destinato agli scenari controllati, ad esempio durante la manutenzione operativa e altre procedure operative pianificate.
Esistono tre casi d'uso comuni per l'utilizzo degli switchover:
+ Per i requisiti relativi alla "rotazione regionale" imposti a settori specifici. Ad esempio, le normative sui servizi finanziari potrebbero imporre che i sistemi di livello 0 passino a un'altra regione per diversi mesi per garantire l'esecuzione regolare delle procedure di ripristino di emergenza.
+ Per applicazioni "" multiregionali. follow-the-sun Ad esempio, un'azienda potrebbe voler fornire scritture con latenza inferiore in diverse regioni in base all'orario di lavoro nei vari fusi orari.
+ Come zero-data-loss metodo per tornare alla regione principale originale dopo un failover.
**Nota**
Gli switchover sono progettati per essere utilizzati su un cluster globale Amazon DocumentDB integro. Per eseguire il ripristino da un'interruzione non pianificata, puoi eseguire la procedura appropriata descritta in [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](#manual-failover).
Per eseguire uno switchover, tutte le regioni secondarie devono utilizzare la stessa identica versione del motore del motore principale. Se le versioni del motore della regione non corrispondono, lo switchover verrà bloccato. Verifica la presenza di eventuali aggiornamenti in sospeso e applicali per assicurarti che le versioni del motore di tutte le regioni corrispondano e che il passaggio al cluster globale sia sbloccato. Per ulteriori informazioni, consulta [Sblocco dello switchover o del failover di un cluster globale](#unblocking-gc-so-fo).
Durante uno switchover, Amazon DocumentDB trasferisce il cluster primario alla regione secondaria prescelta, mantenendo al contempo la topologia di replica esistente del cluster globale. Prima di avviare il processo di passaggio, Amazon DocumentDB attende che tutti i cluster regionali secondari siano completamente sincronizzati con il cluster Region primario. Il cluster database nella regione primaria diventa di sola lettura e il cluster secondario scelto promuove uno dei relativi nodi di sola lettura allo stato di nodo di scrittura completa. La promozione di questo nodo a nodo di scrittura consente a tale cluster secondario di assumere il ruolo di cluster primario. Poiché tutti i cluster secondari sono stati sincronizzati con quello primario all'inizio del processo, il nuovo cluster primario continua a operare per il cluster globale Amazon DocumentDB senza perdere alcun dato. Il database non è disponibile per un breve periodo, mentre i cluster primario e secondario selezionati assumono i loro nuovi ruoli.
Per ottimizzare la disponibilità delle applicazioni, è consigliabile eseguire le seguenti operazioni prima di utilizzare questa funzionalità:
+ Esegui questa operazione durante le ore non di punta o in un altro momento in cui le scritture sul cluster primario sono minime.
+ Metti offline le applicazioni per evitare che le scritture vengano inviate al cluster primario del cluster globale Amazon DocumentDB.
+ Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB nel cluster globale visualizzando la `GlobalClusterReplicationLag` metrica in Amazon. CloudWatch Questa metrica mostra quanto sia indietro (in millisecondi) la replica su un cluster secondario rispetto al cluster primario. Questo valore è direttamente proporzionale al tempo impiegato da Amazon DocumentDB per completare lo switchover. Di conseguenza, maggiore è il valore del ritardo, maggiore sarà il tempo necessario per lo switchover.
Per ulteriori informazioni sui CloudWatch parametri per Amazon DocumentDB, consulta. [Metriche di Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante uno switchover gestito, il cluster database secondario scelto viene promosso al nuovo ruolo primario. Tuttavia, non eredita le varie opzioni di configurazione del cluster di database primario. Una mancata corrispondenza nella configurazione può causare problemi di prestazioni, incompatibilità dei carichi di lavoro e altri comportamenti anomali. Per evitare tali problemi, ti consigliamo di risolvere le differenze tra i cluster globali di Amazon DocumentDB per quanto segue:
+ **Se necessario, configura il gruppo di parametri del cluster Amazon DocumentDB per il nuovo cluster primario**: puoi configurare i gruppi di parametri del cluster Amazon DocumentDB in modo indipendente per ogni cluster del tuo cluster globale Amazon DocumentDB. Ciò significa che quando si promuove un cluster di database secondario perché assuma il ruolo primario, il gruppo di parametri dal secondario potrebbe essere configurato in modo diverso rispetto al primario. In tal caso, modifica il gruppo di parametri del cluster di database secondario promosso in modo che sia conforme alle impostazioni del cluster primario. Per scoprire come, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ **Configura strumenti e opzioni di monitoraggio, come Amazon CloudWatch Events e allarmi**: configura il cluster promosso con la stessa capacità di registrazione, allarmi e così via necessari per il cluster globale. Come per i gruppi di parametri, la configurazione di queste funzionalità non viene ereditata dal ruolo primario durante il processo di switchover. Alcune CloudWatch metriche, come il ritardo di replica, sono disponibili solo per le regioni primarie. Pertanto, uno switchover modifica il modo in cui visualizzare tali metriche e impostare i relativi allarmi e potrebbe richiedere modifiche da apportare a qualsiasi dashboard predefinito. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md).
**Nota**
In genere, lo switchover del ruolo può richiedere fino a diversi minuti.
Una volta completato il processo di passaggio, il cluster Amazon DocumentDB promosso può gestire le operazioni di scrittura per il cluster globale.
Puoi passare da un cluster globale di Amazon DocumentDB utilizzando Console di gestione AWS o: AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Esegui uno switchover sul tuo cluster globale Amazon DocumentDB**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. Trova e seleziona il cluster globale Amazon DocumentDB da trasferire.
![\[Immagine: tabella del cluster con cluster globale selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. **Scegli **Switchover o Failover dal menu** Azioni.**
1. Nella finestra di dialogo che appare, scegli **Switchover**, quindi scegli il cluster secondario dall'elenco a discesa del campo **Nuovo cluster primario**.
![\[Immagine: finestra di dialogo di commutazione del cluster con il cluster secondario selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Scegli **Conferma**.
Lo stato del cluster primario cambia in "**Switching-over**». Questa condizione dovrebbe richiedere circa tre minuti. Durante questo periodo, lo stato di tutti i cluster regionali mostra "**Modifica**... ». Una volta sincronizzate le regioni e promosso il nuovo primario, verrà visualizzato il messaggio "**Disponibile**" per tutti i campi di stato e sarà possibile gestire le transazioni.
1. Una volta completato, il cluster primario originale diventa il cluster secondario. Il cluster secondario selezionato diventa il cluster primario.
![\[Immagine: tabella dei cluster che mostra il nuovo cluster primario.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Esegui uno switchover sul tuo cluster globale Amazon DocumentDB**
Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI per passare al cluster globale Amazon DocumentDB. Con il comando, passa i valori per le seguenti opzioni:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster.
Per Linux, macOS o Unix:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Per Windows:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## Sblocco dello switchover o del failover di un cluster globale
Gli switchover e i failover del cluster globale vengono bloccati quando non tutti i cluster regionali del cluster globale utilizzano la stessa versione del motore. Se le versioni non corrispondono, è possibile che venga visualizzato questo errore in risposta quando si richiama uno switchover o un failover: il cluster DB di destinazione specificato esegue una versione del motore con un livello di patch diverso rispetto al cluster DB di origine. Ti consigliamo di applicare regolarmente le versioni più recenti del motore per assicurarti di eseguire gli aggiornamenti più recenti per mantenere i cluster globali in uno stato integro.
Per risolvere questo errore, aggiorna prima tutte le aree secondarie e poi l'area principale alla stessa versione del motore applicando eventuali azioni di manutenzione in sospeso. Per visualizzare le azioni di manutenzione in sospeso e applicare le modifiche necessarie per correggere il problema, segui le istruzioni in una delle seguenti schede:
------
#### [ Using the Console di gestione AWS ]
Per sbloccare lo switchover o il failover di un cluster globale, è necessario determinare se vi sono azioni di manutenzione in sospeso per i cluster e applicarle. Segui questi passaggi per visualizzare e applicare le azioni di manutenzione:
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. **Nella tabella **Cluster**, individua il cluster globale nella colonna Cluster identifier.** Nel cluster globale, prendi nota di ogni cluster secondario e del cluster primario per il cluster globale specificato ed esegui i seguenti passaggi per ciascuno.
1. Per ogni cluster secondario:
1. Se è disponibile un aggiornamento per il cluster, viene indicato come **Disponibile**, **Obbligatorio** o **Finestra successiva** nella colonna **Manutenzione**.
1. Per eseguire un'azione, scegli il cluster per mostrarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**.
1. In **Descrizione**, se indica che è disponibile un «Nuovo aggiornamento di manutenzione», selezionalo e scegli **Applica ora**.
1. Per il tuo cluster principale:
1. Se è disponibile un aggiornamento per il cluster, viene indicato come **Disponibile**, **Obbligatorio** o **Finestra successiva** nella colonna **Manutenzione**.
1. Per eseguire un'azione, scegli il cluster per mostrarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**.
1. In **Descrizione**, se indica che è disponibile un «Nuovo aggiornamento di manutenzione», selezionalo e scegli **Applica ora**.
------
#### [ Using the AWS CLI ]
Per sbloccare uno switchover o un failover globale del cluster, devi determinare se ci sono azioni di manutenzione in sospeso per il cluster e applicarle. Segui questi passaggi per visualizzare e applicare le azioni di manutenzione prima sui cluster secondari e poi sul cluster primario per il cluster globale:
1. Esegui quanto segue prima sul cluster regionale di ogni regione secondaria e poi per il cluster regionale della regione primaria.
1. Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI con l'`--resource-identifier`opzione per determinare se sono disponibili azioni di manutenzione per il tuo cluster regionale Amazon DocumentDB.
Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster.
Per Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Per Windows:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Il risultato è simile al seguente:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. Se è necessaria un'azione di manutenzione, esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI con le seguenti opzioni:
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster.
Per Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Per Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. Una volta completata l'azione di manutenzione, esegui nuovamente il [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)comando per assicurarti che non vi siano altre azioni in sospeso per il cluster.
Il risultato che desideri è:
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Per sbloccare uno switchover o un failover globale del cluster, è necessario determinare se vi sono azioni di manutenzione in sospeso per il cluster e applicarle. Utilizza quanto segue per visualizzare e applicare le azioni APIs di manutenzione:
1. Esegui quanto segue prima sul cluster regionale di ogni regione secondaria e poi per il cluster regionale delle regioni primarie.
1. Chiama l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API per determinare se sono disponibili azioni di manutenzione per il tuo cluster globale Amazon DocumentDB.
1. Applica eventuali modifiche chiamando l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API.
------