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 dei cluster Amazon DocumentDB
Per gestire un cluster Amazon DocumentDB, è necessario disporre di una policy IAM con le autorizzazioni appropriate del piano di controllo di Amazon DocumentDB. Queste autorizzazioni consentono di creare, modificare ed eliminare i cluster e le istanze. La `AmazonDocDBFullAccess` policy fornisce tutte le autorizzazioni necessarie per amministrare un cluster Amazon DocumentDB.
I seguenti argomenti mostrano come eseguire varie attività quando si lavora con i cluster Amazon DocumentDB, tra cui la creazione, l'eliminazione, la modifica, la connessione e la visualizzazione dei cluster.
**Topics**
+ [Comprendere i cluster](db-clusters-understanding.md)
+ [Impostazioni del cluster](db-cluster-parameters.md)
+ [Configurazioni di storage in cluster](db-cluster-storage-configs.md)
+ [Determinazione dello stato di un cluster](db-cluster-status.md)
+ [Ciclo di vita del cluster](db-cluster-life-cycle.md)
+ [Scalabilità dei cluster](db-cluster-manage-performance.md)
+ [Clonazione di un volume per un cluster](db-cluster-cloning.md)
+ [Comprendere la tolleranza agli errori del cluster](db-cluster-fault-tolerance.md)
# Comprendere i cluster
Amazon DocumentDB separa elaborazione e storage e trasferisce la replica e il backup dei dati sul volume del cluster. Un volume cluster fornisce un servizio di storage durevole, affidabile e altamente disponibile che replica i dati in sei modi in tre zone di disponibilità. Le repliche consentono una maggiore disponibilità dei dati e il dimensionamento della lettura. Ogni cluster può scalare fino a 15 repliche.
| Sostantivo | Description | Operazioni API (verbi) |
| --- | --- | --- |
| Cluster | È composto da una o più istanze e da un volume di storage cluster per la gestione dei dati di tali istanze. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Istanza | La lettura e la scrittura dei dati sul volume di storage cluster vengono eseguite mediante le istanze. In un determinato cluster sono disponibili due tipi di istanze: primaria e di replica. Un cluster ha sempre un'istanza principale e può avere da 0 a 15 repliche. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Volume cluster | Un volume di storage per database virtuali che si estende su tre zone di disponibilità, ciascuna delle quali contiene due copie dei dati del cluster. | N/D |
| Istanza primaria | Supporta operazioni di lettura e scrittura ed esegue tutte le modifiche ai dati del volume cluster. Ogni cluster contiene un'istanza primaria. | N/D |
| Istanza di replica | Supporta solo le operazioni di lettura. Ogni cluster Amazon DocumentDB può avere fino a 15 istanze di replica oltre all'istanza principale. Le repliche distribuiscono il carico di lavoro di lettura. Collocando le repliche in zone di disponibilità separate, puoi anche aumentare la disponibilità del database. | N/D |
| Endpoint del cluster | Un endpoint per un cluster Amazon DocumentDB che si connette all'istanza primaria corrente del cluster. Ogni cluster Amazon DocumentDB ha un endpoint del cluster e un'istanza principale. | N/D |
| Endpoint di lettura | Un endpoint per un cluster Amazon DocumentDB che si connette a una delle repliche disponibili per quel cluster. Ogni cluster Amazon DocumentDB dispone di un endpoint di lettura. Se è presente più di una replica, l'endpoint del lettore indirizza ogni richiesta di connessione a una delle repliche di Amazon DocumentDB. | N/D |
| Endpoint dell'istanza | Un endpoint per un'istanza in un cluster Amazon DocumentDB che si connette a un'istanza specifica. Ogni istanza di un cluster, a prescindere dal tipo, ha un proprio endpoint dell'istanza esclusivo. | N/D |
# Impostazioni del cluster Amazon DocumentDB
Quando crei o modifichi un cluster, è importante comprendere quali siano i parametri immutabili e quali quelli modificabili dopo la creazione del cluster. La tabella seguente elenca tutte le impostazioni (parametri) specifiche di un cluster. Come specificato nella tabella, alcuni sono modificabili, altri no.
**Nota**
Queste impostazioni non devono essere confuse con i gruppi di parametri del cluster Amazon DocumentDB e i relativi parametri. Per ulteriori informazioni sui gruppi di parametri del cluster, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md).
| Parametro | Modificabile | Note |
| --- | --- | --- |
| DBClusterIdentifier | Sì | Vincoli per la denominazione [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | No | Deve essere docdb. |
| BackupRetentionPeriod | Sì | Deve essere compreso tra [1 e 35] giorni. |
| DBClusterParameterGroupName | Sì | Vincoli per la denominazione [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | No | Dopo aver creato un cluster, non puoi modificarne la sottorete. |
| EngineVersion | No | Il valore può essere 5.0.0 (impostazione predefinita), 4.0.0 o. 3.6.0 |
| KmsKeyId | No | Se si sceglie di crittografare il cluster, non è possibile modificare la AWS KMS chiave utilizzata per crittografare il cluster. |
| MasterUsername | No | Dopo aver creato un cluster, non puoi modificarne il `MasterUsername`. Vincoli per la denominazione [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Sì | Vincoli: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Sì | Il numero di porta è valido per tutte le istanze del cluster. |
| PreferredBackupWindow | Sì | |
| PreferredMaintenanceWindow | Sì | |
| StorageEncrypted | No | Se scegli di crittografare il cluster, non potrà essere decrittografato. |
| StorageType | Sì | Il tipo di archiviazione per il cluster DB: Standard (`standard`) o I/O-Optimized (). `iopt1` Impostazione predefinita: `standard` Questo parametro può essere configurato con `CreateDBCluster` and. `ModifyDBCluster` Per ulteriori informazioni, consulta [Configurazioni di storage in cluster Amazon DocumentDB](db-cluster-storage-configs.md). |
| Tags | Sì | |
| VpcSecurityGroupIds | No | Dopo aver creato un cluster, non puoi modificare il VPC su cui risiede. |
# Configurazioni di storage in cluster Amazon DocumentDB
A partire da Amazon DocumentDB 5.0, i cluster basati su istanze supportano due tipi di configurazione dello storage:
+ **Storage standard Amazon DocumentDB**: progettato per clienti con consumi da bassi a moderati I/O . Se prevedi che i I/O costi siano inferiori al 25% del totale del cluster Amazon DocumentDB, questa scelta potrebbe essere la soluzione ideale per te. Con la configurazione di storage standard di Amazon DocumentDB, la fatturazione si aggiunge ai costi di pay-per-request I/O istanza e di storage. Ciò significa che la fatturazione potrebbe variare da un ciclo all'altro in base all'utilizzo. La configurazione è personalizzata per soddisfare le I/O esigenze fluttuanti dell'applicazione.
+ **Storage ottimizzato per l'I/O di Amazon DocumentDB**: progettato per i clienti che danno priorità alla prevedibilità dei prezzi o hanno applicazioni intensive. I/O Le I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O operazioni, garantendo costi prevedibili in ogni ciclo di fatturazione. La configurazione stabilizza i costi migliorando al contempo le prestazioni.
Puoi passare i cluster di database esistenti una volta ogni 30 giorni ad Amazon I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O DocumentDB, ottimizzati e monitorati con `describe-db-clusters` il comando utilizzando o tramite AWS CLI la pagina di configurazione Console di gestione AWS del cluster.
[Puoi creare un nuovo cluster di database che includa la configurazione ottimizzata per l'I/O di Amazon DocumentDB o convertire i cluster di database esistenti con pochi clic [Console di gestione AWS](https://console.aws.amazon.com/docdb/), una singola modifica di parametro in () o tramite.AWS Command Line InterfaceAWS CLI[AWS SDKs](https://aws.amazon.com/developer/tools/)](https://aws.amazon.com/cli/) Non sono necessari tempi di inattività o riavvio delle istanze durante o dopo la modifica della configurazione di storage.
![\[Immagine: tabella che descrive le differenze tra lo storage standard e lo storage ottimizzato di Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/io-diagram-1.png)
## Creazione di un cluster ottimizzato per l'I/O
------
#### [ Using the Console di gestione AWS ]
Per creare o modificare un cluster ottimizzato per l'I/O utilizzando: Console di gestione AWS
1. **Nella console di gestione di Amazon DocumentDB, in **Clusters**, scegli **Crea** o seleziona il cluster e scegli **Azioni**, quindi scegli Modifica.**
1. Se stai creando un nuovo cluster, assicurati di scegliere **Instance Based Cluster** nella sezione **Tipo di cluster** (questa è l'opzione predefinita).
![\[Immagine: una schermata della console con le opzioni relative ai tipi di cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. Nella sezione **Configurazione**, in **Configurazione dello storage del cluster**, scegli **Amazon DocumentDB** I/O Optimized.
![\[Immagine: una schermata della console con le opzioni di configurazione dello storage del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/storage-config-1.png)
1. Completa la creazione o la modifica del cluster e scegli **Crea cluster** o **Modifica cluster**.
Per il processo completo di creazione del cluster, consulta[Creazione di un cluster e di un'istanza primaria utilizzando Console di gestione AWS](db-cluster-create.md#db-cluster-create-con).
Per il processo completo di modifica del cluster, vedere[Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Per creare un cluster ottimizzato per l'I/O utilizzando: AWS CLI
Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni.
Per Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Per Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Analisi dei costi per determinare la configurazione dello storage
Con Amazon DocumentDB, hai la flessibilità di scegliere la configurazione di storage per ogni cluster di database di cui disponi. Per allocare correttamente i cluster tra standard e ottimizzati per l'I/O, puoi monitorare i costi di Amazon DocumentDB per cluster. A tale scopo, puoi aggiungere tag ai cluster esistenti, abilitare l'etichettatura per l'allocazione dei costi nella [Gestione dei costi e fatturazione AWS dashboard](https://aws.amazon.com/pricing/) e analizzare i costi per un determinato cluster in. [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/) Per informazioni sull'analisi dei costi, consulta il nostro blog [Utilizzo dei tag di allocazione dei costi](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Determinazione dello stato di un cluster
È possibile determinare lo stato di un cluster utilizzando Console di gestione AWS o AWS CLI.
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per visualizzare lo stato del tuo cluster Amazon DocumentDB utilizzando il Console di gestione AWS
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 colonna **Cluster identifier (Identificatore cluster)** individua il nome del cluster desiderato. Quindi, per trovare lo stato del cluster, leggi la riga in corrispondenza della colonna **Status (Stato)**, come illustrato di seguito.
![\[Screenshot della pagina dei cluster con sample-cluster che mostra lo stato attivo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Usa l'`describe-db-clusters`operazione per visualizzare lo stato del tuo cluster Amazon DocumentDB utilizzando il. AWS CLI
Il codice seguente individua lo stato del cluster `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Ciclo di vita del cluster Amazon DocumentDB
Il ciclo di vita di un cluster Amazon DocumentDB include la creazione, la descrizione, la modifica e l'eliminazione del cluster. Questa sezione fornisce informazioni su come completare questi processi.
**Topics**
+ [Creazione di un cluster](db-cluster-create.md)
+ [Descrizione dei cluster](db-cluster-view-details.md)
+ [Modifica di un cluster](db-cluster-modify.md)
+ [Determinazione della manutenzione in sospeso](db-cluster-determine-pending-maintenance.md)
+ [Patch che aggiorna la versione del motore di un cluster](db-cluster-version-upgrade.md)
+ [Avvio e arresto di un cluster](db-cluster-stop-start.md)
+ [Eliminazione di un cluster](db-cluster-delete.md)
# Creazione di un cluster Amazon DocumentDB
Un cluster Amazon DocumentDB è composto da istanze e un volume di cluster che rappresenta i dati del cluster. Il volume cluster viene replicato in sei modi su tre zone di disponibilità come un unico volume virtuale. Il cluster contiene un'istanza primaria e, facoltativamente, fino a 15 istanze di replica.
Le seguenti sezioni mostrano come creare un cluster Amazon DocumentDB utilizzando il Console di gestione AWS o il. AWS CLI Puoi quindi aggiungere al cluster istanze di replica aggiuntive. Quando usi la console per creare il tuo cluster Amazon DocumentDB, contemporaneamente viene creata automaticamente un'istanza primaria per te. Se usi il AWS CLI per creare il tuo cluster Amazon DocumentDB, dopo che lo stato del cluster è *disponibile*, devi creare l'istanza principale per quel cluster.
## Prerequisiti
Di seguito sono riportati i prerequisiti per la creazione di un cluster Amazon DocumentDB.
Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno.
**Per iscriverti a un Account AWS**
1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup)
1. Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.
Quando ti iscrivi a un Account AWS, *Utente root dell'account AWS*viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Prerequisiti per VPC
Puoi creare un cluster Amazon DocumentDB solo in un Amazon Virtual Private Cloud (Amazon VPC). Il tuo Amazon VPC deve avere almeno una sottorete in ciascuna di almeno due zone di disponibilità per poterlo utilizzare con un cluster Amazon DocumentDB. Distribuendo le istanze del cluster tra le zone di disponibilità, ti assicuri che le istanze siano disponibili nel cluster nel caso improbabile di un errore nella zona di disponibilità.
### Prerequisiti per la sottorete
Quando crei un cluster Amazon DocumentDB, devi scegliere un VPC e il gruppo di sottoreti corrispondente all'interno di quel VPC per avviare il cluster. Le sottoreti determinano la zona di disponibilità e l'intervallo IP all'interno della zona di disponibilità che desideri utilizzare per avviare un'istanza. In questa documentazione i termini *sottorete* e *zona di disponibilità* saranno utilizzati indifferentemente. Un gruppo di sottoreti è un set di sottoreti denominato (o zone di disponibilità). Ciò che un gruppo di sottoreti consente di fare è specificare le zone di disponibilità che si desidera utilizzare per avviare le istanze di Amazon DocumentDB. Ad esempio, per avere alta disponibilità in un cluster con tre istanze, è consigliabile effettuare il provisioning di ciascuna di queste istanze in zone di disponibilità separate. In questo modo, se una singola zona di disponibilità non funziona, sarà interessata solo una singola istanza.
Le istanze di Amazon DocumentDB possono attualmente essere fornite in un massimo di tre zone di disponibilità. Anche se un gruppo di sottoreti ha più di tre sottoreti, puoi utilizzarne solo tre per creare un cluster Amazon DocumentDB. Di conseguenza, quando crei un gruppo di sottoreti, è consigliabile scegliere solo le tre sottoreti in cui desideri distribuire le tue istanze. Negli Stati Uniti orientali (Virginia settentrionale), un gruppo di sottoreti può avere sei sottoreti (o zone di disponibilità). Tuttavia, quando viene effettuato il provisioning di un cluster Amazon DocumentDB, Amazon DocumentDB sceglie tre di quelle zone di disponibilità che utilizza per il provisioning delle istanze.
Ad esempio, supponiamo che durante la creazione di un cluster, Amazon DocumentDB scelga le zone di disponibilità \$11A, 1B e 1C\$1. Se tenti di creare un'istanza nella zona di disponibilità \$11D\$1, la chiamata API non riesce. Tuttavia, se scegli di creare un'istanza senza specificare una particolare zona di disponibilità, Amazon DocumentDB sceglie una zona di disponibilità per tuo conto. Amazon DocumentDB utilizza un algoritmo per bilanciare il carico delle istanze tra le zone di disponibilità per aiutarti a raggiungere un'elevata disponibilità. Ad esempio, se viene effettuato il provisioning di tre istanze, per impostazione predefinita il provisioning viene effettuato nelle tre zone di disponibilità e non in una sola di esse.
**Raccomandazioni:**
+ A meno che non si abbia un motivo specifico, creare sempre un gruppo di sottoreti con tre sottoreti. In questo modo si assicura che i cluster con tre o più istanze possano ottenere una disponibilità più elevata in quanto ne verrà effettuato il provisioning su tre zone di disponibilità.
+ Distribuisci sempre le istanze in più zone di disponibilità per ottenere una disponibilità più elevata. Non posizionare mai tutte le istanze di un cluster in una singola zona di disponibilità.
+ Poiché gli eventi di failover possono verificarsi in qualsiasi momento, non devi presumere che un'istanza primaria o le istanze di replica siano sempre in una determinata zona di disponibilità.
### Prerequisiti aggiuntivi
Di seguito sono riportati alcuni prerequisiti aggiuntivi per la creazione di un cluster Amazon DocumentDB:
+ Se ti connetti AWS utilizzando credenziali AWS Identity and Access Management (IAM), il tuo account IAM deve disporre di politiche IAM che concedano le autorizzazioni necessarie per eseguire le operazioni di Amazon DocumentDB.
Se utilizzi un account IAM per accedere alla console Amazon DocumentDB, devi prima accedervi Console di gestione AWS con il tuo account IAM. [Quindi vai alla console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
+ Per personalizzare i parametri di configurazione per il cluster, devi specificare un gruppo di parametri del cluster e un gruppo di parametri con le impostazioni dei parametri richieste. Per informazioni sulla creazione o la modifica di un gruppo di parametri del cluster o un gruppo di parametri, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ È necessario determinare il numero di TCP/IP porta che si desidera specificare per il cluster. I firewall di alcune aziende bloccano le connessioni alle porte predefinite per Amazon DocumentDB. Se il firewall della tua azienda blocca la porta predefinita, scegli un'altra porta per il cluster. Tutte le istanze in un cluster utilizzano la stessa porta.
## Creazione di un cluster e di un'istanza primaria utilizzando Console di gestione AWS
Le seguenti procedure descrivono come utilizzare la console per avviare un cluster Amazon DocumentDB con una o più istanze.
### Creare un cluster: utilizzando le impostazioni predefinite
**Per creare un cluster con istanze utilizzando le impostazioni predefinite utilizzando il Console di gestione AWS**
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. Se desideri creare il cluster in una regione Regione AWS diversa da quella degli Stati Uniti orientali (Virginia settentrionale), scegli la regione dall'elenco nella sezione in alto a destra della console.
1. Nel riquadro di navigazione scegliere **Clusters (Cluster)**, quindi **Create (Crea)**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nella pagina **Crea cluster Amazon DocumentDB**, completa il riquadro **Configurazione**.
1. **Identificatore del cluster**: accetta il nome fornito da Amazon DocumentDB o immetti un nome per il cluster, ad esempio. **sample-cluster**
Vincoli per la denominazione del cluster:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
1. **Versione del motore: accetta la versione** predefinita del motore 5.0.0 o, facoltativamente, scegli 8.0.0, 4.0.0 o 3.6.0.
1. **Classe di istanza**: accettate l'impostazione predefinita o scegliete la classe di istanza `db.r5.large` desiderata dall'elenco.
1. **Numero di istanze**: nell'elenco, scegliete il numero di istanze che desiderate creare con questo cluster. La prima istanza è l'istanza primaria, tutte le altre sono istanze di replica di sola lettura. È possibile aggiungere ed eliminare le istanze in un secondo momento, se necessario. Per impostazione predefinita, un cluster Amazon DocumentDB viene avviato con tre istanze (una principale e due repliche).
1. Completa la sezione Configurazione dello storage del **cluster**.
Scegli tra **Amazon DocumentDB Standard** (impostazione predefinita) o **Amazon DocumentDB I/O Optimized**. Per ulteriori informazioni, consulta [Configurazioni di storage in cluster Amazon DocumentDB](db-cluster-storage-configs.md).
1. Compila il riquadro **Authentication (Autenticazione)**.
1. **Nome utente**: immetti un nome per l'utente principale. Per accedere al cluster, è necessario utilizzare il nome utente principale.
Vincoli principali di denominazione degli utenti:
+ La lunghezza è di [1-63] caratteri alfanumerici.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata del motore di database.
1. Scegli una delle seguenti opzioni di password:
+ **Gestito in Gestione dei segreti AWS**: scegli questa opzione se desideri Gestione dei segreti AWS gestire automaticamente la password dell'utente principale.
Se scegli questa opzione, configura la chiave KMS creandone una tua o usando una chiave creata da Secrets Manager.
+ **Gestione automatica**: scegli questa opzione se desideri gestire automaticamente la password dell'utente principale. Se scegli questa opzione, inserisci una password per l'utente principale, quindi confermala. Per accedere al cluster, è necessario utilizzare la password dell'utente principale.
Vincoli per la password:
+ La lunghezza è di [8-100] caratteri ASCII stampabili.
+ È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto i seguenti:
+ **/** (barra)
+ **"** (virgolette doppie)
+ **@** (simbolo chiocciola)
1. Nella parte inferiore della schermata, scegli uno dei seguenti:
+ Per creare subito il cluster, scegli **Create cluster (Crea cluster)**.
+ Per non creare il cluster, scegli **Cancel (Annulla)**.
+ Per configurare ulteriormente il cluster prima di crearlo, scegliere **Show additional configurations (Mostra configurazioni aggiuntive)**, quindi continuare in [Creare un cluster: configurazioni aggiuntive](#db-cluster-create-con-additional-configs).
Le configurazioni comprese nella sezione **Additional Configurations (Configurazioni aggiuntive)** sono:
+ **Impostazioni di rete**: l'impostazione predefinita prevede l'utilizzo del gruppo di `default` sicurezza VPC.
+ **Opzioni del cluster**: l'impostazione predefinita prevede l'utilizzo della porta 27017 e il gruppo di parametri predefinito.
+ **Crittografia**: l'impostazione predefinita è abilitare la crittografia utilizzando la chiave. `(default) aws/rds`
**Importante**
Una volta che un cluster è crittografato, non può essere decrittografato.
+ **Backup**: l'impostazione predefinita prevede di conservare i backup per 1 giorno e lasciare che Amazon DocumentDB scelga la finestra di backup.
+ **Esportazioni di log**: l'impostazione predefinita prevede di non esportare i log di controllo in Logs. CloudWatch
+ **Manutenzione**: l'impostazione predefinita prevede che Amazon DocumentDB scelga la finestra di manutenzione.
+ **Protezione dall'eliminazione**: protegge il cluster dall'eliminazione accidentale. L'impostazione predefinita per i cluster creati utilizzando la console è *abilitata*.
Se accetti le impostazioni predefinite ora, potrai modificare la maggior parte di esse successivamente modificando il cluster.
1. Abilita la connessione in entrata per il gruppo di sicurezza del cluster.
Se non sono state modificate le impostazioni predefinite per il cluster, questo è stato creato utilizzando il gruppo di sicurezza predefinito per il VPC predefinito nella regione selezionata. Per connetterti ad Amazon DocumentDB, devi abilitare le connessioni in entrata sulla porta 27017 (o sulla porta di tua scelta) per il gruppo di sicurezza del cluster.
**Per aggiungere una connessione in entrata al gruppo di sicurezza del cluster**
1. Accedi Console di gestione AWS e apri la console Amazon EC2 all'indirizzo. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Nella sezione **Resources (Risorse)** della finestra principale, selezionare **Security groups (Gruppi di sicurezza)**.
![\[Immagine: elenco delle risorse che evidenzia l'opzione di collegamento Security Groups.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Dall'elenco di gruppi di sicurezza, individuare il gruppo di sicurezza utilizzato quando si crea il cluster (è probabile che il gruppo di sicurezza *predefinito* ) e scegliere la casella a sinistra del nome del gruppo di sicurezza.
![\[Immagine: elenco dei gruppi di sicurezza che evidenzia un gruppo di sicurezza con la casella selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. Dal menu **Actions (Operazioni)** , scegliere **Edit inbound rules (Modifica regole in entrata)**, quindi scegliere o inserire i vincoli della regola.
1. **Tipo**: dall'elenco, scegli il protocollo da aprire al traffico di rete.
1. **Protocollo**: dall'elenco, scegli il tipo di protocollo.
1. **Intervallo di porte**: per una regola personalizzata, inserisci un numero di porta o un intervallo di porte. Assicurati che il numero di porta o l'intervallo includa la porta specificata quando hai creato il cluster (valore predefinito: 27017).
1. **Fonte**: specifica il traffico che può raggiungere l'istanza. Dall'elenco, scegliere l'origine del traffico. Se si sceglie **Custom (Personalizzata)**, specificare un solo indirizzo IP o un intervallo di indirizzi IP nella notazione CIDR (ad es., 203.0.113.5/32).
1. **Descrizione**: inserisci una descrizione per questa regola.
1. Dopo aver creato la regola, scegliere **Save (Salva)**.
### Creare un cluster: configurazioni aggiuntive
Se desideri accettare le impostazioni predefinite per il cluster, puoi ignorare le seguenti fasi e scegliere **Create cluster (Crea cluster)**.
1. Completa il riquadro **Network settings (Impostazioni di rete)**.
![\[Screenshot che mostra il riquadro delle impostazioni di rete e le fasi per la configurazione delle impostazioni di rete.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Virtual Private Cloud (VPC)**: nell'elenco, scegli l'Amazon VPC in cui desideri avviare questo cluster.
1. **Gruppo di sottoreti**: nell'elenco, scegli il gruppo di sottoreti che desideri utilizzare per questo cluster.
1. **Gruppi di sicurezza VPC**: nell'elenco, scegli il gruppo di sicurezza VPC per questo cluster.
1. Completa il riquadro **Cluster options (Opzioni cluster)**.
![\[Screenshot che mostra il riquadro delle opzioni cluster con le fasi per la configurazione delle impostazioni dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Porta del database**: utilizza le frecce su e giù per impostare la TCP/IP porta che le applicazioni utilizzeranno per connettersi all'istanza.
1. **Gruppo di parametri del cluster**: nell'elenco dei gruppi di parametri, scegli il gruppo di parametri del cluster per questo cluster.
1. Completa il riquadro **Encryption (Crittografia)**.
![\[Screenshot del riquadro di crittografia che mostra le fasi per la crittografia del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** —Scegliete una delle seguenti opzioni:
+ **Abilita crittografia: impostazione** predefinita. Tutti i dati inattivi vengono crittografati. Se scegli di crittografare i dati, non è possibile annullare questa operazione.
+ **Disattiva la crittografia**: i dati non sono crittografati.
1. **AWS Chiave KMS**: è disponibile solo se si crittografano i dati. Scegliere nell'elenco la chiave che si desidera utilizzare per crittografare i dati nel cluster. Il valore predefinito è `(default) aws/rds`.
Se si sceglie **Enter a key ARN (Immetti ARN chiave)**, è necessario immettere un Amazon Resource Name (ARN) per la chiave.
1. Completa il riquadro **Backup**.
![\[Screenshot del riquadro Backup che mostra le fasi per la configurazione della finestra di backup del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Periodo di conservazione dei backup**: nell'elenco, scegli il numero di giorni in cui conservare i backup automatici di questo cluster prima di eliminarli.
1. **Finestra di backup**: imposta l'ora e la durata giornaliere durante le quali Amazon DocumentDB deve effettuare i backup di questo cluster.
1. **Ora di inizio**: nel primo elenco, scegli l'ora di inizio (UTC) per avviare i backup automatici. Dal secondo elenco scegli il minuto dell'ora in cui desideri inizino i backup automatici.
1. **Durata**: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici.
1. Completa il riquadro **Esportazioni dei log** selezionando i tipi di log che desideri esportare in Logs. CloudWatch
![\[Screenshot del riquadro delle esportazioni di log che mostra le fasi per configurare il logging DML del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Registri di controllo**: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon Logs. CloudWatch Se selezioni **Audit logs (Log di audit)**, devi abilitare `audit_logs` nel gruppo personalizzato di parametri del cluster. Per ulteriori informazioni, consulta [Controllo degli eventi di Amazon DocumentDB](event-auditing.md).
+ **Registri del profiler: seleziona questa opzione per abilitare l'esportazione dei log del profiler operativo su Amazon Logs**. CloudWatch Se selezioni **Profiler logs (Log del profiler)**, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster:
+ `profiler``enabled`—Imposta su.
+ `profiler_threshold_ms`—Imposta su un valore `[0-INT_MAX]` per impostare la soglia per le operazioni di profilatura.
+ `profiler_sampling_rate`—Imposta su un valore `[0.0-1.0]` per impostare la percentuale di operazioni lente da profilare.
Per ulteriori informazioni, consulta [Profilazione delle operazioni di Amazon DocumentDB](profiling.md).
1. Compilare il riquadro **Maintenance (Manutenzione)**.
![\[Screenshot del riquadro Maintenance (Manutenzione) che mostra le fasi per la configurazione della finestra di manutenzione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Scegli una delle seguenti opzioni
+ **Seleziona finestra**: puoi specificare il giorno della settimana, l'ora di inizio UTC e la durata affinché Amazon DocumentDB esegua la manutenzione del cluster.
1. **Giorno di inizio**: nell'elenco, scegli il giorno della settimana in cui iniziare la manutenzione del cluster.
1. **Ora di inizio**: negli elenchi, scegli l'ora e il minuto (UTC) per avviare la manutenzione.
1. **Durata**: nell'elenco, scegli quanto tempo dedicare alla manutenzione del cluster. Se la manutenzione non può essere completata nel tempo specificato, il processo di manutenzione proseguirà oltre l'orario indicato fino al completamento.
+ **Nessuna preferenza**: Amazon DocumentDB sceglie il giorno della settimana, l'ora di inizio e la durata per eseguire la manutenzione.
1. Per aggiungere uno o più tag a questo cluster, completare il riquadro **Tags (Tag)**.
![\[Schermata del selettore dell'abilitazione della protezione, che è selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Per ogni tag che si desidera aggiungere al cluster, ripetere i seguenti passaggi. È possibile averne fino a 10 in un cluster.
1. Scegli **Aggiungi tag**.
1. Digita il tag **Key (Chiave)**.
1. Opzionalmente digita il **Value (Valore)** del tag.
Per rimuovere un tag, scegli **Remove (Rimuovi)**.
1. Quando si crea un cluster utilizzando la console, la **Deletion Protection (Protezione dall'eliminazione)** viene abilitata per impostazione predefinita. Per disabilitare la protezione dall'eliminazione, deseleziona **Enable deletion protection (Abilita la protezione dall'eliminazione)**. Quando abilitata, la protezione dall'eliminazione impedisce che un cluster venga eliminato. Per eliminare un cluster protetto dall'eliminazione, è necessario prima modificare il cluster per disabilitare la protezione dall'eliminazione.
![\[Schermata del selettore dell'abilitazione della protezione, che è selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
1. Per creare il cluster, scegli **Create cluster (Crea cluster)**. Altrimenti, scegli **Cancel** (Annulla).
## Creazione di un cluster utilizzando il AWS CLI
Le seguenti procedure descrivono come utilizzare AWS CLI per avviare un cluster Amazon DocumentDB e creare una replica Amazon DocumentDB.
**Parameters**
+ **--db-cluster-identifier**: obbligatorio. Una stringa di lettere minuscole che identifica il cluster.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**: obbligatorio. Deve essere **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**—Facoltativo. Quando è abilitata la protezione dall'eliminazione, questa impedisce che il cluster venga eliminato. Quando si utilizza la AWS CLI, l'impostazione predefinita prevede che la protezione da eliminazione sia disabilitata.
Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**—Facoltativo. Default: **standard**. La configurazione di archiviazione del cluster. I valori validi sono `standard` (Standard) o `iopt1` (ottimizzato per l'I/O).
+ **--master-username**: obbligatorio. Il nome utilizzato per autenticare l'utente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**—Facoltativo. La password utilizzata per autenticare l'utente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**—Facoltativo. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.
Per altri parametri, vedi [CreateDBCluster](API_CreateDBCluster.md).
**Per avviare un cluster Amazon DocumentDB utilizzando AWS CLI**
Per creare un cluster Amazon DocumentDB, chiama il. `create-db-cluster` AWS CLI Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato `sample-cluster` con la protezione da eliminazione abilitata. 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 in modo esplicito). Quando vengono rilasciate nuove versioni principali del motore, la versione del motore di default di viene aggiornata in `--engine-version` 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.
**Nota**
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.
Per Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Per Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
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": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.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": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La creazione del cluster richiede diversi minuti. Puoi usare Console di gestione AWS o AWS CLI per monitorare lo stato del tuo 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 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. È possibile 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).
Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html)*Amazon DocumentDB API* Reference.
# Descrizione dei cluster Amazon DocumentDB
Puoi utilizzare la Console di gestione Amazon DocumentDB o AWS CLI visualizzare dettagli come endpoint di connessione, gruppi di sicurezza e gruppi di parametri relativi ai tuoi cluster Amazon DocumentDB. VPCs
Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Individuazione degli endpoint di un cluster](db-cluster-endpoints-find.md)
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per visualizzare i dettagli di un cluster Amazon DocumentDB specificato utilizzando la console.
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nell'elenco dei cluster scegli il nome del cluster di cui desideri visualizzare i dettagli. Le informazioni sul cluster vengono organizzate nei seguenti gruppi:
+ **Riepilogo**: informazioni generali sul cluster, tra cui la versione del motore, lo stato del cluster, la manutenzione in corso e lo stato del relativo gruppo di parametri.
+ **Connettività e sicurezza**: la sezione **Connect** elenca gli endpoint di connessione per connettersi a questo cluster con la shell mongo o con un'applicazione. Nella sezione **Security Groups (Gruppi di sicurezza)** sono elencati i gruppi di protezione associati a questo cluster e l'ID VPC e le descrizioni.
+ **Configurazione**: la sezione dei **dettagli del cluster** elenca i dettagli sul cluster, inclusi l'Amazon Resource Name (ARN), l'endpoint e il gruppo di parametri del cluster. Vengono inoltre elencate le informazioni di backup del cluster, i dettagli di manutenzione e le impostazioni di sicurezza e di rete. La sezione **Cluster instances (Istanze del cluster)** elenca le istanze che appartengono a questo cluster con lo stato del ruolo e del gruppo di parametri del cluster di ogni istanza.
+ **Monitoraggio**: i parametri di Amazon CloudWatch Logs per questo cluster. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **Eventi e tag**: la sezione **Eventi recenti** elenca gli eventi recenti per questo cluster. Amazon DocumentDB registra gli eventi relativi a cluster, istanze, snapshot, gruppi di sicurezza e gruppi di parametri del cluster. Queste informazioni includono la data, l'ora e il messaggio associati a ciascun evento. La sezione **Tag** elenca i tag allegati al cluster.
------
#### [ Using the AWS CLI ]
Per visualizzare i dettagli dei tuoi cluster Amazon DocumentDB utilizzando il AWS CLI, usa il `describe-db-clusters` comando come mostrato negli esempi seguenti. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)*Amazon DocumentDB Resource Management API* Reference.
**Nota**
Per alcune funzionalità di gestione come la gestione del ciclo di vita di cluster e istanze, Amazon DocumentDB sfrutta la tecnologia operativa condivisa con Amazon RDS. Il parametro `filterName=engine,Values=docdb` filter restituisce solo cluster Amazon DocumentDB.
**Example**
**Esempio 1: elenca tutti i cluster Amazon DocumentDB**
Il AWS CLI codice seguente elenca i dettagli per tutti i cluster Amazon DocumentDB in una regione.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Esempio 2: elenca tutti i dettagli per un cluster Amazon DocumentDB specificato**
Il AWS CLI codice seguente elenca i dettagli del cluster`sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Esempio 3: elenca dettagli specifici per un cluster Amazon DocumentDB**
Per elencare un sottoinsieme dei dettagli dei cluster utilizzando il AWS CLI, aggiungi un elenco `--query` che specifichi quali membri del cluster l'`describe-db-clusters`operazione deve elencare. Il parametro `--db-cluster-identifier` è l'identificatore per il particolare cluster del quale desideri visualizzare i dettagli. *Per ulteriori informazioni sulle interrogazioni, consulta [Come filtrare l'output con l'`--query`opzione nella Guida per l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter)utente.AWS Command Line Interface *
L'esempio seguente elenca le istanze in un cluster Amazon DocumentDB.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Modifica di un cluster Amazon DocumentDB
Per modificare un cluster, il cluster deve essere nello stato *disponibile*. Non è possibile modificare un cluster arrestato. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi apportare le modifiche desiderate. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per modificare uno specifico cluster Amazon DocumentDB utilizzando la console.
**Come modificare un cluster 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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Specifica il cluster da modificare scegliendo il pulsante a sinistra del nome del cluster.
1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**.
1. Nel riquadro **Modify Cluster: cluster-name (Modifica cluster: cluster-name)** apporta le modifiche desiderate. È possibile modificare le seguenti aree:
+ **Specifiche del cluster**: nome, gruppi di sicurezza e gestione delle credenziali del cluster.
+ **Configurazione dello storage del cluster**: la modalità di archiviazione dei dati del cluster. Scegli tra la configurazione standard e quella ottimizzata per l'I/O.
+ **Opzioni del cluster**: la porta e il gruppo di parametri del cluster.
+ **Backup**: il periodo di conservazione dei backup e la finestra di backup del cluster.
+ **Esportazioni di log**: abilita o disabilita l'esportazione dei log di controllo o del profiler.
+ **Manutenzione**: imposta la finestra di manutenzione del cluster.
+ **Protezione dall'eliminazione**: abilita o disabilita la protezione da eliminazione sul cluster. Per impostazione predefinita, la protezione da eliminazione è abilitata.
1. Al termine, scegli **Continue (Continua)** per visualizzare un riepilogo delle modifiche.
1. Se accetti le modifiche, puoi scegliere **Modify cluster (Modifica cluster)** per modificare il cluster. In alternativa, puoi scegliere **Back (Indietro)** o **Cancel (Annulla)** per modificare o annullare le modifiche, rispettivamente.
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato *disponibile*. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Utilizzare l'operazione `modify-db-cluster` per modificare il cluster specificato utilizzando il comando AWS CLI. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html)*Amazon DocumentDB API* Reference.
**Parameters**
+ **--db-cluster-identifier**: obbligatorio. L'identificatore del cluster Amazon DocumentDB che intendi modificare.
+ **--backup-retention-period**—Facoltativo. Il numero di giorni durante i quali vengono conservati i backup automatici. I valori validi sono compresi tra 1 e 35.
+ **--storage-type**—Facoltativo. La configurazione di archiviazione del cluster. I valori validi sono `standard` (Standard) o `iopt1` (ottimizzato per l'I/O).
+ **--db-cluster-parameter-group-name**—Facoltativo. Il nome del gruppo di parametri del cluster da utilizzare per il cluster.
+ **--manage-master-user-password**—Facoltativo. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.
+ **--rotate-master-user-password**—Facoltativo. Secrets Manager genera una nuova versione segreta per il segreto esistente. La nuova versione del segreto contiene la nuova password dell'utente principale. Amazon DocumentDB modifica la password dell'utente principale per il cluster in modo che corrisponda alla password per la nuova versione segreta.
È necessario specificare l'**--apply-immediately**opzione quando si ruota la password principale.
+ **--master-user-password**—Facoltativo. La nuova password per l'utente principale del database.
Vincoli per la password:
+ La lunghezza è di [8—100] caratteri ASCII stampabili.
+ È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto i seguenti:
+ **/** (barra)
+ **"** (virgolette doppie)
+ **@** (simbolo chiocciola)
+ **--new-db-cluster-identifier**—Facoltativo. Il nuovo identificatore per il cluster quando un cluster viene rinominato. Questo valore è archiviato come stringa in caratteri minuscoli.
Vincoli per la denominazione
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS
+ **--preferred-backup-window**—Facoltativo. L'intervallo temporale giornaliero durante il quale vengono creati i backup automatici, in UTC.
+ Formato: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**—Facoltativo. L'intervallo temporale settimanale durante il quale può avvenire la manutenzione dei sistemi, in UTC.
+ Formato: `ddd:hh24:mm-ddd:hh24:mm`
+ Giorni validi: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` e `Sat`.
+ **--deletion-protection**o **--no-deletion-protection** —Facoltativo. Se la protezione dall'eliminazione deve essere abilitata su questo cluster. La protezione dall'eliminazione impedisce che un cluster venga accidentalmente eliminato finché il cluster non viene modificato per disabilitare la protezione dall'eliminazione. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--apply-immediately**o**--no-apply-immediately**: `--apply-immediately` da utilizzare per apportare immediatamente la modifica. Utilizzare `--no-apply-immediately` per apportare la modifica durante la finestra di manutenzione successiva del cluster.
**Example**
Il codice seguente cambia il periodo di retention dei backup per il cluster `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Per Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato *disponibile*. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
# Determinazione della manutenzione in sospeso
Puoi determinare se disponi della versione più recente del motore Amazon DocumentDB determinando se hai una manutenzione del cluster in sospeso.
------
#### [ Using the Console di gestione AWS ]
Puoi usare il Console di gestione AWS per determinare se un cluster ha una manutenzione in sospeso.
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Individuare la colonna **Maintenance (Manutenzione)** per determinare se un cluster è in attesa di manutenzione.
![\[Schermata della console che mostra il campo di manutenzione del cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**None (Nessuno)** indica che sul cluster è in esecuzione l'ultima versione del motore. **Available (Disponibile)** indica che il cluster è in attesa di manutenzione, il che potrebbe significare che è necessario l'aggiornamento del motore.
1. Se il cluster è in attesa di manutenzione, continuare con la procedura in [Esecuzione di un aggiornamento della patch alla versione del motore di un cluster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Puoi utilizzare il AWS CLI per determinare se un cluster dispone della versione più recente del motore utilizzando l'`describe-pending-maintenance-actions`operazione con i seguenti parametri.
**Parameters**
+ **--resource-identifier**—Facoltativo. L'ARN per la risorsa (cluster). Se questo parametro viene omesso, vengono elencate le operazioni di manutenzione in attesa per tutti i cluster.
+ **--region**—Facoltativo. L'endpoint della regione AWS in cui eseguire l'operazione, ad esempio `us-east-1`.
**Example**
Per Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Per Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Se il cluster è in attesa di manutenzione, continuare con la procedura in [Esecuzione di un aggiornamento della patch alla versione del motore di un cluster](db-cluster-version-upgrade.md).
------
# Esecuzione di un aggiornamento della patch alla versione del motore di un cluster
In questa sezione, spiegheremo come distribuire un aggiornamento di patch utilizzando Console di gestione AWS o il AWS CLI. Un aggiornamento patch è un aggiornamento all'interno della stessa versione del motore (ad esempio, l'aggiornamento di una versione del motore 3.6 a una versione più recente del motore 3.6). Puoi aggiornarlo immediatamente o durante la prossima finestra di manutenzione del cluster. Per determinare se il motore necessita di un aggiornamento, consulta[Determinazione della manutenzione in sospeso](db-cluster-determine-pending-maintenance.md). Tieni presente che quando applichi l'aggiornamento, il cluster subirà dei tempi di inattività.
**Nota**
Se stai cercando di eseguire l'aggiornamento da una versione principale del motore a un'altra, ad esempio dalla 3.6 alla 5.0, consulta una delle due versioni oppure[Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md). [Aggiornamento del cluster Amazon DocumentDB tramite AWS Database Migration Service](docdb-migration.versions.md) Un aggiornamento immediato della versione principale supporta solo docdb 5.0 come versione del motore di destinazione.
Esistono due requisiti di configurazione per ottenere gli ultimi aggiornamenti delle patch per la versione del motore di un cluster:
+ Lo stato del cluster deve essere *disponibile*.
+ Il cluster deve eseguire una versione precedente del motore.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente applica gli aggiornamenti delle patch alla versione del motore del cluster utilizzando la console. Hai la possibilità di eseguire l'aggiornamento immediatamente o durante la prossima finestra di manutenzione del cluster.
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**. Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera aggiornare. Lo stato del cluster deve essere *disponibile*.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nel menu **Actions (Operazioni)** scegliere una delle opzioni indicate di seguito. Queste opzioni di menu sono selezionabili solo se sul cluster scelto non è in esecuzione la versione più recente del motore.
![\[Immagine: azioni di aggiornamento di Amazon DocumentDB\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Aggiorna ora**: avvia immediatamente il processo di aggiornamento. Il cluster sarà temporaneamente offline durante l'aggiornamento alla versione più recente del motore.
+ **Aggiorna alla finestra successiva**: avvia il processo di aggiornamento durante la successiva finestra di manutenzione del cluster. Il cluster sarà temporaneamente offline durante l'aggiornamento del cluster alla versione più recente del motore.
1. Quando si apre la finestra di conferma, scegliere una delle seguenti opzioni:
+ **Aggiornamento**: per aggiornare il cluster alla versione più recente del motore in base alla pianificazione scelta nel passaggio precedente.
+ **Annulla**: per annullare l'aggiornamento del motore del cluster e continuare con la versione corrente del motore del cluster.
------
#### [ Using the AWS CLI ]
È possibile applicare gli aggiornamenti delle patch al cluster utilizzando l'`apply-pending-maintenance-action`operazione AWS CLI and con i seguenti parametri.
**Parameters**
+ **--resource-identifier**: obbligatorio. L'ARN del cluster Amazon DocumentDB che intendi aggiornare.
+ **--apply-action**: obbligatorio. Sono consentiti i seguenti valori. Per aggiornare la versione del motore di un cluster, utilizzare `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**: obbligatorio. Sono consentiti i seguenti valori.
+ `immediate`—Applica immediatamente l'azione di manutenzione.
+ `next-maintenance`—Applica l'azione di manutenzione durante la finestra di manutenzione successiva.
+ `undo-opt-in`—Annulla tutte le richieste di `next-maintenance` opt-in esistenti.
**Example**
La seguente patch di esempio aggiorna la versione del motore `sample-cluster` alla versione 4.0.0.
Per Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Per Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Arresto e avvio di un cluster Amazon DocumentDB
L'interruzione e l'avvio dei cluster Amazon DocumentDB può aiutarti a gestire i costi per gli ambienti di sviluppo e test. Invece di creare ed eliminare cluster e istanze ogni volta che usi Amazon DocumentDB, puoi interrompere temporaneamente tutte le istanze del cluster quando non sono necessarie. È quindi possibile avviarle nuovamente quando è necessario riprendere il testing.
**Topics**
+ [Panoramica dell'avvio e dell'arresto di un cluster.](#db-cluster-stop-start-overview)
+ [Operazioni che è possibile eseguire su un cluster interrotto](#db-cluster-stopped-operations)
## Panoramica dell'avvio e dell'arresto di un cluster.
Nei periodi in cui non è necessario un cluster Amazon DocumentDB, è possibile interrompere tutte le istanze in quel cluster contemporaneamente. È possibile avviare nuovamente il cluster ogni volta che è necessario utilizzarlo. L'avvio e l'arresto semplificano i processi di impostazione e rimozione dei cluster utilizzati per lo sviluppo, i test o attività analoghe che non richiedono una disponibilità continua. Puoi arrestare e avviare un cluster utilizzando il Console di gestione AWS o AWS CLI con una singola azione, indipendentemente dal numero di istanze nel cluster.
Quando il cluster viene arrestato, il volume di archiviazione associato al cluster rimane invariato. Vengono addebitati solo i costi per lo storage, gli snapshot manuali e lo storage di backup automatici all'interno della finestra di retention specificata. Non ti viene addebitato alcun costo per le ore di utilizzo delle istanze. Amazon DocumentDB avvia automaticamente il cluster dopo sette giorni in modo da non rimanere indietro rispetto agli aggiornamenti di manutenzione richiesti. Quando il cluster viene avviato dopo 7 giorni, avrà nuovamente inizio l'addebito relativo alle istanze del cluster. Mentre il cluster viene arrestato, non è possibile eseguire query sul volume di archiviazione perché l'esecuzione di query richiede che le istanze siano nello stato disponibile.
Quando un cluster Amazon DocumentDB viene arrestato, né il cluster né le relative istanze possono essere modificati in alcun modo. Ciò include l'aggiunta o la rimozione di istanze o l'eliminazione del cluster.
------
#### [ Using the Console di gestione AWS ]
La seguente procedura mostra come arrestare un cluster con una o più istanze in stato disponibile o avviare un cluster arrestato.
**Per arrestare o avviare un cluster 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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Quindi, nell'elenco dei cluster, scegliere il pulsante a sinistra del nome del cluster che si desidera arrestare o avviare.
1. Scegliere **Actions (Operazioni)** e quindi scegliere l'operazione che si desidera eseguire sul cluster.
+ Se si desidera arrestare il cluster e il cluster è disponibile:
1. Scegli **Stop (Arresta)**.
![\[Immagine: Arresto di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop.png)
Per evitare l'attivazione del meccanismo di failover, l'operazione di arresto interrompe prima le istanze di replica e poi l'istanza primaria.
1. Nella finestra di dialogo di conferma, confermare che si desidera arrestare il cluster scegliendo **Stop cluster (Arresta cluster)** oppure, per mantenere il cluster in esecuzione, scegliere **Cancel (Annulla)**.
![\[Immagine: Avviamento di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Se si desidera avviare il cluster e il cluster è arrestato, scegliere **Start (Avvia)**.
![\[Immagine: Avviamento di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Monitorare lo stato del cluster e delle relative istanze. Se si avvia il cluster, è possibile riprendere ad utilizzare il cluster quando il cluster e le relative istanze risultano *disponibili*. Per ulteriori informazioni, consulta [Determinazione dello stato di un cluster](db-cluster-status.md).
![\[Immagine: stato dei cluster in stato di arresto e avvio\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
I seguenti codici di esempio illustrano come arrestare un cluster con una o più istanze in stato disponibile o avviare un cluster arrestato.
Per arrestare un cluster con una o più istanze disponibili utilizzando il AWS CLI, usa l'operazione. `stop-db-cluster` Per avviare un cluster arrestato, utilizzare l'operazione `start-db-cluster`. Entrambe le operazioni consentono di utilizzare il parametro `--db-cluster-identifier`.
**Parametro:**
+ **--db-cluster-identifier**: obbligatorio. Il nome del cluster da arrestare o avviare.
**Example — Per arrestare un cluster utilizzando AWS CLI**
Il codice seguente arresta il cluster `sample-cluster`. Il cluster deve avere una o più istanze in stato disponibile.
Per Linux, macOS o Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Per avviare un cluster utilizzando il AWS CLI**
Il codice seguente avvia il cluster `sample-cluster`. Il cluster deve attualmente essere arrestato.
Per Linux, macOS o Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operazioni che è possibile eseguire su un cluster interrotto
Mentre un cluster Amazon DocumentDB è fermo, puoi eseguire un point-in-time ripristino in qualsiasi punto all'interno della finestra di conservazione dei backup automatizzata specificata. Per informazioni dettagliate su come eseguire un point-in-time ripristino, consulta[Ripristino in un determinato momento](backup_restore-point_in_time_recovery.md).
Non è possibile modificare la configurazione di un cluster Amazon DocumentDB o di nessuna delle sue istanze mentre il cluster è fermo. Inoltre, non è possibile aggiungere o rimuovere istanze di database dal cluster o eliminarlo se possiede ancora istanze di database associate. Devi avviare il cluster prima di eseguire questo tipo di operazioni amministrative.
Amazon DocumentDB applica qualsiasi manutenzione programmata al cluster interrotto solo dopo che è stato riavviato. Dopo sette giorni, Amazon DocumentDB avvia automaticamente un cluster interrotto in modo che non rimanga troppo indietro nello stato di manutenzione. Quando il cluster viene riavviato, avrà nuovamente inizio l'addebito relativo alle istanze del cluster.
Mentre un cluster è fermo, Amazon DocumentDB non esegue backup automatici né estende il periodo di conservazione dei backup.
# Eliminazione di un cluster Amazon DocumentDB
Puoi eliminare un cluster Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI Per eliminare un cluster, il cluster deve trovarsi nello stato *disponibile* e non deve avere alcuna istanza associata. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi eliminarlo. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
## Protezione da eliminazione
Per proteggere il cluster dall'eliminazione accidentale, è possibile abilitare la *protezione dall'eliminazione *. Quando si crea un cluster utilizzando la console, la protezione dall'eliminazione viene abilitata per impostazione predefinita. Tuttavia, la protezione dall'eliminazione è disabilitata per impostazione predefinita se si crea un cluster utilizzando la AWS CLI.
Amazon DocumentDB applica la protezione da eliminazione per un cluster indipendentemente dal fatto che l'operazione di eliminazione venga eseguita utilizzando la console o il. AWS CLI Se la protezione dall'eliminazione è abilitata, non puoi eliminare un cluster. Per eliminare un cluster con la protezione dall'eliminazione abilitata, devi modificare il cluster e disabilitare la protezione dall'eliminazione.
Quando si utilizza la console con la protezione dall'eliminazione abilitata su un cluster, non è possibile eliminare l'ultima istanza del cluster perché questa operazione elimina anche il cluster. È possibile eliminare l'ultima istanza di un cluster con protezione dall'eliminazione attiva utilizzando la AWS CLI. Il cluster, tuttavia, è ancora esistente e i dati sono conservati. È possibile accedere ai dati mediante la creazione di nuove istanze per il cluster. Per ulteriori informazioni sull'abilitazione e la disabilitazione della protezione dall'eliminazione, consulta:
+ [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md)
+ [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Console di gestione AWS ]
Per eliminare un cluster utilizzando la Console di gestione AWS, la protezione dall'eliminazione deve essere disabilitata.
**Per determinare se la protezione dall'eliminazione di un cluster è abilitata:**
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Tieni presente che nella casella di navigazione Clusters, la colonna **Cluster identifier mostra sia i cluster** che le istanze. Le istanze sono elencate sotto i cluster, in modo simile alla schermata seguente.
![\[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/clusters.png)
1. Scegliere il nome del cluster e selezionare la scheda **Configuration (Configurazione)** . Nella sezione **Cluster details (Dettagli cluster)** individuare l’opzione **Deletion protection (Protezione dall’eliminazione)**. Se la protezione dall'eliminazione è abilitata, modificare il cluster per disabilitarla. Per ulteriori informazioni sulla modifica di un cluster database, consultare [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
Dopo aver eliminato la **Deletion protection (Protezione dall'eliminazione)**, è possibile eliminare il cluster.
**Per eliminare un cluster:**
1. Nel pannello di navigazione scegliere **Cluster**.
1. Determina se il cluster ha delle istanze controllando la colonna **Identificatore del cluster** per le istanze elencate sotto di essa. Per eliminare un cluster, devi eliminare tutte le sue istanze. Per ulteriori informazioni, consulta [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md).
1. A seconda che il cluster disponga o meno di qualche istanza, eseguire una delle seguenti operazioni.
+ Se il cluster non dispone di istanze, selezionare il pulsante a sinistra del nome del cluster e scegliere **Actions (Operazioni)**. Dal menu a discesa, scegli **Delete (Elimina)**. Completare la finestra di dialogo **Delete (Elimina )** e quindi scegliere **Delete (Elimina)**.
+ Se il cluster dispone di una o più istanze, eseguire le operazioni descritte qui di seguito:
1. Nel pannello di navigazione scegliere **Cluster**.
1. Elimina ciascuna istanza del cluster selezionando la casella di controllo a sinistra del nome del cluster. Scegli **Actions (Operazioni)**, quindi **Delete (Elimina)**. Completare la finestra di dialogo **Delete (Elimina )** e quindi scegliere **Delete (Elimina)**.
Quando elimini l'ultima istanza, verrà eliminato anche il cluster. Per ulteriori informazioni sull'eliminazione delle istanze, consulta. [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md)
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Non puoi eliminare un cluster a cui sono associate delle istanze. Per determinare quali istanze sono associate al cluster, esegui il comando `describe-db-clusters` ed elimina tutte le istanze del cluster. Quindi, se necessario, disattiva la protezione dell'eliminazione nel cluster e, infine, elimina il cluster.
1. **In primo luogo, elimina tutte le istanze del cluster.**
Per determinare quali istanze eliminare, esegui il comando seguente.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Se il cluster da eliminare possiede delle istanze associate, elimina tali istanze prima di continuare.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **In secondo luogo, disabilita la protezione da eliminazione.**
L'utilizzo AWS CLI di per eliminare tutte le istanze di un cluster non elimina il cluster. È anche necessario eliminare il cluster, ma è possibile eseguire questa operazione solo se la protezione dall'eliminazione è disattivata.
Per determinare se la protezione dall'eliminazione per il cluster è attivata, eseguire il seguente comando.
**Suggerimento**
Per visualizzare lo stato di protezione dall'eliminazione di tutti i cluster Amazon DocumentDB, ometti il parametro. `--db-cluster-identifier`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster",
"true"
]
]
```
Se la protezione dall'eliminazione per il cluster è abilitata, modificare il cluster e disabilitare la protezione dall'eliminazione. Per disabilitare la protezione dall'eliminazione del cluster, utilizzare il seguente codice.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Infine, eliminare il cluster.**
Dopo la disattivazione della protezione dall'eliminazione, è possibile eliminare il cluster. Per eliminare un cluster, utilizzare l'operazione `delete-db-cluster` con i parametri elencati di seguito.
+ **--db-cluster-identifier**: obbligatorio. L'identificatore del cluster da eliminare.
+ **--final-db-snapshot-identifier**—Facoltativo. Se desideri uno snapshot finale, devi includere questo parametro con un nome per l'ultimo snapshot. È necessario includere `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
Vincoli per la denominazione
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS
+ **--skip-final-snapshot**—Facoltativo. Utilizzare questo parametro solo se non si desidera acquisire uno snapshot finale prima di eliminare il cluster. L'impostazione predefinita prevede l'acquisizione di uno snapshot finale È necessario includere `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
Il AWS CLI codice seguente elimina il cluster `sample-cluster` con un'istantanea finale. L'operazione ha esito negativo se vi sono istanze associate al cluster o se è abilitata la protezione dall'eliminazione.
**Example**
Per Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Per Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
Il AWS CLI codice seguente elimina il cluster `sample-cluster` senza scattare un'istantanea finale.
Per Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Per Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
L'output dell'operazione `delete-db-cluster` è il cluster che stai eliminando.
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster](monitoring_docdb-cluster_status.md).
------
# Scalabilità dei cluster Amazon DocumentDB
Amazon DocumentDB ti consente di scalare lo storage e l'elaborazione nei cluster in base alle tue esigenze. Questa sezione descrive come utilizzare la scalabilità dello storage, la scalabilità delle istanze e la scalabilità della lettura per gestire le prestazioni e la scalabilità per i cluster e le istanze di Amazon DocumentDB.
**Topics**
+ [Dimensionamento dello storage](#db-cluster-manage-scaling-storage)
+ [Dimensionamento delle istanze](#db-cluster-manage-scaling-instance)
+ [Dimensionamento della lettura](#db-cluster-manage-scaling-reads)
+ [Ridimensionamento della scrittura](#db-cluster-manage-scaling-writes)
## Dimensionamento dello storage
Lo storage Amazon DocumentDB si ridimensiona automaticamente in base ai dati nel volume del cluster. Man mano che i dati crescono, lo storage del volume del cluster cresce con incrementi di 10 GiB, fino a 128 TiB.
## Dimensionamento delle istanze
Puoi scalare il tuo cluster Amazon DocumentDB secondo necessità modificando la classe di istanza per ogni istanza del cluster. Amazon DocumentDB supporta diverse classi di istanze ottimizzate per Amazon DocumentDB.
Per ulteriori informazioni, consulta [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md).
## Dimensionamento della lettura
Puoi ottenere la scalabilità di lettura per il tuo cluster Amazon DocumentDB creando fino a 15 repliche Amazon DocumentDB nel cluster. Ogni replica di Amazon DocumentDB restituisce gli stessi dati dal volume del cluster con un ritardo di replica minimo, in genere meno di 100 millisecondi dopo che l'istanza principale ha scritto un aggiornamento. Man mano che il traffico di lettura aumenta, puoi creare repliche di Amazon DocumentDB aggiuntive e connetterti direttamente ad esse per distribuire il carico di lettura per il tuo cluster. Le repliche di Amazon DocumentDB non devono necessariamente appartenere alla stessa classe di istanza dell'istanza principale.
Per ulteriori informazioni, consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md).
Per leggere in scala con Amazon DocumentDB, ti consigliamo di connetterti al cluster come set di repliche e di distribuire le letture sulle istanze di replica utilizzando le funzionalità di preferenza di lettura integrate del driver. Per ulteriori informazioni, consulta [Connessione ad Amazon DocumentDB come set di repliche](connect-to-replica-set.md).
## Ridimensionamento della scrittura
Puoi scalare la capacità di scrittura sul tuo cluster Amazon DocumentDB aumentando le dimensioni dell'istanza principale del cluster. Questa sezione fornisce due metodi per dimensionare l'istanza primaria del cluster in base alle proprie esigenze. La prima opzione mira a ridurre al minimo l'impatto sulle applicazioni, ma richiede più passaggi per essere completata. La seconda opzione ottimizza la semplicità in quanto ha meno fasi, ma ha un impatto potenziale maggiore sull'applicazione.
A seconda dell'applicazione, è possibile scegliere l'approccio più adatto alle proprie esigenze. Per ulteriori informazioni sulle dimensioni e sui costi delle istanze disponibili, consulta la pagina dei [prezzi di Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
1. **Ottimizza per garantire disponibilità e prestazioni elevate**: se ti connetti al cluster in [modalità set di repliche](connect-to-replica-set.md) (consigliata), puoi utilizzare il seguente processo per ridurre al minimo l'impatto sull'applicazione durante il ridimensionamento dell'istanza primaria. Questo metodo riduce al minimo l'impatto perché mantiene il cluster pari o superiore all'elevata disponibilità e le destinazioni di dimensionamento in lettura vengono aggiunte al cluster come istanze, anziché essere aggiornate.
1. Aggiunta di una o più repliche del tipo di istanza più grande al cluster (consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md)). È consigliabile che tutte le repliche siano dello stesso tipo o di dimensioni maggiori dell'istanza primaria. Ciò evita il fileover di una riduzione involontaria delle prestazioni di scrittura su un tipo di istanza più piccolo. Per la maggior parte dei clienti, ciò significa raddoppiare temporaneamente il numero di istanze nel cluster, quindi la rimozione delle repliche più piccole al termine del dimensionamento.
1. Impostare il livello di failover su tutte le nuove repliche su priorità zero, assicurando che una replica del tipo di istanza più piccolo abbia la priorità di failover più alta. Per ulteriori informazioni, consulta [Controllo della destinazione del failover](failover.md#failover-target_control).
1. Avviare un failover manuale, che promuoverà una delle nuove repliche come istanza primaria. Per ulteriori informazioni, consulta [Verifica del Failover](failover.md#failover-testing).
**Nota**
Ciò comporterà circa 30 secondi di tempo di inattività per il cluster. Pianificare le attività di conseguenza.
1. Rimuovere tutte le repliche di un tipo di istanza di dimensioni inferiori alla nuova istanza primaria dal cluster.
1. Reimpostare il livello di failover di tutte le istanze sulla stessa priorità (in genere, ciò significa impostarle nuovamente su 1).
Supponiamo, ad esempio, di disporre di un cluster che attualmente contiene tre istanze `r5.large` (una primaria e due repliche) e di voler dimensionare su un tipo di istanza `r5.xlarge`. A tale scopo, è necessario innanzitutto aggiungere al cluster tre istanze di replica `r5.xlarge` e quindi impostare il livello di failover delle nuove repliche `r5.xlarge` su zero. Successivamente, è necessario avviare un failover manuale (tenendo conto che l'applicazione avrà circa 30 secondi di inattività). Una volta completato il failover, è necessario rimuovere dal cluster tutte e tre le istanze `r5.large`, lasciando il cluster dimensionato sulle istanze `r5.xlarge`.
Per aiutare a ottimizzare i costi, le istanze di Amazon DocumentDB vengono fatturate in incrementi di un secondo, con un addebito minimo di dieci minuti a seguito di una modifica dello stato fatturabile, come la creazione, la modifica o l'eliminazione di un'istanza. Per ulteriori informazioni, consulta [Ottimizzazione dei costi](best_practices.md#best_practices-cost_optimization) nella documentazione relativa alle best practice.
1. **Ottimizza per la semplicità: questo approccio ottimizza per la semplicità**. Non espande e contrae il cluster, ma potrebbe ridurre temporaneamente la capacità di lettura.
È possibile che la modifica della classe di istanza di una replica impedisca all'istanza di soddisfare le richieste per un breve periodo di tempo, da pochi secondi a meno di 30 secondi. Se ci si connette al cluster in [modalità set di repliche](connect-to-replica-set.md) (consigliata), ciò ridurrebbe la capacità di lettura di una replica (ad esempio, al 66% della capacità in un cluster a 3 nodi o al 75% della capacità in un cluster a 4 nodi, ecc.) durante l'operazione di scalabilità.
1. Scalate una delle istanze di replica del cluster. Per ulteriori informazioni, consulta [Gestione delle classi di istanze](db-instance-classes.md).
1. Attendi che l'istanza sia disponibile (vedi[Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md)).
**Nota**
Ciò comporterà circa 30 secondi di tempo di inattività per il cluster. Pianificare le attività di conseguenza.
1. Continuate a eseguire i passaggi 1 e 2 fino a scalare tutte le istanze di replica, una per una.
1. Avvia un failover manuale. Ciò promuoverà una delle repliche a diventare l'istanza principale. Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
**Nota**
Ciò comporterà fino a 30 secondi di inattività per il cluster, ma spesso richiede meno tempo. Pianificare le attività di conseguenza.
1. Ridimensiona la precedente istanza primaria (ora una replica).
# Clonazione di un volume per un cluster Amazon DocumentDB
Utilizzando la clonazione di Amazon DocumentDB, puoi creare un nuovo cluster che utilizza lo stesso volume del cluster Amazon DocumentDB e contiene gli stessi dati dell'originale. Il processo è progettato per essere veloce e conveniente. Il nuovo cluster con il relativo volume di dati associato è noto come *clone*. La creazione di un clone è più veloce ed efficiente in termini di spazio rispetto alla copia fisica dei dati utilizzando una tecnica diversa, ad esempio con il ripristino di uno snapshot.
Amazon DocumentDB supporta la creazione di un clone con provisioning di Amazon DocumentDB da un cluster Amazon DocumentDB fornito. Quando crei un clone utilizzando una configurazione di distribuzione diversa da quella di origine, il clone viene creato utilizzando la versione più recente del motore Amazon DocumentDB del codice sorgente.
Quando crei cloni dai tuoi cluster Amazon DocumentDB, i cloni vengono creati nel AWS tuo account, lo stesso account che possiede il cluster Amazon DocumentDB di origine.
**Topics**
+ [Panoramica della clonazione di Amazon DocumentDB](#db-cloning-overview)
+ [Limitazioni della clonazione di Amazon DocumentDB](#db-cloning-limitations)
+ [Come funziona la clonazione di Amazon DocumentDB](#db-how-db-cloning-works)
+ [Creazione di un clone di Amazon DocumentDB](#db-creating-db-clone)
## Panoramica della clonazione di Amazon DocumentDB
Amazon DocumentDB utilizza un *copy-on-write protocollo* per creare un clone. Questo meccanismo utilizza uno spazio aggiuntivo minimo per creare un clone iniziale. Quando il clone viene creato per la prima volta, Amazon DocumentDB conserva una singola copia dei dati utilizzati dal cluster DB di origine e dal nuovo cluster Amazon DocumentDB (clonato). Lo storage aggiuntivo viene allocato solo quando vengono apportate modifiche ai dati (sul volume di storage Amazon DocumentDB) dal cluster Amazon DocumentDB di origine o dal clone del cluster Amazon DocumentDB. Per ulteriori informazioni sul protocollo, consulta. copy-on-write [Come funziona la clonazione di Amazon DocumentDB](#db-how-db-cloning-works)
La clonazione di Amazon DocumentDB è particolarmente utile per configurare rapidamente ambienti di test utilizzando i dati di produzione, senza rischiare il danneggiamento dei dati. È possibile utilizzare i cloni per molti tipi di applicazioni di breve durata, ad esempio:
+ Sperimenta potenziali cambiamenti (modifiche allo schema e modifiche ai gruppi di parametri, ad esempio) per valutare tutti gli impatti.
+ Esegui operazioni che utilizzano in modo intensivo i carichi di lavoro, come l'esportazione di dati o l'esecuzione di query analitiche sul clone.
+ Creare una copia del cluster database di produzione per lo sviluppo, il test o altri scopi.
Puoi creare più di un clone dallo stesso cluster Amazon DocumentDB. È anche possibile creare più cloni da un altro clone.
Dopo aver creato un clone di Amazon DocumentDB, puoi configurare le istanze di Amazon DocumentDB in modo diverso dal cluster Amazon DocumentDB di origine. Ad esempio, potrebbe non essere necessario un clone per scopi di sviluppo per soddisfare gli stessi requisiti di alta disponibilità del cluster Amazon DocumentDB di produzione di origine. In questo caso, puoi configurare il clone con una singola istanza di Amazon DocumentDB anziché con più istanze DB utilizzate dal cluster Amazon DocumentDB.
Una volta terminato di utilizzare il clone per test, sviluppo o altri scopi, è possibile eliminarlo.
## Limitazioni della clonazione di Amazon DocumentDB
Amazon DocumentDB; la clonazione presenta attualmente le seguenti limitazioni:
+ Puoi creare tutti i cloni che desideri, fino al numero massimo di cluster database consentito nella Regione AWS. Tuttavia, dopo aver creato 15 cloni, il clone successivo è una copia completa. L'operazione di clonazione funziona come un ripristino. point-in-time
+ Non è possibile creare un clone in una AWS regione diversa dal cluster Amazon DocumentDB di origine.
+ Non è possibile creare un clone da un cluster Amazon DocumentDB senza istanze DB. Puoi clonare solo cluster Amazon DocumentDB che hanno almeno un'istanza DB.
+ Puoi creare un clone in un cloud privato virtuale (VPC) diverso da quello del cluster Amazon DocumentDB. In tal caso, le sottoreti del sistema VPCs devono essere mappate alle stesse zone di disponibilità.
## Come funziona la clonazione di Amazon DocumentDB
La clonazione di Amazon DocumentDB funziona a livello di storage di un cluster Amazon DocumentDB. Utilizza un *copy-on-write*protocollo rapido ed efficiente in termini di supporti durevoli sottostanti che supportano il volume di storage Amazon DocumentDB. Puoi saperne di più sui volumi del cluster Amazon DocumentDB in. [Gestione dei cluster Amazon DocumentDB](db-clusters.md)
**Topics**
+ [Comprendere il protocollo copy-on-write](#db-copy-on-write-protocol)
+ [Eliminazione di un volume cluster di origine](#db-deleting-source-cluster-volume)
### Comprendere il protocollo copy-on-write
Un cluster Amazon DocumentDB archivia i dati in pagine nel volume di storage Amazon DocumentDB sottostante.
Ad esempio, nel diagramma seguente puoi trovare un cluster Amazon DocumentDB (A) con quattro pagine di dati, 1, 2, 3 e 4. Immagina che un clone, B, venga creato dal cluster Amazon DocumentDB. Quando viene creato il clone, non viene copiato alcun dato. Piuttosto, il clone punta allo stesso set di pagine del cluster Amazon DocumentDB di origine.
![\[Volume del cluster Amazon DocumentDB con 4 pagine per cluster di origine, A, e clone, B\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Quando viene creato il clone, in genere non è necessario alcuno spazio di archiviazione aggiuntivo. Il copy-on-write protocollo utilizza lo stesso segmento sul supporto di archiviazione fisico del segmento di origine. Lo spazio di archiviazione aggiuntivo è necessario solo se la capacità del segmento di origine non è sufficiente per l'intero segmento di clone. In questo caso, il segmento di origine viene copiato su un altro dispositivo fisico.
Nei diagrammi seguenti, è possibile trovare un esempio del copy-on-write protocollo in azione che utilizza lo stesso cluster A e il suo clone, B, come mostrato in precedenza. Supponiamo che tu apporti una modifica al tuo cluster Amazon DocumentDB (A) che comporti una modifica ai dati contenuti nella pagina 1. Invece di scrivere sulla pagina 1 originale, Amazon DocumentDB crea una nuova pagina 1 [A]. Il volume del cluster Amazon DocumentDB per cluster (A) ora punta alle pagine 1 [A], 2, 3 e 4, mentre il clone (B) fa ancora riferimento alle pagine originali.
![\[Volume del cluster DB di origine di Amazon DocumentDB e relativo clone, entrambi con modifiche.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
Sul clone, viene apportata una modifica a pagina 4 sul volume di archiviazione. Invece di scrivere sulla pagina 4 originale, Amazon DocumentDB crea una nuova pagina, 4 [B]. Il clone punta ora alle pagine 1, 2, 3 e alla pagina 4[B], mentre il cluster (A) continua a puntare a 1[A], 2, 3 e 4.
![\[Volume del cluster DB di origine di Amazon DocumentDB e relativo clone, entrambi con modifiche.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
Man mano che nel tempo si verificano più modifiche sia nel volume del cluster Amazon DocumentDB di origine che nel clone, è necessario più storage per acquisire e archiviare le modifiche.
### Eliminazione di un volume cluster di origine
Quando si elimina un volume cluster di origine a cui sono associati uno o più cloni, i cloni non sono interessati. I database clone continuano a rimandare alle pagine precedentemente di proprietà del volume del cluster di origine.
## Creazione di un clone di Amazon DocumentDB
Puoi creare un clone nello stesso AWS account del cluster Amazon DocumentDB di origine. A tale scopo, è possibile utilizzare Console di gestione AWS o AWS CLI le procedure seguenti.
Utilizzando la clonazione di Amazon DocumentDB, puoi creare un clone di cluster Amazon DocumentDB fornito da un cluster Amazon DocumentDB fornito.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente descrive come clonare un cluster Amazon DocumentDB utilizzando. Console di gestione AWS
Creazione di un clone utilizzando i Console di gestione AWS risultati in un cluster Amazon DocumentDB con un'istanza Amazon DocumentDB.
Queste istruzioni si applicano ai cluster DB di proprietà dello stesso AWS account che sta creando il clone. Il cluster DB deve appartenere allo stesso AWS account poiché la clonazione tra account non è supportata in Amazon DocumentDB.
**Per creare un clone di un cluster DB di proprietà del tuo account, utilizza il AWS Console di gestione AWS**
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. Scegli il tuo cluster Amazon DocumentDB dall'elenco e, per **Azioni**, scegli **Crea** clone.
![\[La creazione di un clone inizia selezionando il cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Viene visualizzata la pagina Crea clone, in cui è possibile configurare un **identificatore di cluster** e una **classe di istanza** e altre opzioni per il clone del cluster Amazon DocumentDB.
1. Nella sezione **Rule settings (Impostazioni regole)**, procedi nel seguente modo:
1. Per l'**identificatore del cluster**, inserisci il nome che desideri assegnare al cluster Amazon DocumentDB clonato.
1. Per la **configurazione dell'istanza**, seleziona una **classe di istanza** appropriata per il cluster Amazon DocumentDB clonato.
![\[La creazione di un clone inizia selezionando il cluster Amazon DocumentDB e specificando la dimensione dell'istanza DB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Per **le impostazioni di rete**, scegli un **gruppo di sottoreti** per il tuo caso d'uso e i gruppi di sicurezza VPC associati.
1. Per **E ncryption-at-rest**, se il cluster di origine (il cluster che viene clonato) ha la crittografia abilitata, anche il cluster clonato deve avere la crittografia abilitata. **Se questo scenario è vero, le opzioni **Abilita crittografia** sono disattivate (disattivate) ma con l'opzione Abilita crittografia selezionata.** Al contrario, se il cluster di origine non ha la crittografia abilitata, sono disponibili le opzioni **Abilita crittografia** ed è possibile scegliere di abilitare o disabilitare la crittografia.
![\[Specificate le impostazioni di rete e crittografia per il clone del cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Completa la nuova configurazione del clone del cluster selezionando il tipo di log da esportare (opzionale), inserendo una porta specifica utilizzata per la connessione al cluster e attivando la protezione dall'eliminazione accidentale del cluster (abilitata per impostazione predefinita).
![\[Completa la nuova configurazione dei cloni selezionando facoltativamente il tipo di log da esportare, una porta specifica utilizzata per connettersi al cluster e il modulo di protezione che elimina accidentalmente il cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Completa l'immissione di tutte le impostazioni per il clone del cluster Amazon DocumentDB. Per ulteriori informazioni sulle impostazioni di cluster e istanze di Amazon DocumentDB, consulta. [Gestione dei cluster Amazon DocumentDB](db-clusters.md)
1. Scegli **Crea clone** per avviare il clone Amazon DocumentDB del cluster Amazon DocumentDB scelto.
Quando il clone viene creato, viene elencato con gli altri cluster Amazon DocumentDB nella sezione Databases della **console** e mostra il suo stato corrente. Il clone è pronto per l'utilizzo quando lo stato diventa **Disponibile**.
------
#### [ Using the AWS CLI ]
L'utilizzo di AWS CLI per la clonazione del cluster Amazon DocumentDB richiede un paio di passaggi.
Il `restore-db-cluster-to-point-in-time` AWS CLI comando utilizzato genera un cluster Amazon DocumentDB vuoto con 0 istanze Amazon DocumentDB. Cioè, il comando ripristina solo il cluster Amazon DocumentDB, non le istanze DB per quel cluster. Sarà possibile farlo separatamente una volta che il clone è disponibile. Le due fasi del processo sono descritte di seguito:
1. Crea il clone utilizzando il comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. I parametri utilizzati con questo comando controllano il tipo di capacità e altri dettagli del cluster Amazon DocumentDB vuoto (clone) che viene creato.
1. Crea l'istanza Amazon DocumentDB per il clone utilizzando il comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI per ricreare l'istanza Amazon DocumentDB nel cluster Amazon DocumentDB ripristinato.
I comandi seguenti presuppongono che AWS CLI sia impostato con la tua regione come impostazione predefinita. AWS Questo approccio ti evita di dover inviare il nome `--region` in ciascuno dei comandi. Per ulteriori informazioni, consultare la pagina relativa alla [configurazione di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). È anche possibile specificare la `--region` in ciascuno dei comandi della CLI che seguono.
**Topics**
**Creare il clone**
I parametri specifici che vengono inviati al comando della CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` variano. Ciò che passi dipende dal tipo di clone che desideri creare.
Utilizza la seguente procedura per creare un clone Amazon DocumentDB fornito da un cluster Amazon DocumentDB fornito.
**Per creare un clone della stessa modalità motore del cluster Amazon DocumentDB di origine**
+ Utilizzare il comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` della CLI e specificare i valori per i seguenti parametri:
+ `--db-cluster-identifier`: scegliere un nome significativo per il clone. Assegnate un nome al clone quando utilizzate il comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI.
+ `--restore-type`: utilizza `copy-on-write` per creare un clone del cluster database di origine. Senza questo parametro, `restore-db-cluster-to-point-in-time` ripristina il cluster Amazon DocumentDB anziché creare un clone. L'impostazione predefinita per è. `restore-type` `full-copy`
+ `--source-db-cluster-identifier`— Usa il nome del cluster Amazon DocumentDB di origine che desideri clonare.
+ `--use-latest-restorable-time`: questo valore punta ai dati del volume ripristinabile più recenti per il clone. Questo parametro è obbligatorio`restore-type copy-on-write`, tuttavia, non è possibile utilizzarlo `restore-to-time parameter` con esso.
Nell'esempio seguente viene creato un clone denominato `my-clone` da un cluster denominato `my-source-cluster`.
Per Linux, macOS o Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Per Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
Il comando restituisce l'oggetto JSON contenente i dettagli del clone. Prima di provare a creare l'istanza database per il clone, verificare che il cluster database clonato sia disponibile. Per ulteriori informazioni, consulta Verifica dello stato e acquisizione dei dettagli del clone di seguito:
**Verifica dello stato e ottenimento dei dettagli del clone**
È possibile utilizzare il seguente comando per controllare lo stato del cluster database vuoto appena creato.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Oppure puoi ottenere lo stato e gli altri valori necessari per creare l'istanza DB per il tuo clone utilizzando la seguente query: AWS CLI
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Per Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Questa query restituisce un output simile al seguente:
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Creazione dell'istanza Amazon DocumentDB per il tuo clone**
Usa il comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI per creare l'istanza DB per il tuo clone.
Il `--db-instance-class` parametro viene utilizzato solo per i cluster Amazon DocumentDB forniti.
Per Linux, macOS o Unix:
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Per Windows:
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Parametri da utilizzare per la clonazione**
La tabella seguente riassume i vari parametri utilizzati per `restore-db-cluster-to-point-in-time` clonare i cluster Amazon DocumentDB.
| Parametro | Description |
| --- | --- |
| --source-db-cluster-identifier | Usa il nome del cluster Amazon DocumentDB di origine che desideri clonare. |
| --db-cluster-identifier | Scegliere un nome significativo per il clone. È possibile assegnare un nome al clone con il comando ` restore-db-cluster-to-point-in-time`. Quindi questo nome viene inviato al comando `create-db-instance`. |
| --restore-type | `--restore-type`Specificare `copy-on-write` come creare un clone del cluster DB di origine anziché ripristinare il cluster Amazon DocumentDB di origine. |
| --use-latest-restorable-time | Questo valore punta ai dati del volume ripristinabile più recenti per il clone. |
------
# Comprendere la tolleranza agli errori del cluster Amazon DocumentDB
I cluster Amazon DocumentDB sono progettati per essere tolleranti ai guasti. Ogni volume di cluster si estende su più zone di disponibilità in un'unica Regione AWS zona e ogni zona di disponibilità contiene una copia dei dati del volume del cluster. Questa funzionalità consente al cluster di tollerare il guasto di una zona di disponibilità senza perdita di dati e con solo una breve interruzione del servizio.
Se l'istanza primaria di un cluster si guasta, Amazon DocumentDB esegue automaticamente un failover su una nuova istanza primaria in due modi:
+ Promuovendo una replica Amazon DocumentDB esistente sulla nuova istanza principale scelta in base all'impostazione del livello di promozione di ciascuna replica e quindi creando una replica sostitutiva per la precedente principale. Un failover sull'istanza di replica richiede in genere meno di 30 secondi. Le operazioni di lettura e scrittura potrebbero subire brevi interruzioni durante questo periodo. Per aumentare la disponibilità del cluster, ti consigliamo di creare almeno una o più repliche di Amazon DocumentDB in due o più zone di disponibilità diverse.
+ Creando una nuova istanza primaria. Ciò accade solo se non hai un'istanza di replica nel cluster e il completamento può richiedere alcuni minuti.
Se il cluster dispone di una o più repliche di Amazon DocumentDB, una replica di Amazon DocumentDB viene promossa all'istanza principale durante un evento di errore. Un evento di errore ha come conseguenza una breve interruzione, durante la quale le operazioni di lettura e scrittura inviate all'istanza primaria falliscono con un'eccezione. Tuttavia, il servizio viene in genere ripristinato in meno di 120 secondi e spesso in meno di 60 secondi. Per aumentare la disponibilità del cluster, ti consigliamo di creare almeno una o più repliche di Amazon DocumentDB in due o più zone di disponibilità diverse.
È possibile personalizzare l'ordine in cui le repliche di Amazon DocumentDB vengono promosse all'istanza principale dopo un errore assegnando a ciascuna replica una priorità. Le priorità vanno da 0, quella massima, a 15, quella minima. Se l'istanza primaria fallisce, la replica di Amazon DocumentDB con la priorità più alta viene promossa alla nuova istanza primaria. Puoi modificare la priorità di una replica di Amazon DocumentDB in qualsiasi momento. Modificando una priorità non attiverai un failover. Puoi utilizzare l'operazione `modify-db-instance` con il parametro `--promotion-tier`. Per ulteriori informazioni sulla personalizzazione della priorità di failover di un'istanza, consulta [Failover di Amazon DocumentDB](failover.md).
Più di una replica di Amazon DocumentDB può condividere la stessa priorità, con conseguenti livelli di promozione. Se due o più repliche di Amazon DocumentDB condividono la stessa priorità, la replica di dimensioni maggiori viene promossa a principale. Se due o più repliche di Amazon DocumentDB condividono la stessa priorità e dimensione, viene promossa una replica arbitraria nello stesso livello di promozione.
Se il cluster non contiene repliche di Amazon DocumentDB, l'istanza principale viene ricreata durante un evento di errore. Un evento di errore ha come conseguenza un'interruzione, durante la quale le operazioni di lettura e scrittura falliscono con un'eccezione. Il servizio viene ripristinato quando crei la nuova istanza primaria. In genere, ciò richiede meno di 10 minuti. La promozione di una replica di Amazon DocumentDB sull'istanza principale è molto più rapida rispetto alla creazione di una nuova istanza primaria.