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à.
# 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.