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 delle risorse di Amazon DocumentDB Queste sezioni trattano i vari componenti e le relative attività per la gestione dell'implementazione di Amazon DocumentDB (con compatibilità con MongoDB). **Topics** + [Panoramica delle attività operative](operational_tasks.md) + [Cluster globali](global-clusters.md) + [Gestione dei cluster](db-clusters.md) + [Gestione di istanze](db-instances.md) + [Gestione dei gruppi di sottoreti](document-db-subnet-groups.md) + [Disponibilità e replica elevate](replication.md) + [Gestione degli indici](managing-indexes.md) + [Gestione della compressione dei documenti](doc-compression.md) + [Gestione della compressione basata su dizionari](dict-compression.md) + [Gestione degli eventi](managing-events.md) + [Scelta di regioni e zone di disponibilità](regions-and-azs.md) + [Gestione dei gruppi di parametri del cluster](cluster_parameter_groups.md) + [Comprendere gli endpoint](endpoints.md) + [Informazioni su Amazon DocumentDB ARNs](documentdb-arns.md) + [Applicazione di tag alle risorse](tagging.md) + [Manutenzione di Amazon DocumentDB](db-instance-maintain.md) + [Comprensione dei ruoli collegati ai servizi](service-linked-roles.md) + [Utilizzo dei flussi di modifica](change_streams.md) + [Utilizzo di Collation](collation.md) + [Utilizzo di Views](views.md) + [Utilizzo AWS Lambda con stream di modifica](using-lambda.md) # Panoramica delle attività operative di Amazon DocumentDB Questa sezione descrive le attività operative per il tuo cluster Amazon DocumentDB e come eseguirle utilizzando. AWS CLI **Topics** + [Aggiungere una replica a un cluster Amazon DocumentDB](#operational_tasks-add_replica) + [Descrizione di cluster e istanze](#operational_tasks-list_clusters_and_instances) + [Creazione di uno snapshot del cluster](#operational_tasks-creating_snapshot) + [Ripristino da uno snapshot](#operational_tasks-restore_from_snapshot) + [Rimozione di un'istanza da un cluster](#operational_tasks-remove_instance_from_cluster) + [Eliminazione di un cluster](#operational_tasks-delete_cluster) ## Aggiungere una replica a un cluster Amazon DocumentDB *Dopo aver creato l'istanza principale per il tuo cluster Amazon DocumentDB, puoi aggiungere una o più repliche.* Una replica è un'istanza di sola lettura che svolge due funzioni: + **Scalabilità**: se disponi di un numero elevato di client che richiedono l'accesso simultaneo, puoi aggiungere altre repliche per la scalabilità di lettura. + **Alta disponibilità**: in caso di errore dell'istanza principale, Amazon DocumentDB esegue automaticamente il failover su un'istanza di replica e la designa come nuova istanza primaria. Se una replica non riesce, le altre istanze nel cluster saranno ancora in grado di assolvere le richieste finché non viene ripristinato il nodo con l'errore. Ogni cluster Amazon DocumentDB può supportare fino a 15 repliche. **Nota** Per la massima tolleranza ai guasti, devi distribuire le repliche in zone di disponibilità separate. Questo aiuta a garantire che il cluster Amazon DocumentDB possa continuare a funzionare, anche se un'intera zona di disponibilità non è più disponibile. L' AWS CLI esempio seguente mostra come aggiungere una nuova replica. Il parametro `--availability-zone` posiziona la replica nella zona di disponibilità specificata. ``` aws docdb create-db-instance \ --db-instance-identifier sample-instance \ --db-cluster-identifier sample-cluster \ --engine docdb \ --db-instance-class db.r5.large \ --availability-zone us-east-1a ``` ## Descrizione di cluster e istanze L' AWS CLI esempio seguente elenca tutti i cluster Amazon DocumentDB in una regione. 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. Per ulteriori informazioni sulla descrizione e la modifica dei cluster, consulta [Ciclo di vita del cluster Amazon DocumentDB](db-cluster-life-cycle.md). ``` 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", ... } ] } ``` L' AWS CLI esempio seguente elenca le istanze in un cluster Amazon DocumentDB. Per ulteriori informazioni sulla descrizione e la modifica dei cluster, consulta [Ciclo di vita delle istanze Amazon DocumentDB](db-instance-life-cycle.md). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` L'aspetto dell'output è simile al seguente. In questo output, ci sono due istanze. L'istanza primaria è `sample-instance-1` (`"IsClusterWriter": true`). È presente anche un'istanza di replica, `sample-instance2` (`"IsClusterWriter: false"`). ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-cluster-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ## Creazione di uno snapshot del cluster Uno *snapshot del cluster* è un backup completo dei dati nel cluster Amazon DocumentDB. Quando viene creata la snapshot, Amazon DocumentDB legge i dati direttamente dal volume del cluster. Per questo motivo, puoi creare una snapshot anche se il cluster non contiene alcuna istanza attualmente in esecuzione. La quantità di tempo necessaria per creare una snapshot varia a seconda della dimensione del volume cluster. Amazon DocumentDB supporta i backup automatici, che vengono eseguiti ogni giorno durante la finestra di backup preferita, un periodo di 30 minuti durante il giorno. L' AWS CLI esempio seguente mostra come visualizzare la finestra di backup per il cluster: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].PreferredBackupWindow' ``` L'output mostra la finestra di backup (in UTC): ``` [ "00:18-00:48" ] ``` Puoi definire la finestra di backup quando crei il tuo cluster Amazon DocumentDB. Puoi anche modificare la finestra di backup, come nell'esempio seguente: Se non definisci una finestra di backup, Amazon DocumentDB ne assegna automaticamente una al cluster. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --preferred-backup-window "02:00-02:30" ``` Oltre ai backup automatici, puoi creare manualmente una snapshot del cluster in qualsiasi momento. In questo caso, devi specificare il cluster di cui eseguire il backup e un nome univoco per la snapshot che consenta di ripristinarla in un secondo momento. L' AWS CLI esempio seguente mostra come creare un'istantanea dei dati. ``` aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` ## Ripristino da uno snapshot Puoi ripristinare uno snapshot del cluster in un nuovo cluster Amazon DocumentDB. A tale scopo, devi specificare il nome della snapshot e il nome di un nuovo cluster. Non è possibile eseguire il ripristino da uno snapshot a un cluster esistente; Amazon DocumentDB crea invece un nuovo cluster durante il ripristino e lo popola con i dati dello snapshot. L'esempio seguente mostra tutte le snapshot per il cluster `sample-cluster`. ``` aws docdb describe-db-cluster-snapshots \ --db-cluster-identifier sample-cluster \ --query 'DBClusterSnapshots[*].[DBClusterSnapshotIdentifier,SnapshotType,Status]' ``` L'output è simile al seguente. Uno snapshot manuale è creato manualmente, mentre uno snapshot automatico viene creato da Amazon DocumentDB all'interno della finestra di backup del cluster. ``` [ "sample-cluster-snapshot", "manual", "available" ], [ "rds:sample-cluster", "automated", "available" ] ] ``` L'esempio seguente mostra come ripristinare un cluster Amazon DocumentDB da uno snapshot. ``` aws docdb restore-db-cluster-from-snapshot \ --engine docdb \ --db-cluster-identifier new-sample-cluster \ --snapshot-identifier sample-cluster-snapshot ``` Il nuovo cluster non ha istanze associate, quindi per interagire con questo cluster devi aggiungervi un'istanza: ``` aws docdb create-db-instance \ --db-instance-identifier new-sample-instance \ --db-instance-class db.r5.large \ --engine docdb \ --db-cluster-identifier new-sample-cluster ``` È possibile utilizzare le seguenti AWS CLI operazioni per monitorare l'avanzamento della creazione di cluster e istanze. Quando lo stato del cluster e delle istanze è disponibile, puoi connetterti all'endpoint del nuovo cluster e accedere ai dati. ``` aws docdb describe-db-clusters \ --db-cluster-identifier new-sample-cluster \ --query 'DBClusters[*].[Status,Endpoint]' ``` ``` aws docdb describe-db-instances \ --db-instance-identifier new-sample-instance \ --query 'DBInstances[*].[DBInstanceStatus]' ``` ## Rimozione di un'istanza da un cluster Amazon DocumentDB archivia tutti i dati nel volume del cluster. I dati persistono nel volume cluster, anche se rimuovi tutte le istanze dal cluster. Se hai bisogno di accedere nuovamente ai dati, puoi aggiungere un'istanza al cluster in qualsiasi momento e riprendere da dove avevi lasciato. L'esempio seguente mostra come rimuovere un'istanza dal cluster Amazon DocumentDB. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` ## Eliminazione di un cluster Prima di poter eliminare un cluster Amazon DocumentDB, è necessario rimuovere tutte le relative istanze. L' AWS CLI esempio seguente restituisce informazioni sulle istanze in un cluster. Se questa operazione restituisce uno o più identificatori di istanza, devi eliminare tutte le istanze. Per ulteriori informazioni, consulta [Rimozione di un'istanza da un cluster](#operational_tasks-remove_instance_from_cluster). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers[*].DBInstanceIdentifier' ``` Dopo aver rimosso tutte le istanze, puoi eliminare il cluster. A questo punto, devi scegliere una delle seguenti opzioni: + **Crea un'istantanea finale**: acquisisci tutti i dati del cluster in un'istantanea in modo da poter ricreare una nuova istanza con quei dati in un secondo momento. L'esempio seguente mostra la procedura per farlo: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-snapshot ``` + **Ignora l'istantanea finale**: elimina definitivamente tutti i dati del cluster. Questa operazione non può essere annullata. L'esempio seguente mostra la procedura per farlo: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` # Panoramica dei cluster globali di Amazon DocumentDB ## Cos'è un cluster globale? Un cluster globale è composto da una regione principale e da un massimo di 10 aree secondarie di sola lettura. Le operazioni di scrittura vengono eseguite direttamente sul cluster primario nella regione primaria e Amazon DocumentDB replica automaticamente i dati nelle regioni secondarie utilizzando un'infrastruttura dedicata. La latenza è in genere inferiore a un secondo. ## In che modo sono utili i cluster globali? + **Ripristino da interruzioni a livello regionale: in caso di interruzione** a livello regionale, è possibile promuovere uno dei cluster secondari a cluster primario in pochi minuti, con un Recovery Time Objective (RTO) tipico inferiore a un minuto. Il Recovery Point Objective (RPO) viene in genere misurato in secondi, ma dipende dal ritardo della rete al momento dell'errore. + **Letture globali con latenza locale**: se hai uffici in tutto il mondo, puoi utilizzare un cluster globale per mantenere aggiornate le principali fonti di informazioni nella regione principale. Gli uffici delle altre aree geografiche possono accedere alle informazioni nella propria regione, con latenza locale. + **Cluster secondari scalabili: è possibile scalare i** cluster secondari aggiungendo altre istanze di sola lettura a un'area secondaria. Il cluster secondario è di sola lettura, quindi può supportare fino a 16 istanze di replica in sola lettura anziché il normale limite di 15 per un singolo cluster. + **Replica rapida dai cluster primari a quelli secondari: la replica eseguita da un cluster** globale ha un impatto minimo sulle prestazioni del cluster di database primario. Le risorse delle istanze database sono totalmente dedicate a servire carichi di lavoro di lettura e scrittura delle applicazioni. ## Quali sono gli attuali limiti dei cluster globali? + I cluster globali non sono supportati su Amazon DocumentDB v3.6. + I cluster globali sono supportati su tutti i tipi di istanze ad eccezione di db.t3, db.t4g e db.r4. + I cluster globali non sono disponibili nelle seguenti regioni: Sud America (San Paolo), Europa (Milano), Cina (Pechino) e Cina (Ningxia). + Lo switchover e il failover globale non sono supportati quando le regioni utilizzano versioni del motore diverse. Il failover manuale è supportato in caso di mancata corrispondenza tra le versioni del motore. + Solo il cluster primario eseguire operazioni di scrittura. I client che eseguono operazioni di scrittura si connettono all'endpoint del cluster primario. + È possibile disporre di un massimo di 10 regioni secondarie e una regione principale per il cluster. + Un cluster secondario non può essere fermato. Un cluster primario non può essere interrotto se è associato a cluster secondari. È possibile interrompere solo un cluster regionale che non ha cluster secondari. + Le repliche collegate al cluster secondario possono essere riavviate in determinate circostanze. Se l'istanza dell'area primaria si riavvia o esegue il failover, vengono riavviate anche le repliche nell'area secondaria. Il cluster non sarà quindi disponibile finché tutte le repliche non saranno nuovamente sincronizzate con l'istanza writer del cluster di database primario. Si tratta di un comportamento normale. Assicurati di comprendere l'impatto sul cluster globale prima di apportare modifiche al cluster primario. + Non è possibile utilizzare i flussi di modifica sui cluster secondari. **Topics** + [Cos'è un cluster globale?](#w2aac33b9b3) + [In che modo sono utili i cluster globali?](#w2aac33b9b5) + [Quali sono gli attuali limiti dei cluster globali?](#w2aac33b9b7) + [Guida rapida di avvio](global-clusters.get-started.md) + [Gestione di cluster globali](global-clusters.manage.md) + [Connessione di cluster globali](global-clusters-connect.md) + [Monitoraggio dei cluster globali](global-clusters-monitor.md) + [Ripristino di emergenza](global-clusters-disaster-recovery.md) # Guida rapida: cluster globali **Topics** + [Configurazione](#global-clusters.config) + [Creazione di un cluster globale](#global-clusters-create) + [Aggiungere una regione a un cluster globale](#global-clusters.add-region) + [Utilizzo di uno snapshot](#global-clusters.snapshot) ## Configurazione Il cluster globale di Amazon DocumentDB si estende su almeno due. Regioni AWS La regione primaria supporta un cluster con un'istanza primaria (writer) e fino a 15 istanze di replica, mentre una regione secondaria gestisce un cluster di sola lettura composto interamente da un massimo di 16 istanze di replica. Un cluster globale può avere fino a cinque regioni secondarie. La tabella elenca il numero massimo di cluster, istanze e repliche consentiti in un cluster globale. | Description | Primario Regione AWS | Secondario Regione AWS | | --- | --- | --- | | Cluster | 1 | 5 massimo | | Istanze di scrittura | 1 | 0 | | Istanze di sola lettura (repliche Amazon DocumentDB), per cluster | 15 (massimo) | 16 (totali) | | Istanze di sola lettura (massimo consentito, dato il numero effettivo di Regioni secondarie) | 15 - s | s = numero totale di unità secondarie Regioni AWS | I cluster hanno i seguenti requisiti specifici: + **Requisiti delle classi di istanze di database**: è possibile utilizzare solo le classi di `db.r6g` istanze `db.r5` e. + **Regione AWS requisiti**: il cluster primario deve trovarsi in una regione e almeno un cluster secondario deve trovarsi in una regione diversa dello stesso account. È possibile creare fino a cinque cluster secondari (di sola lettura) e ognuno deve trovarsi in una regione diversa. In altre parole, non possono trovarsi due cluster nella stessa regione. + **Requisiti di denominazione**: i nomi scelti per ciascuno dei cluster devono essere unici, in tutte le regioni. Non puoi usare lo stesso nome per cluster diversi anche se si trovano in regioni diverse. ## Creazione di un cluster globale Amazon DocumentDB Sei pronto a creare il tuo primo cluster globale? In questa sezione spiegheremo come creare un cluster globale nuovo di zecca con nuovi cluster e istanze di database, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ### Usando il Console di gestione AWS 1. Nel Console di gestione AWS, accedi ad **Amazon DocumentDB**. 1. **Quando accedi alla console Amazon DocumentDB, scegli Clusters.** ![\[La pagina Clusters nella console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png) 1. Scegli **Create** (Crea). ![\[Il pulsante Crea mostrato nell'angolo superiore destro della tabella Clusters.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png) 1. Compila di **conseguenza la sezione Configurazione** del modulo **Crea cluster Amazon DocumentDB**: + **Identificatore del cluster**: puoi inserire un identificatore univoco per questa istanza o consentire ad Amazon DocumentDB di fornire l'identificatore dell'istanza basato sull'identificatore del cluster. + **Versione del motore: scegli 4.0.0** + **Classe di istanza: scegli db.r5.large** + **Numero di istanze: scegli 3.** ![\[Modulo di opzioni di configurazione per la creazione di un cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png) 1. Nella sezione **Autenticazione**, inserisci un nome utente e una password principali. ![\[Modulo di autenticazione per specificare un nome utente e una password principali per un nuovo cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png) 1. Scegli **Mostra impostazioni avanzate.** ![\[Mostra il pulsante di attivazione delle impostazioni avanzate accanto ai pulsanti Annulla e Crea cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png) 1. Nella **sezione Impostazioni di rete**: + **Mantieni le opzioni predefinite per **Virtual Private Cloud (VPC)** e Subnet group.** ![\[Modulo delle impostazioni di rete che mostra le opzioni VPC, gruppo di sottorete e gruppi di sicurezza VPC. Nei campi VPC e Subnet group sono selezionate le opzioni predefinite.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png) + Per i **gruppi di sicurezza VPC**, l'**impostazione predefinita (VPC)** dovrebbe già essere aggiunta. ![\[Modulo delle impostazioni di rete che mostra il VPC predefinito già aggiunto.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png) + Digita `DocDB` nel campo **Gruppi di sicurezza VPC** e seleziona **DOCDB-Inbound** (VFC). ![\[VFC in ingresso DOCDB selezionato nel menu a discesa dei gruppi di sicurezza VPC.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png) 1. **Per le **opzioni Cluster** ed E, lascia le selezioni predefinite. ncryption-at-rest** ![\[Opzioni e Encryption-at-rest moduli del cluster con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png) 1. Per le **esportazioni di **Backup** e Log**, lascia le selezioni predefinite. ![\[Moduli di esportazione di Backup and Log con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png) 1. Per la **protezione da **manutenzione**, **tag** ed eliminazione**, lascia le selezioni predefinite. ![\[Moduli di protezione da manutenzione, tag ed eliminazione con le opzioni predefinite selezionate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png) 1. Ora fai clic sul pulsante che dice **Crea cluster**. ![\[Il pulsante Crea cluster mostrato alla fine del processo di creazione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png) ### Utilizzando il AWS CLI Per creare un cluster regionale Amazon DocumentDB, chiama il. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato. `global-cluster-id` Per ulteriori informazioni sulla protezione da eliminazione, consulta[Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md). Inoltre, `--engine-version` è un parametro opzionale che utilizza per impostazione predefinita l'ultima versione principale del motore. L'attuale versione predefinita del motore è `5.0.0` (nota: Amazon DocumentDB 8.0 è disponibile ma deve essere specificata esplicitamente come). `8.0.0` Quando vengono rilasciate nuove versioni principali del motore, la versione del motore di default di `--engine-version` viene aggiornata in modo da riflettere l'ultima versione principale del motore. Di conseguenza, per i carichi di lavoro di produzione, in particolare quelli che dipendono da script, automazione o CloudFormation modelli, si consiglia di specificare esplicitamente la versione `--engine-version` principale desiderata. Se non `vpc-security-group-id` viene specificato un `db-subnet-group-name` or, Amazon DocumentDB utilizzerà il gruppo di sottoreti e il gruppo di sicurezza Amazon VPC predefiniti per la regione specificata. Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb create-db-cluster \ --global-cluster-identifier global-cluster-id \ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id ``` Per Windows: ``` aws docdb create-db-cluster ^ --global-cluster-identifier global-cluster-id ^ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "4.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id", "DBClusterIdentifier": "cluster-id", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb4.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com", "AssociatedRoles": [], "HostedZoneId": "ZNKXTT8WH85VW", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1e" ], "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com" } } ``` La creazione del cluster richiede diversi minuti. È possibile utilizzare Console di gestione AWS o AWS CLI per monitorare lo stato del cluster. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md). **Importante** Quando si utilizza AWS CLI per creare un cluster regionale Amazon DocumentDB, non viene creata alcuna istanza. Di conseguenza, devi creare esplicitamente un'istanza primaria e le eventuali istanze di replica di cui hai bisogno. Puoi utilizzare la console o AWS CLI creare le istanze. Per ulteriori informazioni, consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) e [CreateDBCluster](API_CreateDBCluster.md) consulta Amazon DocumentDB API Reference. Una volta che il cluster regionale è disponibile, puoi aggiungere un cluster secondario in un'altra regione con le seguenti istruzioni:[Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB](#global-clusters.add-region). Quando aggiungi una regione, il tuo cluster regionale diventa il tuo cluster principale, e hai un nuovo cluster secondario nella regione che hai scelto. ## Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB Un cluster globale necessita di almeno un cluster secondario in una regione diversa da quella del cluster primario ed è possibile aggiungere fino a cinque cluster secondari. Tieni presente che per ogni cluster secondario che aggiungi, devi ridurre di una il numero di repliche consentite nel cluster primario. Ad esempio, se il cluster globale ha cinque regioni secondarie, il cluster primario può avere solo 10 (anziché 15) repliche. Per ulteriori informazioni, consulta [Requisiti di configurazione di un cluster globale Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config). ### Utilizzando il Console di gestione AWS 1. Accedi Console di gestione AWS e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione scegliere **Cluster**. ![\[La pagina Clusters nella console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png) 1. Scegli il cluster a cui desideri aggiungere un cluster secondario. Assicurati che il cluster sia`Available`. ![\[Elenco di cluster regionali e globali che mostrano lo stato disponibile, con mydocdbglobalcluster evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png) 1. **Seleziona l'elenco a discesa per **Azioni**, quindi scegli Aggiungi regione.** ![\[Il menu a discesa Azioni nell'interfaccia Clusters mostra l'opzione Aggiungi regione.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png) 1. Nella Regione AWS pagina **Aggiungi una**, scegli la regione secondaria. Tieni presente che non puoi scegliere una regione che abbia già un cluster secondario per lo stesso cluster globale. Inoltre, non può essere la stessa regione del cluster primario. Se questa è la prima regione che aggiungi, dovrai anche specificare un identificatore globale del cluster a tua scelta. ![\[Scegli una regione secondaria utilizzando il menu a discesa del modulo Aggiungi un Regione AWS modulo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png) 1. Completa i campi rimanenti per il cluster secondario nella nuova regione, quindi seleziona **Crea cluster**. Dopo aver aggiunto la regione, puoi visualizzarla nell'elenco dei **cluster** in. Console di gestione AWS ![\[Fasi finali dell'aggiunta di una regione a un cluster, visualizzazione del modulo di configurazione, della stima dei costi orari e del pulsante Crea cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png) ### Utilizzando il AWS CLI + Usa il comando `create-db-cluster` CLI con il nome `(--global-cluster-identifier)` del tuo cluster globale. Per gli altri parametri, effettuare le seguenti operazioni: + Perché`--region`, scegli una regione Regione AWS diversa da quella della tua regione principale. + Scegli i valori specifici per i parametri `--engine` e `--engine-version`. + Per un cluster crittografato, specifica il tuo primario Regione AWS come quello `--source-region` per la crittografia. L'esempio seguente crea un nuovo cluster Amazon DocumentDB e lo collega al cluster globale come cluster secondario di sola lettura. Nell'ultimo passaggio, l'istanza viene aggiunta al nuovo cluster. Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb --region secondary-region-id \ create-db-cluster \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version \ --engine docdb aws docdb --region secondary-region-id \ create-db-instance \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version \ --engine docdb ``` Per Windows: ``` aws docdb --region secondary-region-id ^ create-db-cluster ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version ^ --engine docdb aws docdb --region secondary-region-id ^ create-db-instance ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version ^ --engine docdb ``` ## Utilizzo di uno snapshot per il cluster globale Amazon DocumentDB Puoi ripristinare uno snapshot di un cluster Amazon DocumentDB da utilizzare come punto di partenza per il tuo cluster globale. A tale scopo, è necessario ripristinare lo snapshot e creare un nuovo cluster. Questo fungerà da cluster principale del cluster globale. È quindi possibile aggiungere un'altra regione al cluster ripristinato, convertendola così in un cluster globale. # Gestione di un cluster globale Amazon DocumentDB La maggior parte delle operazioni di gestione vengono eseguite sui singoli cluster che costituiscono un cluster globale. Quando si sceglie **Risorse correlate al gruppo** nella pagina **Cluster** della console, vengono visualizzati il cluster primario e i cluster secondari raggruppati nel cluster globale associato. La scheda **Configurazione** per un cluster globale mostra Regioni AWS dove sono in esecuzione i cluster, la versione e l'identificatore globale del cluster. **Topics** + [Modifica dei cluster globali](#global-clusters.modify) + [Modifica dei parametri](#global-clusters.modify-parameters) + [Rimozione di cluster globali](#global-clusters.remove) + [Eliminazione di cluster globali](#global-clusters.delete) + [Cluster headless](#global-clusters.headless) ## Modifica di un cluster globale Amazon DocumentDB La pagina **Cluster** Console di gestione AWS elenca tutti i cluster globali, mostrando il cluster primario e i cluster secondari per ciascuno di essi. Il cluster globale ha le proprie impostazioni di configurazione. In particolare, ha regioni associate ai suoi cluster primari e secondari. Quando apporti modifiche al cluster globale, hai la possibilità di annullare le modifiche. Quando si sceglie Continue (Continua), si confermano le modifiche. ## Modifica dei parametri di un cluster globale Amazon DocumentDB È possibile configurare i gruppi di parametri del cluster in modo indipendente per ogni cluster all'interno del cluster globale. La maggior parte dei parametri funziona come per altri tipi di cluster Amazon DocumentDB. Si consiglia di mantenere le impostazioni coerenti tra tutti i cluster di un database globale. In questo modo è possibile evitare modifiche impreviste del comportamento se si promuove un cluster secondario come primario. Ad esempio, utilizzare le stesse impostazioni per fusi orari e set di caratteri per evitare comportamenti incoerenti se un cluster diverso diventa un cluster primario. ## Rimozione di un cluster da un cluster globale Amazon DocumentDB Esistono diverse situazioni in cui potresti voler rimuovere i cluster dal tuo cluster globale. Ad esempio, potresti voler rimuovere un cluster da un cluster globale se il cluster primario diventa degradato o isolato. Diventa quindi un cluster autonomo con provisioning che può essere utilizzato per creare un nuovo cluster globale. Per ulteriori informazioni, consulta [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover). Potresti anche voler rimuovere i cluster perché desideri eliminare un cluster globale che non ti serve più. Puoi eliminare il cluster globale solo dopo aver scollegato tutti i cluster associati, lasciando il cluster primario per ultimo. Per ulteriori informazioni, consulta [Eliminazione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.delete). **Nota** Quando un cluster viene scollegato dal cluster globale, non è più sincronizzato con il cluster primario. Diventa un cluster con provisioning autonomo con funzionalità complete. read/write Inoltre, non è più visibile nella console Amazon DocumentDB. È visibile solo quando si seleziona la regione nella console in cui si trovava il cluster. È possibile rimuovere i cluster dal cluster globale utilizzando l' Console di gestione AWS API RDS o AWS CLI l'API RDS. ------ #### [ Using the Console di gestione AWS ] 1. Accedi Console di gestione AWS e accedi alla console Amazon DocumentDB. 1. Scegli **Clusters** nella barra di navigazione a sinistra. ![\[Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png) 1. Espandi il cluster globale in modo da poter vedere tutti i cluster secondari. Seleziona i cluster secondari che desideri rimuovere. Scegli **Azioni** e, nel menu a discesa, scegli **Rimuovi da globale**. ![\[Immagine: la casella di navigazione Cluster che mostra la selezione di un cluster secondario esistente ed evidenzia l'azione «Rimuovi dal globale».\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/remove-global.png) 1. Apparirà un messaggio che ti chiederà di confermare che desideri scollegare il cluster secondario dal cluster globale. Scegli **Rimuovi e promuovi** per rimuovere il cluster dal cluster globale. ![\[Immagine: il prompt Rimuovi e promuovi.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/remove-promote.png) Ora quel cluster non funge più da cluster secondario e non è più sincronizzato con il cluster primario. È un cluster autonomo con funzionalità complete read/write . Dopo aver rimosso o eliminato tutti i cluster secondari, è possibile rimuovere il cluster primario nello stesso modo. È possibile scollegare o rimuovere il cluster primario dal cluster globale solo dopo aver rimosso tutti i cluster secondari. Il cluster globale potrebbe rimanere nell'elenco dei cluster, con zero regioni e. AZs È possibile eliminare se non si desidera più utilizzare questo cluster globale. ------ #### [ Using the AWS CLI ] Per rimuovere un cluster da un cluster globale, esegui il comando `remove-from-global-cluster` CLI con i seguenti parametri: + `--global-cluster-identifier`— Il nome (identificatore) del cluster globale. + `--db-cluster-identifier`— Il nome di ogni cluster da rimuovere dal cluster globale. Gli esempi seguenti rimuovono prima un cluster secondario e poi il cluster primario da un cluster globale. Per Linux, macOS o Unix: ``` aws docdb --region secondary_region \ remove-from-global-cluster \ --db-cluster-identifier secondary_cluster_ARN \ --global-cluster-identifier global_cluster_id aws docdb --region primary_region \ remove-from-global-cluster \ --db-cluster-identifier primary_cluster_ARN \ --global-cluster-identifier global_cluster_id ``` Ripeti il `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` comando per ogni regione secondaria del cluster globale. Per Windows: ``` aws docdb --region secondary_region ^ remove-from-global-cluster ^ --db-cluster-identifier secondary_cluster_ARN ^ --global-cluster-identifier global_cluster_id aws docdb --region primary_region ^ remove-from-global-cluster ^ --db-cluster-identifier primary_cluster_ARN ^ --global-cluster-identifier global_cluster_id ``` Ripeti il `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` comando per ogni regione secondaria del cluster globale. ------ ## Eliminazione di un cluster da un cluster globale Amazon DocumentDB Per eliminare un cluster globale, procedi come segue: + Rimuovi tutti i cluster secondari dal cluster globale. Ogni cluster diventa un cluster autonomo. Vedi la sezione precedente,[Rimozione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.remove). + Da ogni cluster autonomo, elimina tutte le repliche. + Rimuovi il cluster primario dal cluster globale. Questo diventa un cluster autonomo. + Dal cluster primario, elimina prima tutte le repliche, quindi elimina l'istanza principale. L'eliminazione dell'istanza primaria dal nuovo cluster autonomo in genere rimuove anche sia il cluster che il cluster globale. ------ #### [ Using the Console di gestione AWS ] 1. Accedi Console di gestione AWS e accedi alla console Amazon DocumentDB. 1. Scegli **Clusters** e trova il cluster globale che desideri eliminare. ![\[Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png) 1. Con il cluster globale selezionato, scegli **Elimina** dal menu **Azioni**. ![\[Immagine: la casella di navigazione dei cluster che mostra la selezione di un cluster globale ed evidenzia l'azione «Elimina».\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png) Conferma che tutti i cluster siano stati rimossi dal cluster globale. Il cluster globale dovrebbe mostrare zero regioni AZs e una dimensione pari a zero cluster. Se il cluster globale contiene dei cluster, non puoi ancora eliminarlo. Dovrai prima seguire le istruzioni del passaggio precedente, **[Rimozione di un cluster da un cluster globale Amazon DocumentDB](#global-clusters.remove)**. ------ #### [ Using the AWS CLI ] Per eliminare un cluster globale, esegui il comando `delete-global-cluster` CLI con il nome Regione AWS e l'identificatore globale del cluster, come illustrato nell'esempio seguente. Per Linux, macOS o Unix: ``` aws docdb --region primary_region delete-global-cluster \ --global-cluster-identifier global_cluster_id ``` Per Windows: ``` aws docdb --region primary_region delete-global-cluster ^ --global-cluster-identifier global_cluster_id ``` ------ ## Creazione di un cluster Amazon DocumentDB headless in una regione secondaria Sebbene un cluster globale Amazon DocumentDB richieda almeno un cluster secondario in un cluster Regione AWS diverso da quello primario, è possibile utilizzare una configurazione headless per il cluster secondario. Un cluster secondario headless di Amazon DocumentDB è un cluster senza istanza. Questo tipo di configurazione può ridurre le spese per un cluster globale. In un cluster Amazon DocumentDB, elaborazione e storage sono disaccoppiati. Senza l'istanza, non ti viene addebitato alcun costo per l'elaborazione, ma solo per lo storage. Se è configurato correttamente, il volume di archiviazione di un secondario headless viene mantenuto sincronizzato con il cluster primario. Aggiungi il cluster secondario come fai normalmente quando crei un cluster globale Amazon DocumentDB. Tuttavia, dopo che il cluster primario inizia la replica sul cluster secondario, elimini l'istanza di sola lettura dal cluster secondario. Questo cluster secondario è ora considerato «headless» perché non dispone più di un'istanza. Tuttavia, il volume di storage viene mantenuto sincronizzato con il cluster Amazon DocumentDB principale. **Importante** Consigliamo i cluster headless solo per i clienti che possono tollerare guasti a livello regionale per più di 15 minuti. Questo perché il ripristino da un errore a livello regionale con un cluster secondario headless richiederà all'utente di creare una nuova istanza dopo il failover. Una nuova istanza può impiegare circa 10-15 minuti per diventare disponibile. ### Come aggiungere un cluster secondario headless al cluster globale 1. Accedi Console di gestione AWS e apri la console [Amazon DocumentDB.](https://console.aws.amazon.com/rds/) 1. Scegli **Clusters** nella barra di navigazione a sinistra. 1. Scegli il cluster globale che necessita di un cluster secondario. Assicurati che il cluster primario sia`Available`. 1. Per **Actions (Operazioni)**, scegliere **Add region (Aggiungi regione)**. 1. Nella pagina **Aggiungi una regione**, scegli la regione secondaria. **Nota** Non puoi scegliere una regione che abbia già un cluster secondario per lo stesso cluster globale. Inoltre, non può essere la stessa regione del cluster primario. 1. Completa i campi rimanenti per il cluster secondario nella nuova regione. Queste sono le stesse opzioni di configurazione di qualsiasi istanza del cluster. 1. Aggiungi una regione. Dopo aver aggiunto la regione al cluster globale, la vedrai nell'elenco di `Clusters` Console di gestione AWS. 1. Controlla lo stato del cluster secondario e della relativa istanza di lettura prima di continuare, utilizzando Console di gestione AWS o il AWS CLI. Ecco un esempio di comando se si utilizza AWS CLI: ``` $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text ``` Possono essere necessari diversi minuti prima che lo stato di un cluster secondario appena aggiunto cambi da creazione a disponibile. Quando il cluster è disponibile, puoi eliminare l'istanza del lettore. 1. Seleziona l'istanza del lettore nel cluster secondario, quindi scegli **Elimina**. 1. Dopo aver eliminato l'istanza del lettore, il cluster secondario rimane parte del cluster globale. Non dovrebbe avere alcuna istanza associata. **Nota** Puoi utilizzare questo cluster secondario headless di Amazon DocumentDB per ripristinare manualmente il cluster globale Amazon DocumentDB da un'interruzione non pianificata nella regione principale, se si verifica un'interruzione di questo tipo. # Connect a un cluster globale Amazon DocumentDB Il modo in cui ci si connette a un cluster globale dipende dal fatto che sia necessario scrivere sul cluster o leggere dal cluster: + Per richieste o interrogazioni di sola lettura, ti connetti all'endpoint di lettura per il cluster del tuo. Regione AWS + Per eseguire le istruzioni DML (Data Manipulation Language) o DDL (Data Definition Language), esegui la connessione all'endpoint del cluster per il cluster primario. Questo endpoint potrebbe trovarsi in un'applicazione diversa da quella in uso. Regione AWS Quando si visualizza un cluster globale nella console, è possibile visualizzare tutti gli endpoint generici associati a tutti i relativi cluster. Il modo in cui ci si connette a un cluster globale dipende dal fatto che sia necessario scrivere sul database o leggere dal database. Per le operazioni DDL, DML e di lettura che desideri eseguire dalla regione primaria, devi connetterti al cluster primario. Si consiglia di connettersi al cluster primario utilizzando l'endpoint del cluster in modalità set di replica, con una preferenza di lettura di. `secondaryPreferred=true` Questo indirizzerà il traffico di scrittura verso l'istanza writer del cluster primario e il traffico di lettura verso l'istanza di replica del cluster primario. Per il traffico interregionale e di sola lettura, è necessario connettersi a uno dei cluster secondari. Ti consigliamo di connetterti al cluster secondario utilizzando l'endpoint del cluster in modalità set di repliche. Poiché tutte le istanze sono istanze di replica di sola lettura, non è necessario specificare una preferenza di lettura. Per ridurre al minimo la latenza, scegli l'endpoint di lettura che si trova nella tua regione o nella regione più vicina a te. # Monitoraggio dei cluster globali di Amazon DocumentDB Amazon DocumentDB (con compatibilità con MongoDB) si integra per CloudWatch consentirti di raccogliere e analizzare i parametri operativi per i tuoi cluster. Puoi monitorare questi parametri utilizzando la CloudWatch console, la console Amazon DocumentDB, AWS Command Line Interface il AWS CLI() o CloudWatch l'API. Per monitorare un cluster globale, utilizza le seguenti CloudWatch metriche. | Metrica | Description | | --- | --- | | GlobalClusterReplicatedWriteIO | Il numero medio di I/O operazioni di scrittura fatturate replicate dal volume del cluster nel volume primario Regione AWS al volume del cluster in un volume secondario Regione AWS, riportato a intervalli di 5 minuti. Il numero di repliche ReplicatedWriteIOs in ciascuna regione secondaria è uguale al numero di repliche interne VolumeWriteIOPs eseguite dall'area principale. | | GlobalClusterDataTransferBytes | La quantità di dati trasferiti dal cluster primario Regione AWS a quello secondario Regione AWS, misurata in byte. | | GlobalClusterReplicationLag | La quantità di ritardo, in millisecondi, durante la replica degli eventi di modifica dal cluster primario a quello di un cluster secondario Regione AWS Regione AWS | [Per ulteriori informazioni su come visualizzare queste metriche, consulta Visualizzazione dei dati. CloudWatch ](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data) # Disaster recovery e cluster globali Amazon DocumentDB **Topics** + [Esecuzione di un failover gestito per un cluster globale Amazon DocumentDB](#managed-failover) + [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](#manual-failover) + [Esecuzione di uno switchover per un cluster globale Amazon DocumentDB](#global-cluster-switchover) + [Sblocco dello switchover o del failover di un cluster globale](#unblocking-gc-so-fo) Utilizzando un cluster globale, puoi eseguire rapidamente il ripristino da disastri come i guasti regionali. Il ripristino da emergenza viene in genere misurato utilizzando i valori per RTO e RPO. + **Obiettivo del tempo di ripristino (RTO)**: il tempo necessario a un sistema per tornare in uno stato funzionante dopo un'emergenza. In altre parole, l'RTO misura i tempi di inattività. Per un cluster globale, RTO in pochi minuti. + **Obiettivo del punto di ripristino (RPO)**: la quantità di dati che possono essere persi (misurata nel tempo). Per un cluster globale, l'RPO viene in genere misurato in secondi. + Per ripristinare il sistema dopo un'interruzione non pianificata, è possibile eseguire un failover interregionale su uno dei sistemi secondari del cluster globale. Se il cluster globale ha più regioni secondarie, assicurati di scollegare tutte le regioni secondarie che desideri promuovere come principali. Quindi, promuovi una di queste regioni secondarie affinché diventi la nuova principale. Regione AWS Infine, crei nuovi cluster in ciascuna delle altre regioni secondarie e colleghi tali cluster al tuo cluster globale. ## Esecuzione di un failover gestito per un cluster globale Amazon DocumentDB Questo approccio è destinato alla continuità aziendale in caso di una reale emergenza a livello regionale o di un'interruzione completa del livello di servizio. Durante un failover gestito, il cluster primario viene eseguito il failover nella regione secondaria prescelta, mentre viene mantenuta la topologia di replica esistente del cluster globale Amazon DocumentDB. Il cluster secondario scelto promuove uno dei suoi nodi di sola lettura allo stato di istanza di scrittura completa. Questo passaggio consente al cluster di assumere il ruolo di cluster primario. Il database non sarà disponibile per un breve periodo di tempo mentre il cluster sta assumendo il suo nuovo ruolo. I dati che non sono stati replicati dal vecchio cluster primario al cluster secondario scelto potrebbero mancare quando questo secondario diventa il nuovo primario. Il vecchio volume primario fa del suo meglio per scattare un'istantanea prima di sincronizzarsi con il nuovo volume primario, in modo che i dati non replicati vengano conservati nell'istantanea. **Nota** È possibile eseguire un failover di cluster interregionale gestito su un cluster globale Amazon DocumentDB solo se i cluster primari e tutti i cluster secondari hanno le stesse versioni del motore. Se le versioni del motore non sono compatibili, puoi eseguire il failover manualmente seguendo i passaggi indicati in [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](#manual-failover). Se le versioni del motore della regione non corrispondono, il failover verrà bloccato. Verifica la presenza di eventuali aggiornamenti in sospeso e applicali per assicurarti che le versioni del motore di tutte le regioni corrispondano e che il failover globale del cluster sia sbloccato. Per ulteriori informazioni, consulta [Sblocco dello switchover o del failover di un cluster globale](#unblocking-gc-so-fo). Per ridurre al minimo la perdita di dati, è consigliabile eseguire le seguenti operazioni prima di utilizzare questa funzionalità: + Metti offline le applicazioni per evitare che le scritture vengano inviate al cluster primario del cluster globale Amazon DocumentDB. + Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB. La scelta della regione secondaria con il minor ritardo di replica può ridurre al minimo la perdita di dati relativamente all'attuale regione primaria in stato di errore. Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB nel cluster globale visualizzando la `GlobalClusterReplicationLag` metrica in Amazon. CloudWatch Questi parametri mostrano quanto sia indietro (in millisecondi) la replica su un cluster secondario rispetto al cluster primario. Per ulteriori informazioni sui CloudWatch parametri per Amazon DocumentDB, consulta. [Metriche di Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) Durante un failover gestito, il cluster secondario scelto viene promosso al suo nuovo ruolo di primario. Tuttavia, non eredita le varie opzioni di configurazione del cluster primario. Una mancata corrispondenza nella configurazione può causare problemi di prestazioni, incompatibilità dei carichi di lavoro e altri comportamenti anomali. Per evitare tali problemi, ti consigliamo di risolvere le differenze tra i cluster globali di Amazon DocumentDB per quanto segue: + **Se necessario, configura un gruppo di parametri del cluster Amazon DocumentDB per il nuovo cluster primario**: puoi configurare i gruppi di parametri del cluster Amazon DocumentDB in modo indipendente per ogni cluster nei cluster globali Amazon DocumentDB. Pertanto, quando promuovi un cluster secondario affinché assuma il ruolo principale, il gruppo di parametri del secondario potrebbe essere configurato in modo diverso rispetto a quello primario. In tal caso, modifica il gruppo di parametri del cluster secondario promosso in modo che sia conforme alle impostazioni del cluster primario. Per scoprire come, consulta [Modifica dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-modify.md). + **Configura strumenti e opzioni di monitoraggio, come CloudWatch eventi e allarmi Amazon**: configura il cluster promosso con la stessa capacità di registrazione, allarmi e così via necessari per il cluster globale. Come per i gruppi di parametri, la configurazione di queste funzionalità non viene ereditata dal primario durante il processo di failover. Alcune CloudWatch metriche, come il ritardo di replica, sono disponibili solo per le regioni secondarie. Pertanto, un failover modifica il modo in cui visualizzare tali metriche e impostare i relativi allarmi e potrebbe richiedere modifiche da apportare a qualsiasi dashboard predefinito. Per ulteriori informazioni sui cluster e sul monitoraggio di Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md) In genere, il cluster secondario scelto assume il ruolo principale entro un minuto. Non appena il nodo di scrittura della nuova regione primaria è disponibile, puoi connettervi le tue applicazioni e riprendere i tuoi carichi di lavoro. Dopo aver promosso il nuovo cluster primario, Amazon DocumentDB ricostruisce automaticamente tutti i cluster regionali secondari aggiuntivi. Poiché i cluster globali di Amazon DocumentDB utilizzano la replica asincrona, il ritardo di replica in ciascuna regione secondaria può variare. Amazon DocumentDB ricostruisce queste regioni secondarie in modo che abbiano esattamente gli stessi point-in-time dati del nuovo cluster Region primario. La durata dell'attività di ricostruzione completa può richiedere da alcuni minuti a diverse ore, a seconda delle dimensioni del volume di archiviazione e della distanza tra regioni. Quando i cluster regionali secondari terminano la ricostruzione in base alla nuova regione primaria, diventano disponibili per l'accesso in lettura. Non appena il nuovo writer primario viene promosso e reso disponibile, il cluster della nuova regione primaria può gestire le operazioni di lettura e scrittura per il cluster globale Amazon DocumentDB. Per ripristinare la topologia originale del cluster globale, Amazon DocumentDB monitora la disponibilità della vecchia regione primaria. Non appena la regione è di nuovo integra e disponibile, Amazon DocumentDB la riaggiunge automaticamente al cluster globale come regione secondaria. Prima di creare il nuovo volume di storage nella vecchia regione primaria, Amazon DocumentDB tenta di scattare un'istantanea del vecchio volume di storage nel punto in cui si è verificato l'errore. Ciò consente di usare lo snapshot per recuperare i dati mancanti. Se questa operazione ha esito positivo, Amazon DocumentDB inserisce questa istantanea denominata «rds: docdb-unplanned-global-failover - name-of-old-primary -DB-Cluster-Timestamp» nella sezione snapshot di. Console di gestione AWS Puoi anche vedere questa istantanea elencata nelle informazioni restituite dall'operazione API. `DescribeDBClusterSnapshots` **Nota** Lo snapshot del vecchio volume di archiviazione è uno snapshot del sistema soggetto al periodo di conservazione del backup configurato sul vecchio cluster primario. Per conservare questo snapshot oltre il periodo di conservazione, puoi copiarlo e salvarlo come snapshot manuale. Per ulteriori informazioni sulla copia degli snapshot, inclusi i prezzi, consulta [Copiare uno snapshot del cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot). Dopo il ripristino della topologia originale, è possibile eseguire il failback del cluster globale nella regione primaria originale eseguendo un'operazione di switchover nel momento più opportuno per l'azienda e il carico di lavoro. A tale scopo, segui la procedura in [Esecuzione di uno switchover per un cluster globale Amazon DocumentDB](#global-cluster-switchover). Puoi eseguire il failover del cluster globale Amazon DocumentDB utilizzando l' Console di gestione AWS API Amazon DocumentDB o Amazon DocumentDB. AWS CLI ------ #### [ Using the Console di gestione AWS ] **Esegui un failover gestito sul tuo cluster globale Amazon DocumentDB** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione scegliere **Cluster**. 1. Trova e scegli il cluster globale Amazon DocumentDB di cui desideri eseguire il failover. ![\[Immagine: tabella del cluster con cluster globale selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-cluster-table.png) 1. **Scegli **Switchover o Failover dal menu** Azioni.** 1. Nella finestra di dialogo che appare, scegli **Failover**, quindi scegli il cluster secondario dall'elenco a discesa del campo **Nuovo cluster primario**. ![\[Immagine: finestra di dialogo di switchover o failover del cluster globale.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switch-fail-confirm.png) 1. Digita «conferma» nell'ultimo campo. Quindi scegli **Conferma**. Lo stato del cluster primario cambia in "**Failing-over**». Questa condizione dovrebbe richiedere circa un minuto. Durante questo periodo, lo stato del nuovo cluster primario mostra "**Modifica** in corso... ». Una volta promosso, il nuovo primario mostrerà "**Disponibile**" e sarà in grado di fornire transazioni di lettura e scrittura. Le regioni secondarie, inclusa la vecchia primaria, mostreranno "**Risincronizzazione**... «mentre si risincronizza con il nuovo primario. **Analogamente al nuovo primario, sarà in grado di eseguire la transazione solo quando lo stato passerà a "Disponibile».** 1. Una volta completato, il cluster primario originale diventa il cluster secondario. Il cluster secondario selezionato diventa il cluster primario. ![\[Immagine: tabella dei cluster che mostra il nuovo cluster primario.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-complete.png) ------ #### [ Using the AWS CLI ] **Esegui un failover gestito sul tuo cluster globale Amazon DocumentDB** Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI per eseguire il failover del cluster globale Amazon DocumentDB. Con il comando, passa i valori per le seguenti opzioni: + `--region` + `--global-cluster-identifier` + `--target-db-cluster-identifier` + `--allow-data-loss` Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster. Per Linux, macOS o Unix: ``` aws docdb failover-global-cluster \ --region region_of_selected_secondary \ --global-cluster-identifier global_cluster_id \ --target-db-cluster-identifier arn_of_secondary_to_promote \ --allow-data-loss ``` Per Windows: ``` aws docdb failover-global-cluster ^ --region region_of_selected_secondary ^ --global-cluster-identifier global_cluster_id ^ --target-db-cluster-identifier arn_of_secondary_to_promote ^ --allow-data-loss ``` ------ ## Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB Se un intero cluster in uno non è Regione AWS più disponibile, puoi promuovere un altro cluster del cluster globale affinché read/write disponga delle funzionalità. È possibile attivare manualmente il meccanismo di failover globale del cluster se un cluster in un altro Regione AWS è la scelta migliore come cluster principale. Ad esempio, potrebbe essere necessario incrementare la capacità di uno dei cluster secondari e quindi promuoverlo a cluster primario. Oppure l'equilibrio delle attività tra i due Regioni AWS potrebbe cambiare, in modo che il passaggio dal cluster primario a un altro Regione AWS potrebbe comportare una minore latenza per le operazioni di scrittura. La procedura seguente descrive cosa fare per promuovere uno dei cluster secondari in un cluster globale Amazon DocumentDB. Per promuovere un cluster secondario: 1. Interrompi l'emissione di istruzioni DML e altre operazioni di scrittura sul cluster primario in caso Regione AWS di interruzione. 1. Identifica un cluster da un cluster secondario da Regione AWS utilizzare come nuovo cluster primario. Se hai due (o più) cluster secondari Regioni AWS nel tuo cluster globale, scegli il cluster secondario con il minor ritardo. 1. Scollega il cluster secondario scelto dal cluster globale. La rimozione di un cluster secondario da un cluster globale interrompe immediatamente la replica dal primario a questo secondario e la promuove in un cluster autonomo con funzionalità complete. read/write Qualsiasi altro cluster secondario associato al cluster primario nella regione interessata dall'interruzione è ancora disponibile e può accettare chiamate dall'applicazione. Inoltre consumano risorse. Poiché state ricreando il cluster globale, per evitare problemi di tipo split-brain e di altro tipo, rimuovete gli altri cluster secondari prima di creare il nuovo cluster globale nei passaggi seguenti. Per i passaggi dettagliati per lo scollegamento, consulta [Rimozione di un cluster da un cluster globale Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove). 1. Questo cluster diventa il cluster principale di un nuovo cluster globale quando inizi ad aggiungervi regioni, nel passaggio successivo. 1. Aggiungi un Regione AWS al cluster. Quando esegui questa operazione, inizia il processo di replica da primario a secondario. 1. Aggiungine altro Regioni AWS se necessario per ricreare la topologia necessaria per supportare l'applicazione. Assicurati che le scritture delle applicazioni vengano inviate al cluster corretto prima, durante e dopo aver apportato modifiche come queste, per evitare incongruenze di dati tra i cluster del cluster globale (problemi di split-brain). 1. Quando l'interruzione è stata risolta e sei pronto a riassegnare il cluster originale Regione AWS come cluster primario, esegui la stessa procedura in senso inverso. 1. Rimuovi uno dei cluster secondari dal cluster globale. Ciò gli consentirà di servire il read/write traffico. 1. Reindirizza tutto il traffico di scrittura al cluster primario dell'originale Regione AWS. 1. Aggiungi un Regione AWS per configurare uno o più cluster secondari nello stesso modo di prima Regione AWS . I cluster globali di Amazon DocumentDB possono essere gestiti utilizzando AWS SDKs, il che consente di creare soluzioni per automatizzare il processo di failover globale dei cluster per i casi d'uso di Disaster Recovery e Business Continuity Planning. [Una di queste soluzioni è disponibile per i nostri clienti con licenza Apache 2.0 ed è accessibile dal nostro repository di strumenti qui.](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation) Questa soluzione sfrutta Amazon Route 53 per la gestione degli endpoint e fornisce AWS Lambda funzioni che possono essere attivate in base a eventi appropriati. ## Esecuzione di uno switchover per un cluster globale Amazon DocumentDB Utilizzando gli switchover, è possibile modificare regolarmente la Regione del cluster primario. Questo approccio è destinato agli scenari controllati, ad esempio durante la manutenzione operativa e altre procedure operative pianificate. Esistono tre casi d'uso comuni per l'utilizzo degli switchover: + Per i requisiti relativi alla "rotazione regionale" imposti a settori specifici. Ad esempio, le normative sui servizi finanziari potrebbero imporre che i sistemi di livello 0 passino a un'altra regione per diversi mesi per garantire l'esecuzione regolare delle procedure di ripristino di emergenza. + Per applicazioni "" multiregionali. follow-the-sun Ad esempio, un'azienda potrebbe voler fornire scritture con latenza inferiore in diverse regioni in base all'orario di lavoro nei vari fusi orari. + Come zero-data-loss metodo per tornare alla regione principale originale dopo un failover. **Nota** Gli switchover sono progettati per essere utilizzati su un cluster globale Amazon DocumentDB integro. Per eseguire il ripristino da un'interruzione non pianificata, puoi eseguire la procedura appropriata descritta in [Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB](#manual-failover). Per eseguire uno switchover, tutte le regioni secondarie devono utilizzare la stessa identica versione del motore del motore principale. Se le versioni del motore della regione non corrispondono, lo switchover verrà bloccato. Verifica la presenza di eventuali aggiornamenti in sospeso e applicali per assicurarti che le versioni del motore di tutte le regioni corrispondano e che il passaggio al cluster globale sia sbloccato. Per ulteriori informazioni, consulta [Sblocco dello switchover o del failover di un cluster globale](#unblocking-gc-so-fo). Durante uno switchover, Amazon DocumentDB trasferisce il cluster primario alla regione secondaria prescelta, mantenendo al contempo la topologia di replica esistente del cluster globale. Prima di avviare il processo di passaggio, Amazon DocumentDB attende che tutti i cluster regionali secondari siano completamente sincronizzati con il cluster Region primario. Il cluster database nella regione primaria diventa di sola lettura e il cluster secondario scelto promuove uno dei relativi nodi di sola lettura allo stato di nodo di scrittura completa. La promozione di questo nodo a nodo di scrittura consente a tale cluster secondario di assumere il ruolo di cluster primario. Poiché tutti i cluster secondari sono stati sincronizzati con quello primario all'inizio del processo, il nuovo cluster primario continua a operare per il cluster globale Amazon DocumentDB senza perdere alcun dato. Il database non è disponibile per un breve periodo, mentre i cluster primario e secondario selezionati assumono i loro nuovi ruoli. Per ottimizzare la disponibilità delle applicazioni, è consigliabile eseguire le seguenti operazioni prima di utilizzare questa funzionalità: + Esegui questa operazione durante le ore non di punta o in un altro momento in cui le scritture sul cluster primario sono minime. + Metti offline le applicazioni per evitare che le scritture vengano inviate al cluster primario del cluster globale Amazon DocumentDB. + Controlla i tempi di ritardo per tutti i cluster secondari di Amazon DocumentDB nel cluster globale visualizzando la `GlobalClusterReplicationLag` metrica in Amazon. CloudWatch Questa metrica mostra quanto sia indietro (in millisecondi) la replica su un cluster secondario rispetto al cluster primario. Questo valore è direttamente proporzionale al tempo impiegato da Amazon DocumentDB per completare lo switchover. Di conseguenza, maggiore è il valore del ritardo, maggiore sarà il tempo necessario per lo switchover. Per ulteriori informazioni sui CloudWatch parametri per Amazon DocumentDB, consulta. [Metriche di Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) Durante uno switchover gestito, il cluster database secondario scelto viene promosso al nuovo ruolo primario. Tuttavia, non eredita le varie opzioni di configurazione del cluster di database primario. Una mancata corrispondenza nella configurazione può causare problemi di prestazioni, incompatibilità dei carichi di lavoro e altri comportamenti anomali. Per evitare tali problemi, ti consigliamo di risolvere le differenze tra i cluster globali di Amazon DocumentDB per quanto segue: + **Se necessario, configura il gruppo di parametri del cluster Amazon DocumentDB per il nuovo cluster primario**: puoi configurare i gruppi di parametri del cluster Amazon DocumentDB in modo indipendente per ogni cluster del tuo cluster globale Amazon DocumentDB. Ciò significa che quando si promuove un cluster di database secondario perché assuma il ruolo primario, il gruppo di parametri dal secondario potrebbe essere configurato in modo diverso rispetto al primario. In tal caso, modifica il gruppo di parametri del cluster di database secondario promosso in modo che sia conforme alle impostazioni del cluster primario. Per scoprire come, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md). + **Configura strumenti e opzioni di monitoraggio, come Amazon CloudWatch Events e allarmi**: configura il cluster promosso con la stessa capacità di registrazione, allarmi e così via necessari per il cluster globale. Come per i gruppi di parametri, la configurazione di queste funzionalità non viene ereditata dal ruolo primario durante il processo di switchover. Alcune CloudWatch metriche, come il ritardo di replica, sono disponibili solo per le regioni primarie. Pertanto, uno switchover modifica il modo in cui visualizzare tali metriche e impostare i relativi allarmi e potrebbe richiedere modifiche da apportare a qualsiasi dashboard predefinito. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md). **Nota** In genere, lo switchover del ruolo può richiedere fino a diversi minuti. Una volta completato il processo di passaggio, il cluster Amazon DocumentDB promosso può gestire le operazioni di scrittura per il cluster globale. Puoi passare da un cluster globale di Amazon DocumentDB utilizzando Console di gestione AWS o: AWS CLI ------ #### [ Using the Console di gestione AWS ] **Esegui uno switchover sul tuo cluster globale Amazon DocumentDB** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione scegliere **Cluster**. 1. Trova e seleziona il cluster globale Amazon DocumentDB da trasferire. ![\[Immagine: tabella del cluster con cluster globale selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switchover-cluster-table.png) 1. **Scegli **Switchover o Failover dal menu** Azioni.** 1. Nella finestra di dialogo che appare, scegli **Switchover**, quindi scegli il cluster secondario dall'elenco a discesa del campo **Nuovo cluster primario**. ![\[Immagine: finestra di dialogo di commutazione del cluster con il cluster secondario selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/switch-fail-confirm-2.png) 1. Scegli **Conferma**. Lo stato del cluster primario cambia in "**Switching-over**». Questa condizione dovrebbe richiedere circa tre minuti. Durante questo periodo, lo stato di tutti i cluster regionali mostra "**Modifica**... ». Una volta sincronizzate le regioni e promosso il nuovo primario, verrà visualizzato il messaggio "**Disponibile**" per tutti i campi di stato e sarà possibile gestire le transazioni. 1. Una volta completato, il cluster primario originale diventa il cluster secondario. Il cluster secondario selezionato diventa il cluster primario. ![\[Immagine: tabella dei cluster che mostra il nuovo cluster primario.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/failover-complete.png) ------ #### [ Using the AWS CLI ] **Esegui uno switchover sul tuo cluster globale Amazon DocumentDB** Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI per passare al cluster globale Amazon DocumentDB. Con il comando, passa i valori per le seguenti opzioni: + `--region` + `--global-cluster-identifier` + `--target-db-cluster-identifier` Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster. Per Linux, macOS o Unix: ``` aws docdb switchover-global-cluster \ --region region_of_primary \ --global-cluster-identifier global_cluster_id \ --target-db-cluster-identifier arn_of_secondary_to_promote ``` Per Windows: ``` aws docdb switchover-global-cluster ^ --region region_of_primary ^ --global-cluster-identifier global_cluster_id ^ --target-db-cluster-identifier arn_of_secondary_to_promote ``` ------ ## Sblocco dello switchover o del failover di un cluster globale Gli switchover e i failover del cluster globale vengono bloccati quando non tutti i cluster regionali del cluster globale utilizzano la stessa versione del motore. Se le versioni non corrispondono, è possibile che venga visualizzato questo errore in risposta quando si richiama uno switchover o un failover: il cluster DB di destinazione specificato esegue una versione del motore con un livello di patch diverso rispetto al cluster DB di origine. Ti consigliamo di applicare regolarmente le versioni più recenti del motore per assicurarti di eseguire gli aggiornamenti più recenti per mantenere i cluster globali in uno stato integro. Per risolvere questo errore, aggiorna prima tutte le aree secondarie e poi l'area principale alla stessa versione del motore applicando eventuali azioni di manutenzione in sospeso. Per visualizzare le azioni di manutenzione in sospeso e applicare le modifiche necessarie per correggere il problema, segui le istruzioni in una delle seguenti schede: ------ #### [ Using the Console di gestione AWS ] Per sbloccare lo switchover o il failover di un cluster globale, è necessario determinare se vi sono azioni di manutenzione in sospeso per i cluster e applicarle. Segui questi passaggi per visualizzare e applicare le azioni di manutenzione: 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione scegliere **Cluster**. 1. **Nella tabella **Cluster**, individua il cluster globale nella colonna Cluster identifier.** Nel cluster globale, prendi nota di ogni cluster secondario e del cluster primario per il cluster globale specificato ed esegui i seguenti passaggi per ciascuno. 1. Per ogni cluster secondario: 1. Se è disponibile un aggiornamento per il cluster, viene indicato come **Disponibile**, **Obbligatorio** o **Finestra successiva** nella colonna **Manutenzione**. 1. Per eseguire un'azione, scegli il cluster per mostrarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**. 1. In **Descrizione**, se indica che è disponibile un «Nuovo aggiornamento di manutenzione», selezionalo e scegli **Applica ora**. 1. Per il tuo cluster principale: 1. Se è disponibile un aggiornamento per il cluster, viene indicato come **Disponibile**, **Obbligatorio** o **Finestra successiva** nella colonna **Manutenzione**. 1. Per eseguire un'azione, scegli il cluster per mostrarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**. 1. In **Descrizione**, se indica che è disponibile un «Nuovo aggiornamento di manutenzione», selezionalo e scegli **Applica ora**. ------ #### [ Using the AWS CLI ] Per sbloccare uno switchover o un failover globale del cluster, devi determinare se ci sono azioni di manutenzione in sospeso per il cluster e applicarle. Segui questi passaggi per visualizzare e applicare le azioni di manutenzione prima sui cluster secondari e poi sul cluster primario per il cluster globale: 1. Esegui quanto segue prima sul cluster regionale di ogni regione secondaria e poi per il cluster regionale della regione primaria. 1. Esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI con l'`--resource-identifier`opzione per determinare se sono disponibili azioni di manutenzione per il tuo cluster regionale Amazon DocumentDB. Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster. Per Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ``` Per Windows: ``` aws docdb describe-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ``` Il risultato è simile al seguente: ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2025-04-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2025-06-18T03:01:00Z", "AutoAppliedAfterDate": "2025-05-11T03:01:00Z" "OptInStatus": "pending" } ] } ] } ``` 1. Se è necessaria un'azione di manutenzione, esegui il comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI con le seguenti opzioni: + `--resource-identifier` + `--apply-action` + `--opt-in-type` + `--region` Negli esempi seguenti, sostituisci ciascuno di essi *user input placeholder* con le informazioni del tuo cluster. Per Linux, macOS o Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \ --apply-action system-update \ --opt-in-type immediate \ --region us-east-1 ``` Per Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^ --apply-action system-update ^ --opt-in-type immediate ^ --region us-east-1 ``` 1. Una volta completata l'azione di manutenzione, esegui nuovamente il [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)comando per assicurarti che non vi siano altre azioni in sospeso per il cluster. Il risultato che desideri è: ``` { "PendingMaintenanceActions": [] } ``` ------ #### [ Using the Amazon DocumentDB API ] Per sbloccare uno switchover o un failover globale del cluster, è necessario determinare se vi sono azioni di manutenzione in sospeso per il cluster e applicarle. Utilizza quanto segue per visualizzare e applicare le azioni APIs di manutenzione: 1. Esegui quanto segue prima sul cluster regionale di ogni regione secondaria e poi per il cluster regionale delle regioni primarie. 1. Chiama l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API per determinare se sono disponibili azioni di manutenzione per il tuo cluster globale Amazon DocumentDB. 1. Applica eventuali modifiche chiamando l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API. ------ # 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. # Gestione delle istanze di Amazon DocumentDB I seguenti argomenti forniscono informazioni per aiutarti a gestire le istanze di Amazon DocumentDB. Includono dettagli sulle classi e gli stati delle istanze e su come creare, eliminare e modificare un'istanza. **Topics** + [Determinazione dello stato di un'istanza](#db-instance-status) + [Ciclo di vita dell'istanza](db-instance-life-cycle.md) + [Gestione delle classi di istanze](db-instance-classes.md) + [Istanze supportate da NVMe](db-instance-nvme.md) ## Determinazione dello stato di un'istanza Per visualizzare gli stati validi di un'istanza, il loro significato e come determinare lo stato delle istanze, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). # Ciclo di vita delle istanze Amazon DocumentDB Il ciclo di vita di un'istanza Amazon DocumentDB include la creazione, la modifica, la manutenzione e l'aggiornamento, l'esecuzione di backup e ripristini, il riavvio e l'eliminazione dell'istanza. Questa sezione fornisce informazioni su come completare questi processi. **Topics** + [Aggiungere un'istanza](db-instance-add.md) + [Descrizione delle istanze](db-instance-view-details.md) + [Modifica di un'istanza](db-instance-modify.md) + [Riavvio di un'istanza](db-instance-reboot.md) + [Eliminazione di un'istanza](db-instance-delete.md) Puoi creare una nuova istanza di Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI Per aggiungere un'istanza a un cluster, il cluster deve essere nello stato *disponibile* . Non è possibile aggiungere un'istanza a un cluster arrestato. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi aggiungere un’istanza. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md). **Nota** Se crei un cluster Amazon DocumentDB utilizzando la console, contemporaneamente viene creata automaticamente un'istanza per te. Per creare altre istanze, utilizza una delle procedure riportate di seguito. # Aggiungere un'istanza Amazon DocumentDB a un cluster ------ #### [ Using the Console di gestione AWS ] Utilizza la seguente procedura per creare un'istanza per il tuo cluster utilizzando la console 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. Per scegliere il cluster a cui aggiungere un'istanza, seleziona il pulsante a sinistra del nome del cluster. 1. Scegli **Actions (Operazioni)**, quindi **Add instance (Aggiungi istanza)**. 1. Nella pagina **Add instance to: (Aggiungi istanza a:)** ripetere i seguenti passaggi per ogni istanza che si desidera aggiungere al cluster. Puoi averne fino a 15. 1. **Identificatore dell'istanza**: puoi inserire un identificatore univoco per questa istanza o consentire ad Amazon DocumentDB di fornire l'identificatore dell'istanza basato sull'identificatore del cluster. Vincoli per la denominazione di un'istanza: + 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 tutte le istanze in Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS 1. **Classe di istanza**: dall'elenco a discesa, scegli il tipo di istanza che desideri per questa istanza. 1. **Livello di promozione**: dall'elenco a discesa, scegli il livello di promozione per la tua istanza o scegli *Nessuna preferenza* per consentire ad Amazon DocumentDB di impostare il livello di promozione per la tua istanza. Un numero minore indica una priorità più elevata. Per ulteriori informazioni, consulta [Controllo della destinazione del failover](failover.md#failover-target_control). 1. Per aggiungere ulteriori istanze, scegliere **Add additional instances (Aggiungi istanze aggiuntive)** e ripetere i passaggi a, b e c. 1. Terminare l'operazione. + Per aggiungere istanze al cluster, scegliere **Crea**. + Per annullare l'operazione, scegli **Cancel (Annulla)**. La creazione dell'istanza richiede diversi minuti. Puoi usare la console o AWS CLI visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Utilizza l'`create-db-instance` AWS CLI operazione con i seguenti parametri per creare l'istanza principale per il tuo cluster. + **--db-instance-class**: obbligatorio. La capacità di calcolo e di memoria dell'istanza, ad esempio `db.m4.large`. Non tutte le classi di istanze sono disponibili in tutte Regioni AWS. + **--db-instance-identifier**: obbligatorio. Una stringa di lettere minuscole che identifica l'istanza. Vincoli per la denominazione di un'istanza: + 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 tutte le istanze in Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS + **--engine**: obbligatorio. Deve essere `docdb`. + **--availability-zone**— Facoltativo. La zona di disponibilità in cui verrà creata l'istanza. Utilizza questo parametro per trovare le istanze in diverse zone di disponibilità per aumentare la tolleranza ai guasti. Per ulteriori informazioni, consulta [Amazon DocumentDB Disponibilità e replica elevate](replication.md). + **--promotion-tier**— Facoltativo. Il livello di priorità di failover per l'istanza. Il valore deve essere compreso tra 0 e 15 con i numeri più bassi che corrispondono a una priorità maggiore. Per ulteriori informazioni, consulta [Controllo della destinazione del failover](failover.md#failover-target_control). 1. **Innanzitutto, determina in quali zone di disponibilità puoi creare l'istanza. ** Se desideri specificare la zona di disponibilità prima di creare l'istanza, esegui il comando seguente per determinare quali zone di disponibilità sono disponibili per il tuo cluster Amazon DocumentDB. Per Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` Per Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` [ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] ``` 1. **In secondo luogo, determina quali classi di istanza puoi creare nella regione. ** Per determinare le classi di istanze disponibili nella tua regione, esegui il comando seguente. Dall'output, scegli una classe di istanza per l'istanza che desideri aggiungere al tuo cluster Amazon DocumentDB. Per Linux, macOS o Unix: ``` aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` Per Windows: ``` aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` [ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] ``` 1. **Infine, aggiungi un'istanza al tuo cluster Amazon DocumentDB.** Per aggiungere un'istanza al tuo cluster Amazon DocumentDB, esegui il comando seguente. Per Linux, macOS o Unix: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb ``` Per Windows: ``` aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2" } } ``` La creazione dell'istanza richiede diversi minuti. Puoi usare la console o AWS CLI visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Descrizione delle istanze di Amazon DocumentDB Puoi utilizzare la console di gestione di Amazon DocumentDB o visualizzare dettagli come endpoint di connessione, gruppi di sicurezza, autorità di certificazione e gruppi VPCs di parametri relativi alle tue istanze di Amazon DocumentDB. AWS CLI ------ #### [ Using the Console di gestione AWS ] Per visualizzare i dettagli delle istanze utilizzando la Console di gestione AWS, segui la procedura riportata di seguito. 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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Nell'elenco delle istanze, scegli il nome dell'istanza di cui desideri visualizzarne i dettagli. Le informazioni sull'istanza sono organizzate nei seguenti raggruppamenti: + **Riepilogo**: informazioni generali sull'istanza, tra cui la versione del motore, la classe, lo stato e qualsiasi manutenzione in sospeso. + **Connettività e sicurezza**: la sezione **Connect** elenca gli endpoint di connessione per connettersi a questa istanza con la shell mongo o con un'applicazione. Nella sezione **Security Groups (Gruppi di sicurezza)** sono elencati i gruppi di sicurezza associati a questa istanza, l'ID VPC e le descrizioni. + **Configurazione**: la sezione **Dettagli** elenca le configurazioni e lo stato dell'istanza, inclusi l'Amazon Resource Name (ARN), l'endpoint, il ruolo, la classe e l'autorità di certificazione dell'istanza. Vengono inoltre elencate le impostazioni di sicurezza e di rete dell'istanza e le informazioni di backup. La sezione **Cluster details (Dettagli cluster)** elenca i dettagli del cluster a cui appartiene questa istanza. La sezione **Istanze del cluster** elenca tutte le istanze che appartengono al cluster con lo stato del ruolo e del gruppo di parametri del cluster di ogni istanza. **Nota** Puoi modificare il cluster associato all'istanza selezionando **Modify (Modifica)** accanto all'intestazione **Cluster details (Dettagli cluster)** . Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). + **Monitoraggio**: i parametri dei CloudWatch log per questa istanza. 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 questa istanza. 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. Per ulteriori informazioni, consulta [Etichettatura delle risorse di Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Per visualizzare i dettagli delle tue istanze di 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_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.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. 1. **Elenca tutte le istanze di Amazon DocumentDB.** Il AWS CLI codice seguente elenca i dettagli per tutte le istanze di Amazon DocumentDB in una regione. Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` Per Windows: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` 1. **Elenca tutti i dettagli per un'istanza Amazon DocumentDB specificata** Il codice seguente consente di elencare i dettagli per `sample-cluster-instance`. Se includi il parametro `--db-instance-identifier` nel nome di un'istanza, puoi limitare l’output alle sole informazioni su quella specifica istanza. Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Per Windows: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstances": [ { "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM", "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "DBInstanceClass": "db.r5.large", "DBInstanceStatus": "creating", "AutoMinorVersionUpgrade": true, "PreferredMaintenanceWindow": "fri:09:32-fri:10:02", "BackupRetentionPeriod": 1, "StorageEncrypted": true, "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "AvailabilityZone": "us-east-1a", "Engine": "docdb", "PromotionTier": 2, "DBInstanceIdentifier": "sample-cluster-instance", "PreferredBackupWindow": "00:00-00:30", "PubliclyAccessible": false, "DBSubnetGroup": { "DBSubnetGroupName": "default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-b3806e8f", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete" }, "PendingModifiedValues": {}, "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b" } ] } ``` ------ # Modifica di un'istanza Amazon DocumentDB Puoi modificare la tua istanza di Amazon DocumentDB utilizzando Console di gestione AWS o. AWS CLI Per modificare un'istanza, questa deve essere nello stato *disponibile* . Non è possibile modificare un'istanza arrestata. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che l’istanza 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 ] Per modificare un'istanza specifica di Amazon DocumentDB utilizzando la console, completa i seguenti passaggi. 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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Seleziona la casella a sinistra dell'istanza che desideri modificare. 1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**. 1. Nel riquadro **Modify instance: (Modifica istanza: instance-name)** apporta le modifiche desiderate. È possibile apportare le seguenti modifiche. + **Specifiche dell'istanza**: l'identificatore e la classe dell'istanza. Vincoli di denominazione dell'identificatore di istanza: + **Identificatore dell'istanza**: inserisci un nome univoco per tutte le istanze di tua proprietà Account AWS nell'area corrente. L'identificatore di istanza deve contenere [1—63] caratteri alfanumerici o trattini, avere una lettera come primo carattere e non può terminare con un trattino o contenere due trattini consecutivi. + **Classe di istanza**: dal menu a discesa, seleziona una classe di istanza per la tua istanza Amazon DocumentDB. Per ulteriori informazioni, consulta [Gestione delle classi di istanze](db-instance-classes.md). + **Autorità di certificazione: certificato** del server per questa istanza. Per ulteriori informazioni, consulta [Aggiornamento dei certificati TLS di Amazon DocumentDB](ca_cert_rotation.md). + **Failover**: durante il failover, l'istanza con il livello di promozione più alto verrà promossa a principale. Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md). + **Manutenzione**: la finestra di manutenzione in cui le modifiche o le patch in sospeso vengono applicate alle istanze del cluster. 1. Al termine, scegli **Continue (Continua)** per visualizzare un riepilogo delle modifiche. 1. Dopo aver verificato le modifiche, è possibile applicarle immediatamente o durante la successiva finestra di manutenzione in **Scheduling of modifications (Pianificazione delle modifiche)**. Scegli **Instance (Modifica istanza)** per salvare le modifiche. In alternativa, puoi selezionare **Cancel (Annulla)** per eliminare le modifiche. L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Per modificare un'istanza specifica di Amazon DocumentDB utilizzando il AWS CLI, utilizza `modify-db-instance` i seguenti parametri. Per ulteriori informazioni, consulta [Modify. DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html) Il codice seguente modifica la classe di istanza in `db.r5.large` per l'istanza `sample-instance`. **Parameters** + **--db-instance-identifier**: obbligatorio. L'identificatore dell'istanza da modificare. + **--db-instance-class**— Facoltativo. La nuova capacità di calcolo e memoria dell'istanza, `db.r5.large` ad esempio. Non tutte le classi di istanze sono disponibili in tutte Regioni AWS. Se si modifica la classe dell'istanza, si verifica un'interruzione durante la modifica. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che non `ApplyImmediately` sia specificata come true per questa richiesta. + **--apply-immediately**o **--no-apply-immediately** — Facoltativo. Specifica se questa modifica debba essere applicata subito o alla prossima finestra di manutenzione. Se questo parametro viene omesso, la modifica viene eseguita durante la finestra di manutenzione successiva. **Example** Per Linux, macOS o Unix: ``` aws docdb modify-db-instance \ --db-instance-identifier sample-instance \ --db-instance-class db.r5.large \ --apply-immediately ``` Per Windows: ``` aws docdb modify-db-instance ^ --db-instance-identifier sample-instance ^ --db-instance-class db.r5.large ^ --apply-immediately ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstances": [ { "DBInstanceIdentifier": "sample-instance-1", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "modifying", "Endpoint": { "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-01-10T22:18:55.921Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1a", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:10:57-sun:11:27", "PendingModifiedValues": { "DBInstanceClass": "db.r5.large" }, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1", "EnabledCloudwatchLogsExports": [ "profiler" ] } ] } ``` L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. È possibile monitorare lo stato dell'istanza utilizzando Console di gestione AWS o AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Riavvio di un'istanza Amazon DocumentDB Occasionalmente, potrebbe essere necessario riavviare l'istanza di Amazon DocumentDB, di solito per motivi di manutenzione. Se apporti alcune modifiche, ad esempio la modifica del gruppo di parametri del cluster associato a un cluster, devi riavviare le istanze del cluster affinché le modifiche abbiano effetto. È possibile riavviare un'istanza specificata utilizzando o il Console di gestione AWS . AWS CLI Il riavvio di un'istanza comporta il riavvio del servizio del motore di database. Il riavvio comporta un'interruzione temporanea, durante la quale lo stato dell'istanza viene impostato `rebooting`. Un evento Amazon DocumentDB viene creato al termine del riavvio. Il riavvio di un'istanza non comporta un failover. Per eseguire il failover di un cluster Amazon DocumentDB, usa Console di gestione AWS l'operazione o AWS CLI . `failover-db-cluster` Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md). Non puoi riavviare l'istanza se il suo stato non è *disponibile*. Il database può non essere disponibile per diversi motivi, ad esempio una modifica richiesta in precedenza o un'operazione della finestra di manutenzione. Per ulteriori informazioni sugli stati delle istanze, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the Console di gestione AWS ] La procedura seguente riavvia un'istanza specificata 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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Seleziona la casella a sinistra dell'istanza che desideri riavviare. 1. Scegli **Actions (Operazioni)**, scegli **Reboot (Riavvia)** e quindi **Reboot (Riavvia)** per confermare il riavvio. Per il riavvio dell'istanza sono necessari alcuni minuti. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Per riavviare un'istanza Amazon DocumentDB, utilizza l'operazione con `reboot-db-instance` `--db-instance-identifier` il parametro. Questo parametro specifica l'identificatore per l'istanza da riavviare. Il codice seguente riavvia l'istanza `sample-instance`. **Example** Per Linux, macOS o Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-instance ``` Per Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-instance ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "rebooting", "Endpoint": { "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` Per il riavvio dell'istanza sono necessari alcuni minuti. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Eliminazione di un'istanza Amazon DocumentDB Puoi eliminare la tua istanza di Amazon DocumentDB utilizzando Console di gestione AWS o. AWS CLI Per eliminare un'istanza, questa deve essere nello stato *disponibile*. Non è possibile eliminare un'istanza arrestata. Se il cluster Amazon DocumentDB che contiene l'istanza viene interrotto, avvia prima il cluster, attendi che l'istanza diventi *disponibile*, quindi elimina l'istanza. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md). **Nota** Amazon DocumentDB archivia tutti i dati nel volume del cluster. I dati persistono nel volume cluster, anche se rimuovi tutte le istanze dal cluster. Se hai bisogno di accedere nuovamente ai dati, puoi aggiungere un'istanza al cluster in qualsiasi momento e riprendere da dove avevi lasciato. ------ #### [ Using the Console di gestione AWS ] La procedura seguente elimina un'istanza Amazon DocumentDB specificata 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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Seleziona la casella a sinistra dell'istanza che desideri eliminare. 1. Scegli **Actions (Operazioni)**, quindi **Delete (Elimina)**. 1. Se stai eliminando l'ultima istanza nel cluster: + **Create final cluster snapshot? (Crea la snapshot del cluster finale?)** — Scegliete **Sì** se desiderate creare un'istantanea finale prima dell'eliminazione del cluster. Altrimenti, scegli **No**. + **Nome dell'istantanea finale**: se scegli di creare un'istantanea finale, inserisci l'identificatore dell'istantanea del cluster della nuova istantanea del cluster creata. + **Delete instance? (Elimina istanza ?)** — Inserisci la frase **delete entire cluster** nel campo per confermare l'eliminazione. 1. Se non stai eliminando l'ultima istanza nel cluster: + **Delete instance? (Elimina istanza ?)** — Inserisci la frase **delete me** nel campo per confermare l'eliminazione. 1. Seleziona **Delete (Elimina)** per eliminare l'istanza. Sono necessari alcuni minuti per l'eliminazione dell'istanza. Per monitorare lo stato di un'istanza, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] La procedura seguente elimina un'istanza di Amazon DocumentDB utilizzando. AWS CLI 1. **Innanzitutto, determina quante istanze ci sono nel tuo cluster Amazon DocumentDB:** Per determinare il numero di istanze presenti nel cluster, esegui il comando `describe-db-clusters` come indicato di seguito. ``` 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. ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` 1. **Se nel cluster Amazon DocumentDB sono presenti più di un'istanza:** Per eliminare un'istanza Amazon DocumentDB specificata, usa il `delete-db-instance` comando con il `--db-instance-identifier` parametro, come illustrato di seguito. Sono necessari alcuni minuti per l'eliminazione dell'istanza. Per monitorare lo stato di un'istanza, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md). ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance-2 ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "deleting", "Endpoint": { "Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` 1. **Se l'istanza che desideri eliminare è l'ultima istanza del tuo cluster Amazon DocumentDB:** Se elimini l'ultima istanza in un cluster Amazon DocumentDB, elimini anche quel cluster e gli snapshot automatici e i backup continui associati a quel cluster. Per eliminare l'ultima istanza del cluster, puoi eliminare il cluster e, facoltativamente, creare uno snapshot finale. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md). ------ ## Protezione da eliminazione L'eliminazione dell'ultima istanza di un cluster Amazon DocumentDB comporta anche l'eliminazione del cluster, nonché gli snapshot automatici e i backup continui associati a tale cluster. Amazon DocumentDB applica la protezione da eliminazione per un cluster indipendentemente dal fatto che l'operazione di eliminazione venga eseguita utilizzando o il Console di gestione AWS . 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. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md). # Gestione delle classi di istanze La classe di istanza determina la capacità di calcolo e memoria di un'istanza Amazon DocumentDB (con compatibilità con MongoDB). La classe di istanza di cui hai bisogno dipende dai requisiti in termini di potenza di elaborazione e memoria. Amazon DocumentDB supporta le famiglie di classi di istanze R4, R5, R6G, R8G, T3 e T4G. ovvero classi di istanze della generazione attuale ottimizzate per applicazioni a elevato utilizzo di memoria. Per le specifiche relative a tali classi, consulta [Specifiche della classe di istanza](#db-instance-class-specs). **Topics** + [Determinare una classe di istanza](#db-instance-class-determining) + [Modifica della classe di un'istanza](#db-instance-class-changing) + [Classi di istanza supportate per regione](#db-instance-classes-by-region) + [Specifiche della classe di istanza](#db-instance-class-specs) ## Determinare una classe di istanza Per determinare la classe di un'istanza, è possibile utilizzare l'`describe-db-instances` AWS CLI operazione Console di gestione AWS o. ------ #### [ Using the Console di gestione AWS ] Per determinare la classe di istanza per le istanze del cluster, completa i seguenti passaggi nella 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, scegli **Clusters** per trovare l'istanza che ti interessa. **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 casella di navigazione Clusters, vedrai la colonna **Cluster** Identifier. Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra come un'istanza viene annidata in un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Nell'elenco delle istanze, espandi il cluster per trovare le istanze che ti interessano. Trova l'istanza che desideri. Quindi, guarda la colonna **Size** della riga dell'istanza per vedere la sua classe di istanza. Nell'immagine seguente, la classe per l'istanza `robo3t` è `db.r5.4xlarge`. ![\[Elenco delle istanze nella tabella Clusters con la colonna Size che mostra il tipo di istanza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-class.png) ------ #### [ Using the AWS CLI ] Per determinare la classe di un'istanza utilizzando il AWS CLI, utilizzate l'`describe-db-instances`operazione con i seguenti parametri. + **--db-instance-identifier**— Facoltativo. Specifica l'istanza della quale desideri trovare la classe. Se questo parametro viene omesso, `describe-db-instances` restituisce una descrizione per un massimo di 100 istanze. + **--query**— Facoltativo. Specifica i membri dell'istanza da includere nei risultati. Se questo parametro viene omesso, vengono restituiti tutti i membri dell'istanza. **Example** L'esempio seguente trova il nome e la classe dell'istanza`sample-instance-1`. Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --db-instance-identifier sample-instance-1 ``` Per Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --db-instance-identifier sample-instance-1 ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` [ [ "sample-instance-1", "db.r5.large" ] ``` **Example** L'esempio seguente trova il nome e la classe dell'istanza per un massimo di 100 istanze di Amazon DocumentDB. Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --filter Name=engine,Values=docdb ``` Per Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --filter Name=engine,Values=docdb ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` [ [ "sample-instance-1", "db.r5.large" ], [ "sample-instance-2", "db.r5.large" ], [ "sample-instance-3", "db.r5.4xlarge" ], [ "sample-instance-4", "db.r5.4xlarge" ] ] ``` Per ulteriori informazioni, consulta [Descrizione delle istanze di Amazon DocumentDB](db-instance-view-details.md). ------ ## Modifica della classe di un'istanza È possibile modificare la classe di istanza dell'istanza utilizzando Console di gestione AWS o il AWS CLI. Per ulteriori informazioni, consulta [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md). ## Classi di istanza supportate per regione Amazon DocumentDB supporta le seguenti classi di istanze: + `R8G`—Istanze ottimizzate per la memoria di ultima generazione basate su processori AWS Graviton4 basati su ARM che offrono prestazioni fino al 30% migliori rispetto alle istanze R6G. + `R6G`—Istanze ottimizzate per la memoria alimentate da processori AWS Graviton2 basati su ARM che offrono prestazioni fino al 30% migliori rispetto alle istanze R5 a un costo inferiore del 5%. + `R6GD`—Istanze R6G ottimizzate per la memoria con storage Solid-State Drive (SSD) basato su memoria non volatile locale per dati effimeri. NVMe + `R5`—Istanze ottimizzate per la memoria che offrono prestazioni fino al 100% migliori rispetto alle istanze R4 allo stesso costo delle istanze. + `R4`—Generazione precedente di istanze ottimizzate per la memoria. + `T4G`—Tipo di istanza generica, sostenibile e a basso costo di ultima generazione, alimentata da processori AWS Graviton2 basati su ARM che fornisce un livello base di prestazioni della CPU, offre un rapporto prezzo/prestazioni fino al 35% migliore rispetto alle istanze T3 ed è ideale per l'esecuzione di applicazioni con un utilizzo moderato della CPU che presentano picchi temporanei di utilizzo. + `T3`—Tipo di istanza generica espandibile a basso costo che fornisce un livello base di prestazioni della CPU con la possibilità di aumentare l'utilizzo della CPU in qualsiasi momento per tutto il tempo necessario. Per specifiche dettagliate relative alle classi di istanze, consulta [Specifiche della classe di istanza](#db-instance-class-specs). **Nota** Lo storage ottimizzato per l'I/O è disponibile solo nelle versioni 5.0 e 8.0 del motore (cluster basati su istanze). Una particolare classe di istanza può essere supportata o meno in una determinata regione. La tabella seguente specifica quali classi di istanze sono supportate da Amazon DocumentDB in ciascuna regione. **Classi di istanze supportate per regione** | | Classi di istanza | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Serverless | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Stati Uniti orientali (Ohio) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata | | Stati Uniti orientali (Virginia settentrionale) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata | | Stati Uniti occidentali (Oregon) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata | | Africa (Città del Capo) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Sud America (San Paolo) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Hong Kong) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Hyderabad) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Malesia) | | | Supportata | | | Supportato | Supportata | | | Asia Pacifico (Mumbai) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Osaka) | | Supportata | Supportato | Supportato | | Supportato | Supportata | | | Asia Pacifico (Seul) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Sydney) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Giacarta) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportata | | | Asia Pacifico (Melbourne) | | | Supportata | Supportato | | Supportato | Supportata | | | Asia Pacifico (Singapore) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Asia Pacifico (Thailandia) | | | Supportata | | | Supportato | Supportata | | | Asia Pacifico (Tokyo) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Canada (Centrale) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | | Europa (Francoforte) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Europa (Zurigo) | | Supportata | Supportato | Supportato | | Supportato | Supportata | | | Europa (Irlanda) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata | | Europa (Londra) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | | Europa (Milano) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Europa (Parigi) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | | Europa (Spagna) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | Europa (Stoccolma) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportata | | | Messico (centrale) | | | Supportata | | | Supportato | Supportata | | | Medio Oriente (Emirati Arabi Uniti) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Cina (Pechino) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | | Cina (Ningxia) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | Israele (Tel Aviv) | | | Supportata | Supportato | | Supportato | Supportato | Supportata | | AWS GovCloud (Stati Uniti occidentali) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata | | AWS GovCloud (Stati Uniti orientali) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata | ## Specifiche della classe di istanza La tabella seguente fornisce dettagli sulle classi di istanze di Amazon DocumentDB, inclusi i tipi di istanza supportati in ciascuna classe. Puoi trovare spiegazioni su ogni colonna della tabella nella sezione sotto la tabella. | Classe di istanza | vCPU1 | Memoria (GiB) 2 | NVMe Cache SSD su più livelli (GiB) 3 | Temperatura massima di archiviazione (GiB) 4 | Larghezza di banda base/burst (Gbps) 5 | Motori di supporto 6 | | --- | --- | --- | --- | --- | --- | --- | | R8G — Classe di istanza ottimizzata per la memoria di attuale generazione basata su Graviton4 R8G è la famiglia di istanze più recente (Graviton4), disponibile solo nelle versioni del motore 5.0 e 8.0. Le dimensioni db.r8g.24xlarge e db.r8g.48xlarge non sono ancora disponibili. | | db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 e 8.0.0 | | db.r8g.xlarge | 4 | 32 | - | 60 | 1,875/12,5 | 5.0.0 e 8.0.0 | | db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 e 8.0.0 | | db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 e 8.0.0 | | db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 e 8.0.0 | | db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 e 8.0.0 | | db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 e 8.0.0 | | R6G — Classe di istanza ottimizzata per la memoria di ultima generazione basata su Graviton2 | | db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.2xlarge | 8 | 64 | - | 126 | 2,5/10 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.4xlarge | 16 | 128 | - | 252 | 5,0/10 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 e 8.0.0 | | db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 e 8.0.0 | | R6GD — Classe di istanza supportata dalla generazione attuale basata su Graviton2 NVMe | | db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 e 8.0.0 | | db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/10 | 5.0.0 e 8.0.0 | | db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/10 | 5.0.0 e 8.0.0 | | db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 e 8.0.0 | | db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 e 8.0.0 | | db.r6gd.16xlarge | 64 | 512 | 2776 | 1.024 | 25 | 5.0.0 e 8.0.0 | | R5 — Classe di istanza ottimizzata per la memoria della generazione precedente | | db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.2xlarge | 8 | 64 | - | 124 | 2,5/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.4xlarge | 16 | 128 | - | 249 | 5,0/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | R4 — Classe di istanza ottimizzata per la memoria della generazione precedente Le istanze R4 sono supportate solo nella versione 3.6 del motore. Tieni presente che Amazon DocumentDB 3.6 raggiungerà la fine del supporto standard il 30 marzo 2026. L'Extended Support (a pagamento) è disponibile fino a marzo 2029. | | db.r4.large | 2 | 15,25 | - | 30 | 0,75/10 | Solo 3.6.0 | | db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | Solo 3.6.0 | | db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | solo 3.6.0 | | db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | solo 3.6.0 | | db.r4.8xlarge | 32 | 244 | - | 480 | 10 | solo 3.6.0 | | db.r4.16xlarge | 64 | 488 | - | 960 | 25 | solo 3.6.0 | | T4G: classi di istanze Burstable Performance di ultima generazione basate su Graviton2 Le istanze della serie T funzionano in modalità Unlimited CPU burst. L'utilizzo prolungato oltre la linea di base viene fatturato a parte. Non supportato per Global Clusters. | | db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0 e 8.0.0 | | T3: classi di istanze Burstable Performance della generazione precedente | | db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-instance-classes.html) | # Istanze supportate da NVMe NVMele istanze supportate da -backed offrono prestazioni di query fino a 7 volte più veloci per applicazioni con set di dati di grandi dimensioni che superano la memoria di un'istanza normale. Queste istanze sfruttano lo storage Solid-State Drive (SSD) basato su memoria non volatile locale basato su Express (NVMe) disponibile sulle istanze r6gd per archiviare dati effimeri, ridurre l'accesso allo storage basato sulla rete e migliorare la latenza di lettura e il throughput. Lo spazio SSD locale è diviso in due sezioni: + **Cache a più livelli**: circa il 73% dell'SSD locale viene allocato come cache del database, il che consente al sistema di archiviare fino a cinque volte più pagine del database rispetto alla sola memoria principale. L'SSD locale funge da cache di secondo livello, mentre la cache buffer in memoria esistente rimane la cache di primo livello. La query accede alla memoria esterna solo se si verifica un errore sia nella cache buffer che nella cache SSD. + **Archiviazione temporanea**: il restante 27% è riservato all'archiviazione temporanea di file non persistente, utilizzata per query complesse che implicano operazioni di ordinamento o che richiedono molte risorse come la creazione di indici. Nelle istanze normali, lo spazio temporaneo risiede su un volume Amazon Elastic Block Store (EBS). Lo storage temporaneo ospitato localmente sull'SSD riduce la latenza delle query e degli ordinamenti fino a due volte e accelera le operazioni che richiedono molte risorse come la creazione di indici. I dettagli riguardanti il tipo di istanze NVMe supportate e le relative specifiche sono disponibili in. [Specifiche della classe di istanza](db-instance-classes.md#db-instance-class-specs) **Topics** + [Casi d'uso consigliati per le istanze supportate da NVMe](#nvme-use-cases) + [Utilizzo di istanze NVMe supportate con Amazon DocumentDB](#using-nvme) + [Monitoraggio delle istanze supportate da NVMe](#monitoring-nvme) ## Casi d'uso consigliati per le istanze supportate da NVMe Ti consigliamo di utilizzare istanze NVMe supportate da backup nei seguenti scenari: + **Carichi di lavoro con elevata intensità di lettura**: se il carico di lavoro richiede un'intensa attività di lettura e il set di dati è più grande della cache buffer, indicata da parametri bassi `BufferCacheHitRatio` e alti, le istanze supportate da backup possono offrire vantaggi in termini di prestazioni. `ReadIOPS` NVMe + **Carichi di lavoro con un elevato numero di aggiornamenti: se il carico di lavoro** richiede un uso intensivo degli aggiornamenti e Garbage Collection non riesce a tenere il passo a causa della latenza di lettura sullo storage di rete, le istanze supportate da backup potrebbero contribuire a mitigare il problema. NVMe NVMele istanze supportate da -backed possono essere utili per diversi casi d'uso, tra cui: + **Applicazioni su scala Internet: applicazioni** come l'elaborazione dei pagamenti, la fatturazione e il commercio elettronico con rigorosi accordi sui livelli di servizio (SLAs) possono sfruttare i vantaggi prestazionali delle istanze supportate da backup. NVMe + Dashboard di **reporting in tempo reale: le dashboard** che eseguono centinaia di query per la raccolta di metriche e dati possono trarre vantaggio dalla bassa latenza e dall'elevato throughput delle istanze supportate. NVMe + **Applicazioni AI generative: le applicazioni** che utilizzano la ricerca vettoriale per trovare i vicini esatti o più vicini in milioni di incorporamenti vettoriali possono sfruttare le elevate prestazioni delle istanze supportate. NVMe ## Utilizzo di istanze NVMe supportate con Amazon DocumentDB Per utilizzare istanze NVMe supportate da Amazon DocumentDB: + Crea un cluster Amazon DocumentDB e aggiungi una delle classi di istanze NVMe supportate. Per ulteriori informazioni, consulta [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md). + In alternativa, modifica un cluster Amazon DocumentDB esistente per utilizzare una delle classi di istanze NVMe supportate. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). Per verificare la disponibilità di istanze NVMe supportate da backup in diverse AWS regioni, consulta. [Classi di istanza supportate per regione](db-instance-classes.md#db-instance-classes-by-region) Se desideri tornare da un'istanza supportata da NVMe backup a un'istanza normale, modifica la classe di istanza di database della tua istanza Amazon DocumentDB con una classe di istanza simile senza NVMe lo storage. Ad esempio, se la classe di istanza corrente è 'db.r6gd.4xlarge', scegli 'db.r6g.4xlarge' per tornare indietro. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). ## Monitoraggio delle istanze supportate da NVMe Oltre ai normali parametri delle istanze disponibili in Amazon CloudWatch, le istanze NVMe supportate emettono parametri aggiuntivi specifici per lo storage SSD, gli IOPS e il NVMe throughput basati su SSD. ``` NVMeStorageCacheHitRatio FreeNVMeStorage ReadIOPSNVMeStorage ReadLatencyNVMeStorage ReadThroughputNVMeStorage WriteIOPSNVMeStorage WriteLatencyNVMeStorage WriteThroughputNVMeStorage ``` Per ulteriori informazioni su queste metriche, consulta [NVMe-metriche delle istanze supportate](cloud_watch.md#nvme-metrics) # Gestione dei sottogruppi di sottoreti Amazon DocumentDB Un cloud privato virtuale (VPC) è una rete virtuale dedicata al tuo. Account AWSÈ logicamente isolato dalle altre reti virtuali nel AWS cloud. Puoi avviare AWS le tue risorse, come i cluster Amazon DocumentDB, nel tuo Amazon VPC. Puoi specificare un intervallo di indirizzi IP per il VPC, aggiungere sottoreti, associare gruppi di sicurezza e configurare tabelle di routing. Una sottorete è un intervallo di indirizzi IP nel tuo Amazon VPC. Puoi avviare AWS risorse in una sottorete specificata. Utilizza una sottorete *pubblica* per le risorse che devono essere connesse a Internet. Utilizza una sottorete *privata* per le risorse che non saranno connesse a Internet. Per ulteriori informazioni sulle sottoreti pubbliche e private, consulta [VPC e Subnet Basics](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) nella *Amazon* Virtual Private Cloud User Guide. Un gruppo di sottoreti del database è una raccolta di sottoreti creata in un VPC, che è possibile indicare per i cluster. Un gruppo di sottoreti consente di specificare un determinato VPC quando si creano i cluster. Se usi il gruppo di sottoreti `default`, esso include tutte le sottoreti nel VPC. Ogni gruppo di sottoreti database dovrebbe avere almeno due zone di disponibilità in una data regione . Quando si crea un cluster DB in un VPC, è necessario selezionare un gruppo di sottoreti DB. Amazon DocumentDB utilizza quel gruppo di sottoreti DB e la tua zona di disponibilità preferita per selezionare una sottorete e un indirizzo IP all'interno di quella sottorete da associare al cluster. Se l'istanza primaria fallisce, Amazon DocumentDB può promuovere un'istanza di replica corrispondente come nuova istanza primaria. È possibile creare una nuova istanza di replica usando un indirizzo IP della sottorete in cui si trovava l'istanza primaria precedente. Quando Amazon DocumentDB crea un'istanza in un VPC, assegna un'interfaccia di rete al cluster utilizzando un indirizzo IP selezionato dal gruppo di sottoreti DB. È consigliabile utilizzare il nome DNS, perché l'indirizzo IP sottostante può variare durante il failover. Per ulteriori informazioni, consulta [Endpoint Amazon DocumentDB](how-it-works.md#how-it-works.endpoints). Per informazioni sulla creazione di VPC e sottoreti personalizzati, consulta [Working with VPCs and Subnet nella *Amazon* Virtual Private](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) Cloud User Guide. **Topics** + [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md) + [Descrizione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-describe.md) + [Modifica di un gruppo di sottoreti Amazon DocumentDB](document-db-subnet-group-modify.md) + [Eliminazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-delete.md) # Creazione di un sottogruppo di Amazon DocumentDB Quando crei un cluster Amazon DocumentDB, devi scegliere un Amazon VPC e il gruppo di sottoreti corrispondente all'interno di quel cluster Amazon VPC per avviare il cluster. Le sottoreti determinano la zona di disponibilità e l'intervallo di IP all'interno della zona di disponibilità che desideri utilizzare per avviare un'istanza. Un gruppo di sottoreti è un insieme denominato di sottoreti (or AZs) che consente di specificare le zone di disponibilità da utilizzare per avviare le istanze di Amazon DocumentDB. Ad esempio, in un cluster con tre istanze, si consiglia di eseguire il provisioning di ciascuna istanza separatamente, in modo da ottimizzare l'elevata disponibilità. AZs Pertanto, se una singola AZ fallisce, avrà effetto solo su una singola istanza. Attualmente, le istanze di Amazon DocumentDB possono essere fornite in un massimo di tre. AZs Anche se un gruppo di sottoreti ha più di tre sottoreti, potrai utilizzarne solo tre per creare un cluster Amazon DocumentDB. Pertanto, quando crei un gruppo di sottoreti, ti consigliamo di scegliere solo le tre sottoreti di cui desideri distribuire le istanze. Ad esempio: viene creato un cluster e Amazon DocumentDB sceglie AZs \$11A, 1B e 1C\$1. Se tenti di creare un'istanza in AZ \$11D\$1 la chiamata API non riuscirà. Tuttavia, se scegli di creare un'istanza, senza specificare la particolare AZ, Amazon DocumentDB sceglierà una AZ per tuo conto. Amazon DocumentDB utilizza un algoritmo per bilanciare il carico delle istanze AZs per aiutarti a raggiungere un'elevata disponibilità. Se viene effettuato il provisioning di tre istanze, per impostazione predefinita, verrà eseguito il provisioning su tre istanze AZs e non verrà eseguito il provisioning tutte in un'unica AZ. Best practice + A meno che non si abbia un motivo specifico, creare sempre un gruppo di sottoreti con tre sottoreti. Ciò garantisce che i cluster con tre o più istanze saranno in grado di raggiungere una maggiore disponibilità man mano che le istanze verranno fornite su tre. AZs + Distribuisci sempre le istanze su più AZs istanze per ottenere un'elevata disponibilità. Non posizionare mai tutte le istanze di un cluster in una singola AZ. + 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 AZ. ## Come creare un gruppo di sottoreti Puoi usare Console di gestione AWS o AWS CLI per creare un sottogruppo di Amazon DocumentDB: ------ #### [ Using the Console di gestione AWS ] Utilizza i seguenti passaggi per creare un sottogruppo di Amazon DocumentDB. **Per creare un sottogruppo di 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. Dal riquadro di navigazione, scegliere **Subnet group (Gruppo di sottoreti)**, quindi scegliere **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. Dalla pagina **Create subnet group (Crea gruppo di sottorete)**: 1. Nella sezione **Subnet group details (Dettagli del gruppo di sottoreti)**: 1. **Nome**: inserisci un nome significativo per il gruppo di sottoreti. 1. **Descrizione**: immettere una descrizione del gruppo di sottoreti. 1. Nella sezione **Add subnets (Aggiungi sottoreti)**: 1. **VPC**: nell'elenco, scegli un VPC per questo gruppo di sottoreti. 1. Esegui una di queste operazioni: + Per includere tutte le sottoreti nel VPC selezionato, scegliere **Add all the subnets related to this VPC (Aggiungi tutte le sottoreti correlate a questo VPC)**. + Per specificare le sottoreti per questo gruppo di sottoreti, eseguire la procedura seguente per ogni zona di disponibilità in cui si desidera includere le sottoreti. È necessario includere almeno due zone di disponibilità. 1. **Zona di disponibilità**: nell'elenco, scegli una zona di disponibilità. 1. **Subnet**: nell'elenco, scegli una sottorete dalla zona di disponibilità scelta per questo gruppo di sottoreti. 1. Scegliere **Add subnet (Aggiungi sottorete)**. 1. Scegli **Create (Crea) **. Quando viene creato, il gruppo di sottoreti viene elencato con gli altri gruppi di sottoreti. ![\[Screenshot: Mostrare i dettagli di un gruppo di sottoreti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png) ------ #### [ Using the AWS CLI ] Prima di poter creare un gruppo di sottoreti utilizzando il AWS CLI, è necessario innanzitutto determinare quali sottoreti sono disponibili. Eseguire la seguente AWS CLI operazione per elencare le zone di disponibilità e le relative sottoreti. **Parametri:** + **--db-subnet-group**—Facoltativo. L'indicazione di un determinato gruppo di sottoreti elencherà le zone di disponibilità e le sottoreti per quel gruppo. L'omissione di questo parametro elencherà zone di disponibilità e le sottoreti per tutti i gruppi di sottoreti. L'indicazione del gruppo di sottoreti `default` elenca tutte le sottoreti del VPC. **Example** Per Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name default \ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` Per Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name default ^ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "default", [ [ "us-east-1a", "subnet-4e26d263" ], [ "us-east-1c", "subnet-afc329f4" ], [ "us-east-1e", "subnet-b3806e8f" ], [ "us-east-1d", "subnet-53ab3636" ], [ "us-east-1b", "subnet-991cb8d0" ], [ "us-east-1f", "subnet-29ab1025" ] ] ] ] ``` Utilizzando l'output dall'operazione precedente, è possibile creare un nuovo gruppo di sottoreti. Il nuovo gruppo di sottoreti deve includere sottoreti da almeno due zone di disponibilità. **Parametri:** + **--db-subnet-group-name**: obbligatorio. Il nome di questo gruppo di sottoreti. + **--db-subnet-group-description**: obbligatorio. La descrizione di questo gruppo di sottoreti. + **--subnet-ids**: obbligatorio. Un elenco di sottoreti da includere in questo gruppo di sottoreti. Esempio: `subnet-53ab3636`. + --Tags —Facoltativo****. Un elenco di tag (coppie chiave/valore) da collegare a questo gruppo di sottoreti. Il codice seguente crea il gruppo di sottoreti `sample-subnet-group` con tre sottoreti `subnet-4e26d263`, `subnet-afc329f4` e `subnet-b3806e8f`. Per Linux, macOS o Unix: ``` aws docdb create-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --db-subnet-group-description "A sample subnet group" \ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` Per Windows: ``` aws docdb create-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --db-subnet-group-description "A sample subnet group" ^ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupDescription": "A sample subnet group", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "SubnetGroupStatus": "Complete" } } ``` ------ # Descrizione di un sottogruppo di Amazon DocumentDB Puoi usare Console di gestione AWS o the AWS CLI per ottenere i dettagli di un sottogruppo di Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] La procedura seguente mostra come ottenere i dettagli di un sottogruppo di Amazon DocumentDB. **Per individuare i dettagli di un gruppo di sottoreti** 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 selezionare **Subnet groups (Gruppi di sottoreti)**. **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. Per vedere i dettagli di un gruppo di sottoreti, selezionare il nome di tale gruppo di sottoreti. ![\[Screenshot: Mostrare i dettagli di un gruppo di sottoreti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-subnet-group-details.png) ------ #### [ Using the AWS CLI ] Per trovare i dettagli di un sottogruppo di Amazon DocumentDB, utilizza l'`describe-db-subnet-groups`operazione con il seguente parametro. **Parametro** + `--db-subnet=group-name`—Facoltativo. Se incluso, sono elencati i dettagli per il gruppo di sottoreti designato. Se omesso, sono elencati i dettagli di un massimo di 100 gruppi di sottoreti. **Example** Il codice seguente elenca i dettagli per il gruppo di sottoreti `sample-subnet-group` che abbiamo creato nella sezione [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md). Per Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name sample-subnet-group ``` Per Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name sample-subnet-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-b3806e8f" } ], "DBSubnetGroupDescription": "A sample subnet group" } } ``` ------ # Modifica di un gruppo di sottoreti Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per modificare la descrizione di un gruppo di sottoreti o per aggiungere o rimuovere sottoreti da un sottogruppo di Amazon DocumentDB. Tuttavia, non è possibile modificare il gruppo di sottoreti `default`. ------ #### [ Using the Console di gestione AWS ] Puoi usare il Console di gestione AWS per modificare la descrizione di un gruppo di sottoreti o per aggiungere e rimuovere sottoreti. Ricorda che, al termine di questa operazione è necessario disporre di almeno due zone di disponibilità associate al gruppo di sottoreti. **Per modificare il gruppo di sottoreti** 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 selezionare **Subnet groups (Gruppi di sottoreti)**. Quindi scegliere il pulsante a sinistra del nome del gruppo di sottoreti. Ricorda che non è possibile modificare il gruppo di sottoreti `default`. **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. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**. 1. **Descrizione**: per modificare la descrizione del tuo gruppo di sottoreti, inserisci una nuova descrizione. 1. Per modificare le sottoreti associate al gruppo di sottoreti, nella sezione **Add subnets (Aggiungi sottoreti)** , eseguire una o più delle operazioni seguenti: + Per rimuovere tutte le sottoreti da questo gruppo di sottoreti, scegliere **Remove all (Rimuovi tutte)**. + Per rimuovere sottoreti specifiche da questo gruppo di sottoreti, scegliere **Remove (Rimuovi)** per ciascuna sottorete da rimuovere. + Per aggiungere tutte le sottoreti associate a questo VPC, scegliere **Add all the subnets related to this VPC (Aggiungi tutte le sottoreti correlate a questo VPC)**. + Per aggiungere sottoreti specifiche a questo gruppo di sottoreti, eseguire la procedura seguente per ogni zona di disponibilità a cui si desidera aggiungere una sottorete. 1. **Zona di disponibilità**: nell'elenco, scegli una nuova zona di disponibilità. 1. **Subnet**: nell'elenco, scegli una sottorete dalla zona di disponibilità scelta per questo gruppo di sottoreti. 1. Scegliere **Add subnet (Aggiungi sottorete)**. 1. Nella finestra di dialogo di conferma: + Per apportare tali modifiche al gruppo di sottoreti, scegliere **Modify (Modifica)**. + Per mantenere il gruppo di sottoreti invariato, scegliere **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] È possibile utilizzare il AWS CLI per modificare la descrizione di un gruppo di sottoreti o per aggiungere e rimuovere sottoreti. Ricorda che, al termine di questa operazione è necessario disporre di almeno due zone di disponibilità associate al gruppo di sottoreti. Non è possibile modificare il gruppo di sottoreti `default`. **Parametri:** + `--db-subnet-group-name`: obbligatorio. Il nome del gruppo di sottoreti Amazon DocumentDB che stai modificando. + `--subnet-ids`: obbligatorio. Un elenco di tutte le sottoreti che vuoi aggiungere al gruppo di sottoreti al completamento di questa modifica. **Importante** Tutte le sottoreti attualmente nel gruppo di sottoreti che non vengono incluse in questo elenco vengono rimosse dal gruppo di sottoreti. Se si desidera conservare le sottoreti attualmente nel gruppo di sottoreti, è necessario includerle in questo elenco. + `--db-subnet-group-description`—Facoltativo. La descrizione del gruppo di sottoreti. **Example** Il codice seguente modifica la descrizione e sostituisce le sottoreti esistenti con le sottoreti `subnet-991cb8d0`, `subnet-53ab3636` e `subnet-29ab1025`. Per Linux, macOS o Unix: ``` aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \ --db-subnet-group-description "Modified subnet group" ``` Per Windows: ``` aws docdb modify-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^ --db-subnet-group-description "Modified subnet group" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). Questo è lo stesso gruppo di sottoreti che è stato creato nella sezione [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md). Tuttavia, le sottoreti nel gruppo di sottoreti vengono sostituite da quelle elencate nell'operazione `modify-db-subnet-group`. ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "DBSubnetGroupDescription": "Modified subnet group", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" }, { "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupName": "sample-subnet-group" } } ``` ------ # Eliminazione di un sottogruppo di Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per eliminare un sottogruppo di Amazon DocumentDB. Tuttavia, non è possibile eliminare il gruppo di sottoreti `default`. ------ #### [ Using the Console di gestione AWS ] Puoi usare il Console di gestione AWS per eliminare un gruppo di sottoreti. Tuttavia, non è possibile eliminare il gruppo di sottoreti `default`. **Per eliminare un gruppo di sottoreti** 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 selezionare **Subnet groups (Gruppi di sottoreti)**. Quindi scegliere il pulsante a sinistra del nome del gruppo di sottoreti. Ricorda che non è possibile eliminare il gruppo di sottoreti `default`. **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. Scegli **Azioni**, quindi **Elimina**. 1. Nella finestra di dialogo di conferma: + Per eliminare il gruppo di sottoreti, scegliere **Delete (Elimina)**. + Per mantenere il gruppo di sottoreti, scegliere **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] Per eliminare un sottogruppo di Amazon DocumentDB utilizzando il AWS CLI, utilizza l'`delete-db-subnet-group`operazione con il seguente parametro. **Parametro** + `--db-subnet-group-name`: obbligatorio. Il nome del sottogruppo di Amazon DocumentDB da eliminare. Ricorda che non è possibile eliminare il gruppo di sottoreti `default`. **Example** Il codice seguente consente di eliminare `sample-subnet-group`. Per Linux, macOS o Unix: ``` aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group ``` Per Windows: ``` aws docdb delete-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ``` L'operazione non produce alcun output. ------ # Amazon DocumentDB Disponibilità e replica elevate Puoi ottenere disponibilità elevata e scalabilità di lettura in Amazon DocumentDB (con compatibilità con MongoDB) utilizzando istanze di replica. Un singolo cluster Amazon DocumentDB supporta una singola istanza primaria e fino a 15 istanze di replica. Queste istanze possono essere distribuite tra le zone di disponibilità all'interno della regione del cluster. L'istanza primaria accetta il traffico in lettura e in scrittura, mentre le istanze di replica accettano solo richieste di lettura. Il volume cluster si compone di più copie dei dati per il cluster. Tuttavia, i dati nel volume del cluster sono rappresentati come un unico volume logico nell'istanza principale e nelle repliche di Amazon DocumentDB nel cluster. Le istanze di replica sono consistenti finali. Restituiscono risultati di query con un ritardo di replica minimo, generalmente inferiore a 100 millisecondi dopo che l'istanza primaria ha scritto un aggiornamento. Il ritardo di replica varia in base alla velocità di modifica del database. In altre parole, nei periodi in cui si verificano numerose operazioni di scrittura nel database, potresti riscontrare un aumento del ritardo di replica. ## Dimensionamento della lettura Le repliche di Amazon DocumentDB funzionano bene per il ridimensionamento della lettura perché sono completamente dedicate alle operazioni di lettura sul volume del cluster. Le operazioni di lettura sono gestite dall'istanza primaria. Il volume del cluster è condiviso tra tutte le istanze del cluster. Pertanto, non è necessario replicare e conservare una copia dei dati per ogni replica di Amazon DocumentDB. ## Elevata disponibilità Quando crei un cluster Amazon DocumentDB, a seconda del numero di zone di disponibilità nel gruppo di sottoreti (devono essercene almeno due), Amazon DocumentDB effettua il provisioning delle istanze nelle zone di disponibilità. Quando crei istanze nel cluster, Amazon DocumentDB le distribuisce automaticamente tra le zone di disponibilità in un gruppo di sottoreti per bilanciare il cluster. Questa azione impedisce inoltre che tutte le istanze si trovino nella stessa zona di disponibilità. **Esempio** Per illustrare il punto, considera un esempio in cui crei un cluster con un gruppo di sottoreti con tre zone di disponibilità:, e. *AZ1*AZ2*AZ3*** Una volta creata, la prima istanza all'interno del cluster si trova in una delle zone di disponibilità. In questo esempio, è in. *AZ1* La seconda istanza creata è un'istanza di replica e si trova, ad esempio *AZ2*, in una delle altre due zone di disponibilità. La terza istanza creata è un'istanza di replica e si trova nella zona di disponibilità rimanente,. *AZ3* Se crei più istanze, queste sono distribuite tra le zone di disponibilità in modo da ottenere il bilanciamento del cluster. Se si verifica un errore nell'istanza principale (AZ1), viene attivato un failover e una delle repliche esistenti viene promossa a principale. Quando la vecchia unità primaria viene ripristinata, diventa una replica nella stessa zona di disponibilità in cui era stata fornita (). AZ1 Quando effettui il provisioning di un cluster a tre istanze, Amazon DocumentDB continua a conservare quel cluster a tre istanze. Amazon DocumentDB gestisce automaticamente il rilevamento, il failover e il ripristino degli errori delle istanze senza alcun intervento manuale. Quando Amazon DocumentDB esegue un failover e ripristina un'istanza, l'istanza recuperata rimane nella zona di disponibilità in cui era stata originariamente fornita. Tuttavia, il ruolo dell'istanza potrebbe cambiare da primaria a replica. Questa operazione viene eseguita per evitare lo scenario in cui una serie di failover provoca il posizionamento di tutte le istanze nella stessa zona di disponibilità. È possibile specificare le repliche di Amazon DocumentDB come destinazioni di failover. In altre parole, se l'istanza primaria fallisce, la replica Amazon DocumentDB specificata o la replica di un livello viene promossa all'istanza principale. Si verifica una breve interruzione durante la quale le richieste di lettura e scrittura inviate all'istanza primaria falliscono con un'eccezione. Se il tuo cluster Amazon DocumentDB non include alcuna replica di Amazon DocumentDB, quando l'istanza principale si guasta, viene ricreata. La promozione di una replica di Amazon DocumentDB è molto più rapida rispetto alla ricreazione dell'istanza principale. Per scenari ad alta disponibilità, consigliamo di creare una o più repliche di Amazon DocumentDB. Queste repliche devono appartenere alla stessa classe di istanza dell'istanza principale e in zone di disponibilità diverse per il cluster Amazon DocumentDB. Per ulteriori informazioni, consulta gli argomenti seguenti: + [Comprendere la tolleranza agli errori del cluster Amazon DocumentDB](db-cluster-fault-tolerance.md) + [Failover di Amazon DocumentDB](failover.md) + [Controllo della destinazione del failover](failover.md#failover-target_control) ### Alta disponibilità con cluster globali Per un'elevata disponibilità su più piattaforme Regioni AWS, puoi configurare cluster [globali di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.html). Ogni cluster globale si estende su più regioni, consentendo letture globali a bassa latenza e disaster recovery in caso di interruzioni su un. Regione AWS Amazon DocumentDB gestisce automaticamente la replica di tutti i dati e gli aggiornamenti dalla regione principale a ciascuna delle regioni secondarie. ## Aggiunta di repliche di L'istanza primaria è la prima istanza aggiunta al cluster. Ogni istanza aggiunta dopo la prima è un'istanza di replica. Un cluster può avere fino a 15 istanze di replica oltre a quella principale. Quando si crea un cluster utilizzando il Console di gestione AWS, contemporaneamente viene creata automaticamente un'istanza primaria. Per creare una replica nello stesso momento in cui viene creato il cluster e l'istanza primaria, scegli **Create replica in different zone (Crea replica in una zona diversa)**. Per ulteriori informazioni, consulta la fase 4.d in [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md). Per aggiungere altre repliche a un cluster Amazon DocumentDB, consulta. [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) Quando si utilizza il AWS CLI per creare un cluster, è necessario creare in modo esplicito le istanze primarie e di replica. Per ulteriori informazioni, consulta la sezione «Utilizzo di AWS CLI" nei seguenti argomenti: + [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md) + [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) # Failover di Amazon DocumentDB In alcuni casi, come alcuni tipi di manutenzione pianificata o nell'improbabile eventualità di un guasto di un nodo primario o di una zona di disponibilità, Amazon DocumentDB (compatibile con MongoDB) rileva l'errore e sostituisce il nodo principale. Durante un failover, il tempo di inattività di scrittura è ridotto al minimo. Questo perché il ruolo del nodo principaleesegue il failover in una delle repliche di lettura invece di creare ed eseguire il provisioning di un nuovo nodo principale. Questa individuazione degli errori e promozione delle repliche garantisce la possibilità di ricominciare a scrivere nel nuovo nodo primario non appena la promozione è terminata. Affinché il failover funzioni, il cluster deve avere almeno due istanze: un'istanza primaria e almeno un'istanza di replica. **Nota** Questo argomento si applica solo ai cluster originali basati su istanze di Amazon DocumentDB. Non si applica ai cluster elastici o globali. ## Controllo della destinazione del failover Amazon DocumentDB fornisce livelli di failover come mezzo per controllare quale istanza di replica viene promossa a primaria quando si verifica un failover. **Livelli di failover** Ogni istanza di replica è associata a un livello di failover (0-15). Quando si verifica un failover dovuto alla manutenzione o a un improbabile errore hardware, l'istanza principale esegue il failover su una replica con la priorità più alta (il livello con il numero più basso). Se più repliche hanno lo stesso livello di priorità, l'unità principale esegue il failover sulla replica di quel livello, che è la più vicina in termini di dimensioni alla replica principale precedente. Impostando il livello di failover per un gruppo di repliche selezionate su `0` (priorità massima), puoi assicurare che un failover promuoverà una delle repliche in tale gruppo. Inoltre, per evitare che delle repliche specifiche vengano promosse a istanza primaria in caso di failover, puoi assegnare un livello di priorità basso (numero alto) a queste repliche. Questa funzione è utile nei casi in cui repliche specifiche siano particolarmente utilizzate da un'applicazione e il failover di una di esse potrebbe influire negativamente su un'applicazione critica. Puoi impostare il livello di failover di un'istanza quando la crei o puoi modificarlo successivamente. Il failover non viene attivato se imposti il livello di failover di un'istanza modificando l'istanza. Per ulteriori informazioni, consulta gli argomenti seguenti: + [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) + [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md) Quando avvii manualmente un failover, puoi controllare quale istanza di replica viene promossa a primaria in due modi: i livelli di failover descritti in precedenza e il parametro `--target-db-instance-identifier`. **--`target-db-instance-identifier`** Per il testing, puoi forzare un evento di failover utilizzando l'operazione `failover-db-cluster`. Puoi utilizzare il parametro `--target-db-instance-identifier` per specificare quale replica promuovere a istanza primaria. L'utilizzo del parametro `--target-db-instance-identifier` sostituisce il livello di priorità di failover. Se non specifichi il parametro `--target-db-instance-identifier`, il failover primario si conforma al livello di priorità di failover. ## Cosa succede durante un failover Il failover viene gestito automaticamente da Amazon DocumentDB in modo che le applicazioni possano riprendere le operazioni del database il più rapidamente possibile senza interventi amministrativi. + Se hai un'istanza di replica di Amazon DocumentDB nella stessa o in un'altra zona di disponibilità durante il failover: Amazon DocumentDB capovolge il canonical name record (CNAME) dell'istanza in modo che punti alla replica integra, che a sua volta viene promossa a diventare la nuova principale. In genere, l'esecuzione completa dell'intero processo di failover impiega meno di 30 secondi. + Se non disponi di un'istanza di replica di Amazon DocumentDB (ad esempio, un cluster a istanza singola): Amazon DocumentDB tenterà di creare una nuova istanza nella stessa zona di disponibilità dell'istanza originale. Questa sostituzione dell'istanza originale viene eseguita in base al tentativo migliore e potrebbe non avvenire, ad esempio, se si verifica un problema che interessa in qualche modo la zona di disponibilità. L'applicazione deve provare a ristabilire le connessioni al database in caso di perdita della connessione. ## Verifica del Failover Un failover per un cluster promuove una delle repliche di Amazon DocumentDB (istanze di sola lettura) nel cluster come istanza principale (lo scrittore del cluster). In caso di errore dell'istanza primaria, Amazon DocumentDB esegue automaticamente il failover su una replica di Amazon DocumentDB, se esistente. Puoi forzare un failover per simulare un guasto di un'istanza primaria per scopi di testing. Ogni istanza in un cluster ha il proprio indirizzo di endpoint. Pertanto, è necessario eliminare e ristabilire tutte le connessioni esistenti che utilizzano tali indirizzi una volta completato il failover.. Per forzare un failover, utilizza l'operazione `failover-db-cluster` con questi parametri. + `--db-cluster-identifier`: obbligatorio. Il nome del cluster di cui eseguire il failover. + `--target-db-instance-identifier`—Facoltativo. Il nome dell'istanza da promuovere a istanza primaria. **Example** L'operazione seguente forza un failover del cluster `sample-cluster`. Non specifica quale istanza creare la nuova istanza primaria, quindi Amazon DocumentDB sceglie l'istanza in base alla priorità del livello di failover. Per Linux, macOS o Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster ``` Per Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ``` L'operazione seguente forza un failover del cluster `sample-cluster`, specificando che `sample-cluster-instance` deve essere promosso al ruolo primario. Annota il valore `"IsClusterWriter": true` nell'output. Per Linux, macOS o Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster \ --target-db-instance-identifier sample-cluster-instance ``` Per Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ^ --target-db-instance-identifier sample-cluster-instance ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBCluster": { "HostedZoneId": "Z2SUY0A1719RZT", "Port": 27017, "EngineVersion": "3.6.0", "PreferredMaintenanceWindow": "thu:04:05-thu:04:35", "BackupRetentionPeriod": 1, "ClusterCreateTime": "2018-06-28T18:53:29.455Z", "AssociatedRoles": [], "DBSubnetGroup": "default", "MasterUsername": "master-user", "Engine": "docdb", "ReadReplicaIdentifiers": [], "EarliestRestorableTime": "2018-08-21T00:04:10.546Z", "DBClusterIdentifier": "sample-cluster", "ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-cluster-instance", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": true }, { "DBInstanceIdentifier": "sample-cluster-instance-00", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false }, { "DBInstanceIdentifier": "sample-cluster-instance-01", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false } ], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "DBClusterParameterGroup": "default.docdb3.6", "Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "IAMDatabaseAuthenticationEnabled": false, "AllocatedStorage": 1, "LatestRestorableTime": "2018-08-22T21:57:33.904Z", "PreferredBackupWindow": "00:00-00:30", "StorageEncrypted": false, "MultiAZ": true, "Status": "available", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-12345678" } ], "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ" } } ``` ## Ritardo di replica Il ritardo di replica è in genere pari o inferiore a 50 ms. I motivi più comuni dell'aumento del ritardo di replica sono: + Una velocità di scrittura elevata sul sistema primario che fa sì che le repliche di lettura rimangano inferiori rispetto a quelle primarie. + Conflitto sulle repliche di lettura tra query a esecuzione prolungata (ad esempio, scansioni sequenziali di grandi dimensioni, query di aggregazione) e replica di scrittura in entrata. + Numero molto elevato di query simultanee sulle repliche di lettura. Per ridurre al minimo il ritardo nella replica, prova queste tecniche di risoluzione dei problemi: + Se hai una velocità di scrittura o un utilizzo elevato della CPU, ti consigliamo di scalare verso l'alto le istanze del cluster. + Se sono presenti query di lunga durata sulle repliche di lettura e aggiornamenti molto frequenti dei documenti interrogati, è consigliabile modificare le query di lunga durata o eseguirle sulla replica primaria/di scrittura per evitare conflitti sulle repliche di lettura. + Se è presente un numero molto elevato di query simultanee o un elevato utilizzo della CPU solo sulle repliche di lettura, un'altra opzione consiste nel ridimensionare il numero di repliche di lettura per distribuire il carico di lavoro. + Poiché il ritardo di replica è il risultato di un'elevata velocità di scrittura e di query a esecuzione prolungata, si consiglia di risolvere il problema del ritardo di replica utilizzando la metrica CW in combinazione con lo slow query logger e/metrics. DBCluster ReplicaLagMaximum `WriteThroughput` `WriteIOPS` In generale, è consigliabile che tutte le repliche siano dello stesso tipo di istanza, in modo che un failover del cluster non provochi un peggioramento delle prestazioni. Se si sceglie tra la scalabilità verticale e quella orizzontale (ad esempio sei istanze più piccole anziché tre istanze più grandi), in genere consigliamo di provare a scalare prima (istanze più grandi) prima di eseguire la scalabilità orizzontale, in quanto si otterrà una cache di buffer più grande per istanza DB. In modo proattivo, dovresti impostare un allarme di ritardo nella replica e impostarne la soglia su un valore che ritieni sia il limite superiore per indicare il ritardo (o «obsoleto») dei dati sulle istanze di replica prima che inizino a influire sulla funzionalità dell'applicazione. In generale, consigliamo di superare la soglia di ritardo di replica per diversi punti dati prima dell'invio di allarmi, a causa di carichi di lavoro transitori. **Nota** Inoltre, si consiglia di impostare un altro allarme per i ritardi di replica superiori a 10 secondi. Se superi questa soglia per più punti dati, ti consigliamo di scalare le istanze o ridurre il throughput di scrittura sull'istanza principale. # Gestione degli indici Amazon DocumentDB **Topics** + [Creazione di indici Amazon DocumentDB](#index-creation) + [Manutenzione degli indici Amazon DocumentDB](#maintaining-indexes) ## Creazione di indici Amazon DocumentDB La creazione di indici in Amazon DocumentDB richiede l'adozione di una serie di decisioni: + Quanto velocemente deve essere completato? + La raccolta può essere inaccessibile durante la compilazione? + Quanta potenza di calcolo di un'istanza può essere allocata alla build? + Che tipo di indice deve essere creato? Questa sezione ti aiuta a rispondere a queste domande e fornisce i comandi e gli esempi di monitoraggio per creare un indice Amazon DocumentDB sulla tua raccolta di cluster basata su istanze. ### Linee guida Le seguenti linee guida includono limiti di base e compromessi di configurazione per la creazione di nuovi indici: + **Supporto della versione di Amazon DocumentDB** - Mentre l'indicizzazione a singolo worker è supportata su tutte le versioni di Amazon DocumentDB, l'indicizzazione di più worker è supportata solo nelle versioni 4.0 e 5.0 di Amazon DocumentDB. + **Compromesso in termini di prestazioni**: l'aumento del numero di lavoratori nel processo di creazione dell'indice aumenta l'utilizzo della CPU e l'IO di lettura sull'istanza principale del database Amazon DocumentDB. Le risorse necessarie per creare un nuovo indice non saranno disponibili per il carico di lavoro in esecuzione. + **Cluster elastici**: l'indicizzazione parallela non è supportata sui cluster elastici di Amazon DocumentDB. + Numero **massimo di lavoratori**: il numero massimo di worker che è possibile configurare dipende dalla dimensione dell'istanza principale nel cluster di database. È la metà del numero totale di v CPUs sull'istanza principale del cluster di database. Ad esempio, è possibile eseguire un massimo di 32 worker su un'istanza db.r6g.16xlarge con 64 v. CPUs **Nota** I worker paralleli non sono supportati su classi di istanze 2xlarge e inferiori. + Numero **minimo di lavoratori**: il numero minimo di lavoratori che è possibile configurare è uno. L'impostazione predefinita per la creazione di indici su cluster basati su istanze è di due worker. Tuttavia, è possibile ridurre il numero di lavoratori a uno utilizzando l'opzione «worker threads». Questo eseguirà il processo con un solo lavoratore. + **Compressione dell'indice**: Amazon DocumentDB non supporta la compressione degli indici. Le dimensioni dei dati per gli indici potrebbero essere maggiori rispetto a quando utilizzi altre opzioni. + **Indicizzazione di più raccolte**: metà della v CPUs sull'istanza principale del cluster di database può essere utilizzata per i lavoratori configurati che eseguono la creazione di indici su più raccolte. + **Tipi di indice**: consulta [questo post di blog](https://aws.amazon.com/blogs/database/how-to-index-on-amazon-documentdb-with-mongodb-compatibility/) per una spiegazione completa dei tipi di indice supportati su Amazon DocumentDB. ### Nozioni di base Per avviare la creazione dell'indice su una raccolta, usa il `createIndexes` comando. Per impostazione predefinita, il comando eseguirà due worker paralleli che aumentano di due volte la velocità del processo di creazione dell'indice. Ad esempio, il seguente processo di comando dimostra come creare un indice per il campo «user\$1name» in un documento e aumentare la velocità del processo di indicizzazione a quattro worker: 1. Crea indici utilizzando due worker paralleli sul cluster: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx"}]}) ``` 1. Per ottimizzare la velocità del processo di creazione dell'indice, è possibile specificare il numero di worker utilizzando l'opzione «worker threads» (`"workers":`) nel comando. `db.runCommand createIndexes` Aumenta la velocità del processo a quattro lavoratori paralleli: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx", "workers":4}]}) ``` **Nota** Maggiore è il numero di lavoratori, più velocemente avanza la creazione dell'indice. Tuttavia, più aumenta il numero di lavoratori, maggiore è il carico sull'IO v CPUs e read dell'istanza principale. Assicurati che il cluster disponga di un provisioning sufficiente per gestire l'aumento del carico di lavoro senza compromettere gli altri carichi di lavoro. ### Indicizzazione dello stato di avanzamento Il processo di creazione dell'indice funziona inizializzando, scansionando le raccolte, ordinando le chiavi e, infine, inserendo le chiavi tramite un generatore di indici. Il processo prevede fino a sei fasi se viene eseguito in primo piano e fino a nove fasi quando viene eseguito in background. È possibile visualizzare le metriche di stato come la percentuale di completamento, il numero totale di blocchi di archiviazione scansionati, le chiavi ordinate e le chiavi inserite fase per fase. Monitora l'avanzamento del processo di indicizzazione utilizzando il `db.currentOp()` comando nella shell mongo. Un completamento al 100% dell'ultima fase mostra che tutti gli indici sono stati creati con successo: ``` db.currentOp({"command.createIndexes": { $exists : true } }) ``` **Nota** La visualizzazione dello stato di avanzamento dell'indicizzazione è supportata solo su Amazon DocumentDB 5.0. #### Tipi di compilazione dell'indice I quattro tipi di build di indici sono: + **Foreground**: la build dell'indice in primo piano blocca tutte le altre operazioni del database fino alla creazione dell'indice. La build in primo piano di Amazon DocumentDB è composta da cinque fasi. + **Foreground (unique)**: le build di indici in primo piano a documento singolo (univoco) bloccano altre operazioni di database, come le normali compilazioni in primo piano. A differenza della build di base in primo piano, la build unica utilizza una fase aggiuntiva (ordinamento delle chiavi 2) per cercare le chiavi duplicate. La build in primo piano (unica) è composta da sei fasi. + **Sfondo**: la creazione dell'indice in background consente l'esecuzione in primo piano di altre operazioni del database durante la creazione dell'indice. La build in background di Amazon DocumentDB è composta da otto fasi. + **Background (unico)**: le build di indici in background a documento singolo (univoco) consentono l'esecuzione di altre operazioni del database in primo piano durante la creazione dell'indice. A differenza della build di base in background, la build unica utilizza una fase aggiuntiva (ordinamento delle chiavi 2) per cercare le chiavi duplicate. La build in background (unica) è composta da nove fasi. #### Fasi di creazione dell'indice | Stage | Primo piano | Primo piano (unico) | Contesto | Sfondo (unico) | | --- | --- | --- | --- | --- | | Inizializzazione | 1 | 1 | 1 | 1 | | indice di costruzione: inizializzazione | 2 | 2 | 2 | 2 | | indice di edificio: raccolta mediante scansione | 3 | 3 | 3 | 3 | | indice dell'edificio: ordinamento delle chiavi 1 | 4 | 4 | 4 | 4 | | indice dell'edificio: ordinamento delle chiavi 2 | | 5 | | 5 | | indice di costruzione: inserimento di chiavi | 5 | 6 | 5 | 6 | | convalida: indice di scansione | | | 6 | 7 | | convalida: ordinamento delle tuple | | | 7 | 8 | | convalida: scansione della raccolta | | | 8 | 9 | + **inizializzazione**: createIndex sta preparando il generatore di indici. Questa fase dovrebbe essere molto breve. + **building index: inizializzazione** - Il generatore di indici si sta preparando a creare l'indice. Questa fase dovrebbe essere molto breve. + **building index: scanning collection** - Il generatore di indici sta eseguendo una scansione della raccolta per raccogliere le chiavi dell'indice. L'unità di misura è «blocchi». **Nota** Se più di un worker è configurato per la creazione dell'indice, questo viene visualizzato in questa fase. La fase di «scansione della raccolta» è l'unica fase che utilizza più worker durante il processo di creazione dell'indice. Tutte le altre fasi mostreranno un solo lavoratore. + **indice di ordinamento: chiavi di ordinamento 1** - Il generatore di indici sta ordinando le chiavi dell'indice raccolte. L'unità di misura è «chiavi». + **building index: sorting keys 2** - Il generatore di indici sta ordinando le chiavi di indice raccolte che corrispondono a tuple morte. Questa fase esiste solo per la creazione di indici unici. L'unità di misura è la «chiave». + **building index: inserimento di chiavi** - Il generatore di indici sta inserendo le chiavi dell'indice nel nuovo indice. L'unità di misura è «chiavi». + **convalida: indice di scansione** - CreateIndex sta scansionando l'indice per trovare le chiavi che devono essere convalidate. L'unità di misura è «blocchi». + **convalida: ordinamento delle tuple** - CreateIndex sta ordinando l'output della fase di scansione dell'indice. + **convalida: scansione della raccolta** - CreateIndex sta scansionando la raccolta per convalidare le chiavi dell'indice trovate nelle due fasi precedenti. L'unità di misura è «blocchi». #### Esempio di output di compilazione dell'indice Nell'esempio di output riportato di seguito (creazione dell'indice in primo piano), viene mostrato lo stato della creazione dell'indice. Il campo «msg» riassume l'avanzamento della compilazione indicando la fase e la percentuale di completamento della build. Il campo «workers» indica il numero di lavoratori utilizzati durante quella fase della creazione dell'indice. Il campo «avanzamento» mostra i numeri effettivi utilizzati per calcolare la percentuale di completamento. **Nota** I campi «currentIndexBuildName», «msg» e «progress» non sono supportati su Amazon DocumentDB versione 4.0. ``` { "inprog" : [{ … "command": { "createIndexes": "test", "indexes": [{ "v": 2, "key": { "user_name": 1 }, "name": "user_name_1" }], "lsid": { "id": UUID(“094d0fba-8f41-4373-82c3-7c4c7b5ff13b”) }, "$db": "test" }, "currentIndexBuildName": user_name_1, "msg": "Index Build: building index number_1, stage 6/6 building index: 656860/1003520 (keys) 65%", "workers": 1, "progress": { "done": 656861, "total": 1003520 }, … ], "ok" : 1 } ``` ## Manutenzione degli indici Amazon DocumentDB **Topics** + [Index bloat](#db-index-bloat) + [Manutenzione dell'indice utilizzando `reIndex`](#reIndex) ### Index bloat Amazon DocumentDB utilizza Multi-Version Concurrency Control (MVCC) per gestire transazioni simultanee. Quando i documenti vengono eliminati o aggiornati, le versioni precedenti rimangono nelle raccolte e negli indici come versioni «morte». Il processo di raccolta dei rifiuti recupera automaticamente lo spazio da queste versioni non funzionanti per operazioni future. Il gonfiamento dell'indice si verifica quando gli indici di una raccolta diventano più grandi a causa dell'accumulo di voci di indice non più valide o obsolete o della frammentazione all'interno delle pagine. La percentuale riportata rappresenta la quantità di spazio indicizzato che può essere utilizzata dalle future voci dell'indice. Questo bloat consuma spazio sia nella cache del buffer che nella memoria. Se vuoi rimuovere il bloat, dovrai ricostruire gli indici. **Example Esempio** Esegui il comando seguente per determinare lo spazio di archiviazione inutilizzato per l'indice: ``` db.coll.aggregate({$indexStats:{}}); ``` Il risultato è simile al seguente: ``` { "name" : "_id_", "key" : { "_id" : 1 }, "host" : "devbox-test.localhost.a2z.com:27317", "size" : NumberLong(827392), "accesses" : { "ops" : NumberLong(40000), "docsRead" : NumberLong(46049), "since" : ISODate("2025-04-03T21:44:51.251Z") }, "cacheStats" : { "blksRead" : NumberLong(264), "blksHit" : NumberLong(140190), "hitRatio" : 99.8121 }, "unusedStorageSize" : { "unusedSizeBytes" : 409600, "unusedSizePercent" : 49.51 } } ``` È possibile ricostruire gli indici senza tempi di inattività utilizzando il `reIndex` comando, che richiede una scansione dell'intera raccolta. Per informazioni, consulta [Manutenzione dell'indice utilizzando `reIndex`](#reIndex). ### Manutenzione dell'indice utilizzando `reIndex` `reIndex`è un comando usato per ricostruire un indice. Viene in genere utilizzato quando un indice è danneggiato o inefficiente. Nel tempo, gli indici possono accumulare spazio inutilizzato a causa di numerosi aggiornamenti, inserimenti o eliminazioni, con conseguente peggioramento delle prestazioni. La reindicizzazione aiuta a rimuovere lo spazio inutilizzato e a ripristinare l'efficienza dell'indice. #### `reIndex`linee guida + `reIndex`è supportato solo su Amazon DocumentDB 5.0. + Amazon DocumentDB supporta `reindex` un singolo indice in background, che consente l'utilizzo di più worker. Il vecchio indice è utilizzabile tramite query quando il `reIndex` processo è in esecuzione. + Amazon DocumentDB supporta l'indicizzazione dei report sullo stato di avanzamento tramite. `currentOp` Puoi visualizzare le fasi di creazione dell'indice simili a quelle [Fasi di creazione dell'indice](#index-build-stages) visualizzate durante la creazione dell'indice. L'unica differenza è che ha `reIndex` sempre otto fasi, indipendentemente dal fatto che sia unica o meno. Non esiste una fase «indice di costruzione: ordinamento delle chiavi 2». + `reIndex`può essere eseguito contemporaneamente a qualsiasi comando ad eccezione dei comandi relativi all'indice nella stessa raccolta:`createIndexes`,, `dropIndexes` e. `collMod` `renameCollection` + `reIndex`attualmente non è supportato per gli indici testuali, geospaziali, vettoriali e parziali. ##### `reIndex`costruire Usa il seguente comando per ricostruire il tuo indice: ``` db.runCommand({ reIndex: "collection-name", index: "index-name"}) ``` Facoltativamente, puoi anche controllare il numero di lavoratori assegnati al processo di ricostruzione: ``` db.runCommand({ reIndex: "collection-name", index: "index-name", workers: number }) ``` # Gestione della compressione dei documenti a livello di raccolta La compressione dei documenti a livello di raccolta di Amazon DocumentDB 5.0 consente di ridurre i costi di storage e I/O comprimendo i documenti nelle raccolte. Puoi abilitare la compressione dei documenti a livello di raccolta e visualizzare i parametri di compressione in base alle esigenze misurando i vantaggi in termini di archiviazione grazie a parametri di compressione come le dimensioni di archiviazione dei documenti compressi e lo stato di compressione. Amazon DocumentDB 5.0 utilizza l'algoritmo di LZ4 compressione per comprimere i documenti. Amazon DocumentDB supporta la compressione dei documenti a partire dalla versione 5.0. Le seguenti sono funzioni di compressione dei documenti a livello di raccolta: + **Comportamento predefinito**: l'impostazione di compressione predefinita per le nuove raccolte in un cluster 5.0 è determinata dal parametro cluster. `default_collection_compression` Per impostazione predefinita, questo parametro è impostato su «disabilitato». + Compressione **delle raccolte esistenti**: l'impostazione di compressione per le raccolte esistenti può essere modificata utilizzando il `collMod` comando. + **Modifica della soglia di compressione**: la soglia di compressione predefinita è di 2 KB. Questo valore può essere specificato per le nuove raccolte utilizzando il `createCollection` comando e modificato per le raccolte esistenti utilizzando `collMod` il comando. **Nota** La compressione dei documenti di Amazon DocumentDB non è supportata nelle versioni 3.6 e 4.0 di Amazon DocumentDB. **Topics** + [Gestione della compressione dei documenti](#manage-compression) + [Monitoraggio della compressione dei documenti](#monitoring-compression) ## Gestione della compressione dei documenti ### Attivazione della compressione dei documenti in una raccolta Abilita la compressione dei documenti durante la creazione di una raccolta su Amazon DocumentDB 5.0 utilizzando `db.createCollection()` il metodo: ``` db.createCollection( sample_collection,{ storageEngine : { documentDB: { compression:{enable: } } } }) ``` ### Attivazione della compressione dei documenti in un cluster La compressione dei documenti può essere abilitata per impostazione predefinita per tutte le nuove raccolte a livello di cluster impostando il parametro `default_collection_compression` cluster su «enabled». Quando questo parametro è impostato su «abilitato», le nuove raccolte create nel cluster avranno la compressione abilitata per impostazione predefinita con una soglia di compressione di 2 KB. ### Compressione delle raccolte esistenti È inoltre possibile modificare le impostazioni di compressione per una raccolta esistente utilizzando l'`collMod`operazione e specificando la seguente `storageEngine` configurazione. Tieni presente che la modifica apportata utilizzando questo comando si applicherà solo ai nuovi inserted/updated documenti e la compressione sui documenti inseriti in precedenza non cambierà. ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: {compression: {enable: } } } }) ``` ### Impostazione delle soglie di compressione Per impostazione predefinita, la soglia di compressione per le raccolte compresse è di 2032 byte. Questo valore di soglia può essere impostato nel `createCollection` comando quando si crea una nuova raccolta con la compressione abilitata: ``` db.createCollection( sample_collection, { storageEngine : { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` È inoltre possibile modificare la soglia di compressione per una raccolta compressa esistente utilizzando l'`collMod`operazione e specificando la seguente configurazione: `storageEngine` ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` Tieni presente che la soglia di compressione può essere impostata solo su un valore compreso tra 128 e 8000 byte. Inoltre, l'`enable`opzione deve essere impostata su «true» quando si specifica la soglia di compressione. ## Monitoraggio della compressione dei documenti Puoi verificare se una raccolta è compressa e calcolarne il rapporto di compressione come segue. Visualizza le statistiche di compressione eseguendo il `db.collection.stats()` comando `db.printCollectionStats()` or dalla shell mongo. L'output mostra le dimensioni originali e le dimensioni compresse che è possibile confrontare per analizzare i guadagni di spazio di archiviazione derivanti dalla compressione dei documenti. In questo esempio, le statistiche per una raccolta denominata «sample\$1collection» sono mostrate di seguito. Di seguito viene utilizzato un fattore di scala di 1024\$11024 per generare i valori and in MB. `size` `storageSize` ``` db.sample_collection.stats(1024*1024) ``` Di seguito è riportato un esempio dell'output del comando precedente: ``` { "ns" : "test.sample_collection", "count" : 1000000, "size" : 3906.3, "avgObjSize" : 4096, "storageSize" : 1953.1, compression:{"enabled" : true,"threshold" : 2032}, ... } ``` + **size** - La dimensione originale della raccolta di documenti. + **avgObjSize**- La dimensione media del documento prima della compressione è arrotondata al primo decimale. L'unità di misura è il byte. + **StorageSize**: la dimensione di archiviazione della raccolta dopo la compressione. L'unità di misura è il byte. + **abilitato**: indica se la compressione è abilitata o disabilitata. Per calcolare il rapporto di compressione effettivo, dividi la dimensione della raccolta per la dimensione di archiviazione (size/storageSize). Per l'esempio precedente, il calcolo è 3906,3/1953,1, che si traduce in un rapporto di compressione 2:1. # Gestione della compressione basata su dizionari in Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 introduce un nuovo algoritmo di compressione dei documenti, zstd, come alternativa migliorata a. LZ4 Quando abiliti la compressione del dizionario su una raccolta Amazon DocumentDB 8.0 selezionando Zstd come algoritmo di compressione, i documenti della tua raccolta vengono campionati per creare un dizionario di compressione personalizzato. I documenti nuovi e aggiornati vengono compressi utilizzando questo dizionario e l'algoritmo zstd. Questo approccio consente in genere di ottenere rapporti di compressione più elevati rispetto ai metodi di compressione standard, in particolare per le raccolte con schemi di documenti coerenti o nomi di campo ripetuti. Lz4 è un algoritmo progettato per una compressione e una decompressione rapide. È noto per essere leggero sulla CPU pur ottenendo una compressione evidente. Zstd è un algoritmo generico che con le impostazioni predefinite utilizza più CPU ma raggiunge rapporti di compressione migliori rispetto a lz4. L'uso dei dizionari migliora ulteriormente la compressione per la maggior parte dei documenti JSON. Alcuni vantaggi dell'algoritmo Zstd sono: + Costi di archiviazione ridotti: rapporti di compressione più elevati significano un minore utilizzo dello storage e costi inferiori. + Prestazioni inferiori I/O: Compressed documents require less I/O e potenzialmente migliorative. + Ottimizzato per la tua raccolta: il dizionario è addestrato specificamente per i modelli di dati della tua raccolta. **Nota** La compressione basata su dizionario non è supportata nelle versioni 3.6, 4.0 e 5.0 di Amazon DocumentDB. ## Considerazioni sulle prestazioni La compressione Zstd comporta i seguenti compromessi: + Storage vs. CPU: la compressione Zstd raggiunge rapporti di compressione migliori ma può utilizzare un po' più risorse della CPU rispetto alla compressione. LZ4 + Compressione iniziale: è possibile che le nuove raccolte non raggiungano una compressione ottimale finché non vengono inseriti abbastanza documenti per addestrare un dizionario efficace. Attualmente, un dizionario viene addestrato se raccoglie almeno 100 documenti. + Tipo di carico di lavoro: i carichi di lavoro ad alta intensità di lettura in cui tutti i dati vengono inseriti nella cache buffer possono registrare un aumento della latenza e dell'utilizzo della CPU a causa del sovraccarico di decompressione. La compressione Zstd è particolarmente efficace per raccolte con documenti di piccole dimensioni, matrici di documenti e nomi di campo ripetuti. ## Attivazione della compressione basata su dizionari Per le nuove raccolte puoi usare il comando seguente per abilitare la compressione Zstd: ``` db.createCollection("myCollection", { storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } } ) ``` Puoi anche abilitare o modificare la compressione su una raccolta esistente: ``` db.runCommand({ collMod: "myCollection", storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } }) ``` Per abilitare l'algoritmo Zstd in tutte le raccolte del cluster, puoi modificare il gruppo di parametri del cluster per selezionare «zstd» come valore per il parametro «default\$1collection\$1compression». ## Nozioni di base Amazon DocumentDB 8.0 viene fornito con la compressione Zstd attivata per impostazione predefinita. Puoi sempre disattivarla impostando il valore di 'default\$1compression' su disabilitato nel gruppo di parametri del cluster. Va notato che a partire da Amazon DocumentDB 8.0, 'enabled' non è più una scelta valida per default\$1compression ed è necessario selezionare tra Zstd e. LZ4 ## Monitoraggio È possibile visualizzare le informazioni di compressione per una raccolta utilizzando uno dei seguenti comandi: + db.runCommand (\$1collStats: «myCollection»\$1) OPPURE + db.collection.stats () Questi comandi restituiscono statistiche chiave che è possibile utilizzare per calcolare il rapporto di compressione: + compression.algorithm: L'algoritmo utilizzato («lz4" o «zstd») + StorageSize: lo spazio di archiviazione effettivo utilizzato dalla raccolta, dopo la compressione. Nota che questo numero include la frammentazione (ovvero lo spazio inutilizzato nelle pagine del database) + avgObjSize: dimensione logica media dei documenti della raccolta, decompressi. Tieni presente che se la tua raccolta contiene più di 20.000 documenti, questo numero sarà un'approssimazione basata su un campione di 20.000 documenti. + dimensione: la dimensione logica della raccolta senza compressione. Questo numero si ottiene avgObjSize moltiplicando per il numero totale di documenti della raccolta, quindi se avgObjSize è un'approssimazione, anche questo numero sarà un'approssimazione. + conteggio: numero di documenti nella raccolta Le seguenti CloudWatch metriche possono essere utili per valutare la compressione basata sul dizionario: + CPUUtilization + FreeableMemory + VolumeBytesUsed + VolumeReadIOPs + VolumeWriteIOPs Metriche CollStats: + storageSize + formato Inoltre, può essere utile tenere traccia delle metriche specifiche dell'applicazione, come la latenza e il throughput per tipo di query o API. # Gestione degli eventi di Amazon DocumentDB Amazon DocumentDB (con compatibilità con MongoDB) registra gli eventi relativi a cluster, istanze, istantanee, gruppi di sicurezza e gruppi di parametri del cluster. Queste informazioni includono la data e l'ora dell'evento, il nome e il tipo di origine dell'evento e un messaggio associato all'evento. **Importante** Per alcune funzionalità di gestione, Amazon DocumentDB utilizza una tecnologia operativa condivisa con Amazon RDS e Amazon Neptune. I limiti delle regioni, limiti regolati a livello di regione, sono condivisi tra Amazon DocumentDB, Amazon RDS e Amazon Neptune. Per ulteriori informazioni, consulta [Quote regionali](limits.md#limits-regional_quotas). **Topics** + [Visualizzazione delle categorie di eventi di Amazon DocumentDB](#viewing-event-categories) + [Visualizzazione degli eventi di Amazon DocumentDB](#viewing-events) ## Visualizzazione delle categorie di eventi di Amazon DocumentDB Ogni tipo di risorsa Amazon DocumentDB ha tipi specifici di eventi che possono essere associati ad esso. È possibile utilizzare l' AWS CLI `describe-event-categories`operazione per visualizzare la mappatura tra i tipi di eventi e i tipi di risorse Amazon DocumentDB. **Parametri** + **--source-type**—Facoltativo. Utilizzare il parametro `--source-type` per visualizzare le categorie di eventi per un determinato tipo di origine. Di seguito sono elencati i valori consentiti: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` + **--filters**—Facoltativo. Per visualizzare le categorie di eventi solo per Amazon DocumentDB, usa il filtro. `--filter Name=engine,Values=docdb` **Example** Il codice seguente elenca le categorie di eventi associati ai cluster. Per Linux, macOS o Unix: ``` aws docdb describe-event-categories \ --filter Name=engine,Values=docdb \ --source-type db-cluster ``` Per Windows: ``` aws docdb describe-event-categories ^ --filter Name=engine,Values=docdb ^ --source-type db-cluster ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "EventCategoriesMapList": [ { "EventCategories": [ "notification", "failure", "maintenance", "failover" ], "SourceType": "db-cluster" } ] } ``` Il codice seguente elenca le categorie di eventi associate a ciascun tipo di sorgente Amazon DocumentDB. ``` aws docdb describe-event-categories ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "EventCategoriesMapList": [ { "SourceType": "db-instance", "EventCategories": [ "notification", "failure", "creation", "maintenance", "deletion", "recovery", "restoration", "configuration change", "read replica", "backtrack", "low storage", "backup", "availability", "failover" ] }, { "SourceType": "db-security-group", "EventCategories": [ "configuration change", "failure" ] }, { "SourceType": "db-parameter-group", "EventCategories": [ "configuration change" ] }, { "SourceType": "db-cluster", "EventCategories": [ "notification", "failure", "maintenance", "failover" ] }, { "SourceType": "db-cluster-snapshot", "EventCategories": [ "backup" ] } ] } ``` ## Visualizzazione degli eventi di Amazon DocumentDB Puoi recuperare gli eventi per le tue risorse Amazon DocumentDB tramite la console Amazon DocumentDB, che mostra gli eventi delle ultime 24 ore. Puoi anche recuperare eventi per le tue risorse Amazon DocumentDB utilizzando il comando AWS CLI describe-events o [l'](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html)operazione API Amazon [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html)DocumentDB. Se utilizzi l' AWS CLI API di Amazon DocumentDB per visualizzare gli eventi, puoi recuperare gli eventi relativi agli ultimi 14 giorni. ------ #### [ Using the Console di gestione AWS ] **Per visualizzare tutti gli eventi delle istanze di Amazon DocumentDB nelle ultime 24 ore** 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 selezionare **Events (Eventi)**. Gli eventi disponibili sono indicati all'interno di un elenco. 1. Utilizza l'elenco **Filter (Filtra)** per filtrare gli eventi per tipo. Inserisci un termine nella casella di testo per filtrare ulteriormente i risultati. *Ad esempio, la schermata seguente mostra il filtraggio di tutti gli eventi di Amazon DocumentDB per gli eventi snapshot.* ![\[Screenshot della sezione degli eventi che mostra come filtrare gli eventi in base alle snapshot.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/events-filtering.png) ------ #### [ Using the AWS CLI ] **Per visualizzare tutti gli eventi delle istanze di Amazon DocumentDB negli ultimi 7 giorni** Puoi visualizzare tutti gli eventi delle istanze Amazon DocumentDB degli ultimi 7 giorni eseguendo l' AWS CLI operazione [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) con il `--duration` parametro impostato su (10.080 minuti). `10080` ``` aws docdb describe-events --duration 10080 ``` **Filtraggio per eventi Amazon DocumentDB** Per visualizzare eventi specifici di Amazon DocumentDB, utilizza l'`describe-events`operazione con i seguenti parametri. **Parametri** + **--filter**—Necessario per limitare i valori restituiti agli eventi di Amazon DocumentDB. Utilizzalo **Name=engine,Values=docdb** per filtrare tutti gli eventi solo per Amazon DocumentDB. + **--source-identifier**—Facoltativo. L'identificatore dell'origine dell'evento in base a cui vengono restituiti gli eventi. Se omesso, nei risultati sono inclusi gli eventi provenienti da tutte le origini. + **--source-type**—Facoltativo, a meno che non `--source-identifier` sia fornito, quindi obbligatorio. Se viene fornito `--source-identifier`, `--source-type` deve concordare con il tipo di `--source-identifier`. Di seguito sono elencati i valori consentiti: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` L'esempio seguente elenca tutti gli eventi di Amazon DocumentDB. ``` aws docdb describe-events --filters Name=engine,Values=docdb ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Events": [ { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3", "Message": "instance created", "SourceType": "db-instance", "Date": "2018-12-11T21:17:40.023Z", "SourceIdentifier": "sample-cluster-instance3", "EventCategories": [ "creation" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance shutdown", "SourceType": "db-instance", "Date": "2018-12-11T21:25:01.245Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance restarted", "SourceType": "db-instance", "Date": "2018-12-11T21:25:11.441Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] } ] } ``` ------ Per ulteriori informazioni, consulta [Controllo degli eventi di Amazon DocumentDB](event-auditing.md). # Scelta di regioni e zone di disponibilità Le risorse di cloud computing Amazon sono ospitate in più ubicazioni in tutto il mondo. Queste sedi sono costituite da zone di Regioni AWS disponibilità. Ciascuna *Regione AWS*è un'area geografica separata. Ciascuna regione presenta più località isolate, conosciute come *zone di disponibilità*. Amazon DocumentDB offre la possibilità di collocare risorse, come istanze e dati, in più posizioni. Le risorse non vengono replicate tra di loro Regioni AWS a meno che tu non lo faccia in modo specifico. Amazon gestisce data center avanzati e ad alta disponibilità. Anche se rari, i guasti che compromettono la disponibilità di istanze nella stessa ubicazione possono verificarsi. Se ospiti tutte le istanze in un'unica ubicazione colpita da tale guasto, nessuna di esse risulterà disponibile. Il diagramma seguente mostra una Regione AWS con tre zone di disponibilità. ![\[Diagramma di una regione contenente le tre zone di disponibilità a, b e c.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/RegionsAndAZs.png) È importante ricordare che ogni regione è indipendente. Qualsiasi attività di Amazon DocumentDB avviata (ad esempio, la creazione di istanze o l'elenco delle istanze disponibili) viene eseguita solo nell'impostazione predefinita corrente. Regione AWS Puoi modificare la regione predefinita nella console impostando la variabile di ambiente `EC2_REGION`. In alternativa, puoi sostituirla utilizzando il parametro `--region` nell' AWS CLI. Per ulteriori informazioni, consulta [Configurazione, in particolare AWS Command Line Interface, delle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) sezioni sulle variabili di ambiente e sulle opzioni della riga di comando. Quando crei un cluster utilizzando la console Amazon DocumentDB e scegli di creare una replica in una zona di disponibilità diversa, Amazon DocumentDB crea due istanze. Crea l'istanza primaria in una zona di disponibilità e l'istanza di replica in un'altra zona di disponibilità. Il volume cluster viene sempre replicato nelle tre zone di disponibilità. Per creare o utilizzare un'istanza Amazon DocumentDB in una specifica istanza Regione AWS, utilizza l'endpoint di servizio regionale corrispondente. ## Disponibilità nelle regioni Amazon DocumentDB è disponibile nelle seguenti AWS regioni. **Regioni supportate da Amazon DocumentDB** | Nome della regione | Regione | Zone di disponibilità (elaborazione) | | --- | --- | --- | | Stati Uniti orientali (Ohio) | `us-east-2` | 3 | | Stati Uniti orientali (Virginia settentrionale) | `us-east-1` | 6 | | Stati Uniti occidentali (Oregon) | `us-west-2` | 4 | | Africa (Città del Capo) | `af-south-1` | 3 | | Sud America (San Paolo) | `sa-east-1` | 3 | | Asia Pacifico (Hong Kong) | `ap-east-1` | 3 | | Asia Pacifico (Hyderabad) | `ap-south-2` | 3 | | Asia Pacifico (Malesia) | `ap-southeast-5` | 3 | | Asia Pacifico (Mumbai) | `ap-south-1` | 3 | | Asia Pacifico (Osaka) | `ap-northeast-3` | 3 | | Asia Pacifico (Seul) | `ap-northeast-2` | 4 | | Asia Pacifico (Singapore) | `ap-southeast-1` | 3 | | Asia Pacifico (Sydney) | `ap-southeast-2` | 3 | | Asia Pacifico (Giacarta) | `ap-southeast-3` | 3 | | Asia Pacifico (Melbourne) | `ap-southeast-4` | 3 | | Asia Pacifico (Thailandia) | `ap-southeast-7` | 3 | | Asia Pacifico (Tokyo) | `ap-northeast-1` | 3 | | Canada (Centrale) | `ca-central-1` | 3 | | Regione Cina (Pechino) | `cn-north-1` | 3 | | Cina (Ningxia) | `cn-northwest-1` | 3 | | Europa (Francoforte) | `eu-central-1` | 3 | | Europa (Zurigo) | `eu-central-2` | 3 | | Europa (Irlanda) | `eu-west-1` | 3 | | Europa (Londra) | `eu-west-2` | 3 | | Europa (Milano) | `eu-south-1` | 3 | | Europa (Parigi) | `eu-west-3` | 3 | | Europa (Spagna) | `eu-south-2` | 3 | | Europa (Stoccolma) | `eu-north-1` | 3 | | Messico (centrale) | `mx-central-1` | 3 | | Medio Oriente (Emirati Arabi Uniti) | `me-central-1` | 3 | | Israele (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (Stati Uniti occidentali) | `us-gov-west-1` | 3 | | AWS GovCloud (Stati Uniti orientali) | `us-gov-east-1` | 3 | Per impostazione predefinita, il fuso orario per un cluster Amazon DocumentDB è Universal Time Coordinated (UTC). Per ulteriori informazioni su come trovare gli endpoint di connessione per i cluster e le istanze in una specifica regione, consulta [Comprendere gli endpoint di Amazon DocumentDB](endpoints.md). # Gestione dei gruppi di parametri del cluster Amazon DocumentDB Puoi gestire la configurazione del motore Amazon DocumentDB utilizzando i parametri in un gruppo di parametri del cluster. Un *gruppo di parametri del cluster* è una raccolta di valori di configurazione di Amazon DocumentDB che semplificano la gestione dei parametri dei cluster Amazon DocumentDB. I gruppi di parametri del cluster fungono da container per i valori di configurazione del motore applicati a tutte le istanze nel cluster. In questa sezione viene descritto come creare, visualizzare e modificare i gruppi di parametri del cluster. Viene inoltre illustrato come puoi individuare a quale gruppo di parametri è associato a un determinato cluster. **Topics** + [Descrizione dei gruppi di parametri del cluster](cluster_parameter_groups-describe.md) + [Creazione di gruppi di parametri del cluster](cluster_parameter_groups-create.md) + [Modifica dei gruppi di parametri del cluster](cluster_parameter_groups-modify.md) + [Modifica dei cluster per utilizzare gruppi di parametri di cluster personalizzati](cluster_parameter_groups-modify_clusters.md) + [Copia dei gruppi di parametri del cluster](cluster_parameter_groups-copy.md) + [Reimpostazione dei gruppi di parametri del cluster](cluster_parameter_groups-reset.md) + [Eliminazione di gruppi di parametri del cluster](cluster_parameter_groups-delete.md) + [Riferimento ai parametri del cluster](cluster_parameter_groups-list_of_parameters.md) # Descrizione dei gruppi di parametri del cluster Amazon DocumentDB Un gruppo di parametri del `default` cluster viene creato automaticamente quando si crea il primo cluster Amazon DocumentDB in una nuova regione o si utilizza un nuovo motore. I cluster successivi, creati nella stessa regione e con la stessa versione del motore, vengono creati con il `default` gruppo di parametri del cluster. **Topics** + [Descrizione dei dettagli di un gruppo di parametri del cluster](#cluster_parameter_groups-describe_details) + [Determinazione del gruppo di parametri di un cluster](#cluster_parameter_groups-determine) + [Determinazione dei cluster e delle istanze associati a un gruppo di parametri del cluster](#cluster_parameter_groups-count) ## Descrizione dei dettagli di un gruppo di parametri del cluster Amazon DocumentDB Per descrivere i dettagli di un determinato gruppo di parametri del cluster, completa i seguenti passaggi utilizzando Console di gestione AWS o il AWS Command Line Interface (AWS CLI). ------ #### [ Using the 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Parameter groups (Gruppi di parametri)**, selezionare il gruppo di parametri del cluster di cui si desidera visualizzare i dettagli. 1. La pagina risultante mostra i parametri, l'attività recente e i tag del gruppo di parametri. + In **Cluster parameters (Parametri cluster)** puoi vedere il nome, il valore corrente, i valori consentiti, il tipo di dati e la descrizione del parametro e specifica se il parametro è modificabile. Puoi modificare i singoli parametri selezionando il parametro e scegliendo **Edit (Modifica)** nella sezione **Cluster parameters (Parametri cluster)**. Per ulteriori informazioni, consulta [Modifica dei parametri del cluster Amazon DocumentDB](cluster_parameter_groups-parameters.md). + In **Recent events (Eventi recenti)**, puoi vedere gli eventi più recenti per questo gruppo di parametri. Puoi filtrare questi eventi utilizzando la barra di ricerca in questa sezione. Per ulteriori informazioni, consulta [Gestione degli eventi di Amazon DocumentDB](managing-events.md). + In **Tags (Tag)** puoi visualizzare i tag di questo gruppo di parametri del cluster. Puoi aggiungere o rimuovere i tag scegliendo **Edit (Modifica)** nella sezione **Tags (Tag)**. Per ulteriori informazioni, consulta [Etichettatura delle risorse di Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Puoi utilizzare il `describe-db-cluster-parameter-groups` AWS CLI comando per visualizzare Amazon Resource Name (ARN), famiglia, descrizione e nome di un singolo gruppo di parametri del cluster o di tutti i gruppi di parametri del cluster di cui disponi per Amazon DocumentDB. Puoi anche utilizzare il `describe-db-cluster-parameters` AWS CLI comando per visualizzare i parametri e i relativi dettagli all'interno di un singolo gruppo di parametri del cluster. + **--describe-db-cluster-parameter-groups**— Per visualizzare un elenco di tutti i gruppi di parametri del cluster e i relativi dettagli. + **--db-cluster-parameter-group-name**— Facoltativo. Il nome del gruppo di parametri del cluster da descrivere. Se questo parametro viene omesso, vengono descritti tutti i gruppi di parametri del cluster. + **--describe-db-cluster-parameters**— Per elencare tutti i parametri all'interno di un gruppo di parametri e i relativi valori. + **--db-cluster-parameter-group name**: obbligatorio. Il nome del gruppo di parametri del cluster da descrivere. **Example** Il codice seguente elenca fino a 100 gruppi di parametri del cluster con relativi ARN, famiglia, descrizione e nome. ``` aws docdb describe-db-cluster-parameter-groups ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0", "DBParameterGroupFamily": "docdb4.0", "Description": "Default cluster parameter group for docdb4.0", "DBClusterParameterGroupName": "default.docdb4.0" }, { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group", "DBParameterGroupFamily": "docdb4.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** Il codice seguente elenca l'ARN, la famiglia, la descrizione e il nome per `sample-parameter-group`. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group", "Description": "Custom docdb4.0 parameter group", "DBParameterGroupFamily": "docdb4.0", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** Il codice seguente elenca i valori dei parametri in `sample-parameter-group`. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "17777", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ ## Determinazione del gruppo di parametri di un cluster Amazon DocumentDB Per determinare quale gruppo di parametri è associato a un particolare cluster, completa i passaggi seguenti utilizzando Console di gestione AWS o il AWS CLI. ------ #### [ Using the 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 a sinistra, seleziona **Cluster**. 1. Dall'elenco dei cluster seleziona il nome del cluster desiderato. 1. La pagina risultante mostra i dettagli del cluster selezionato. Scorri verso il basso fino a **Cluster details (Dettagli del cluster)**. Nella parte inferiore della sezione, individua il nome del gruppo di parametri sotto **Cluster parameter group (Gruppo di parametri del cluster)**. ![\[Screenshot: visualizzazione del gruppo di parametri di un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png) ------ #### [ Using the AWS CLI ] Il AWS CLI codice seguente determina quale gruppo di parametri governa il cluster. `sample-cluster` ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "sample-cluster", "sample-parameter-group" ] ] ``` ------ ## Determinazione di cluster e istanze associati a un gruppo di parametri del cluster Amazon DocumentDB Per determinare il numero di cluster e istanze associati a ciascun gruppo di parametri, completa i passaggi seguenti utilizzando. AWS CLI ------ #### [ Using the AWS CLI ] Il AWS CLI codice seguente determina a quanti cluster e istanze sono associati. `sample-parameter-group` Per Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \ --output json | \ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` Per Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^ --output json | ^ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "parameter_group_name": "sample-parameter-group", "total_clusters": 50, "total_instances": 150 } ``` ------ # Creazione di gruppi di parametri del cluster Amazon DocumentDB Gruppi di parametri di cluster predefiniti come `default.docdb5.0``default.docdb4.0`, o`default.docdb3.6`, vengono creati quando crei un cluster con una nuova versione del motore e in una nuova regione. I cluster successivi creati in questa regione e con la stessa versione del motore ereditano il gruppo di parametri del `default` cluster. Una volta creati, i gruppi di `default` parametri non possono essere eliminati o rinominati. Puoi modificare il comportamento del motore delle istanze del cluster creando un gruppo di parametri personalizzato con valori di parametri preferiti e collegandolo al tuo cluster Amazon DocumentDB. La seguente procedura ti guida nella creazione di un gruppo di parametri del cluster personalizzato. Quindi puoi [modificare i parametri all'interno del gruppo](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html). **Nota** Dopo aver creato un gruppo di parametri del cluster, devi attendere almeno 5 minuti prima di poterlo utilizzare. Ciò consente ad Amazon DocumentDB di completare completamente l'`create`azione prima che il gruppo di parametri del cluster venga utilizzato per un nuovo cluster. È possibile utilizzare l'`describe-db-cluster-parameter-groups` AWS CLI operazione Console di gestione AWS o per verificare che il gruppo di parametri del cluster sia stato creato. Per ulteriori informazioni, consulta [Descrizione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-describe.md). ------ #### [ Using the Console di gestione AWS ] **Per creare un gruppo di parametri 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere **Create (Crea)**. 1. Nel riquadro **Create cluster parameter group (Crea gruppo di parametri del cluster)** immettere quanto segue: 1. **Nuovo nome del gruppo di parametri del cluster**: inserisci un nome per il gruppo di parametri del cluster. Ad esempio, `sample-parameter-group`. I gruppi di parametri del cluster hanno i seguenti vincoli di denominazione: + La lunghezza è compresa tra 1 e 255 caratteri alfanumerici. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. 1. **Famiglia**: scegli una versione di DocumentDB che intendi utilizzare per il tuo cluster. 1. **Descrizione**: fornisce una descrizione per questo gruppo di parametri del cluster. 1. Per creare il gruppo di parametri del cluster, scegli **Create (Crea)**. Per annullare l'operazione, scegli **Cancel (Annulla)**. 1. Dopo aver scelto **Create (Crea)**, nella parte superiore della pagina viene visualizzato il testo seguente per verificare che il gruppo di parametri del cluster sia stato creato: ``` Successfully created cluster parameter group 'sample-parameter-group'. ``` ------ #### [ Using the AWS CLI ] Per creare un nuovo gruppo di parametri del cluster per i cluster Amazon DocumentDB 4.0, utilizza l' AWS CLI `create-db-cluster-parameter-group`operazione con i seguenti parametri: + **--db-cluster-parameter-group-name**— Il nome del gruppo di parametri del cluster personalizzato. Ad esempio, `sample-parameter-group`. + **--db-cluster-parameter-group-family**— La famiglia di gruppi di parametri del cluster utilizzata come modello per il gruppo di parametri di cluster personalizzato. + **--description**— La descrizione fornita dall'utente per questo gruppo di parametri del cluster. L'esempio seguente utilizza "`Custom docdb4.0 parameter group`». Per Linux, macOS o Unix: **Example** ``` aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb5.0 \ --description "Custom docdb5.0 parameter group" ``` Per Windows: ``` aws docdb create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --db-parameter-group-family docdb5.0 ^ --description "Custom docdb5.0 parameter group" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupName": "sample-parameter-group", "DBParameterGroupFamily": "docdb5.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupArn": "sample-parameter-group-arn" } } ``` ------ # Modifica dei gruppi di parametri del cluster Amazon DocumentDB Questa sezione spiega come modificare un gruppo di parametri Amazon DocumentDB *personalizzato*. In Amazon DocumentDB, non è possibile modificare un gruppo di parametri del `default` cluster creato quando si crea per la prima volta un cluster con una nuova versione del motore in una nuova regione. Se il tuo cluster Amazon DocumentDB utilizza il gruppo di parametri del cluster predefinito e desideri modificare un valore al suo interno, devi prima [creare un nuovo gruppo di parametri](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) o [copiare un gruppo di parametri esistente](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo e quindi applicare il gruppo di parametri modificato al cluster. Completa i seguenti passaggi per modificare un gruppo di parametri del cluster personalizzato. La propagazione delle azioni di modifica potrebbe richiedere del tempo. Attendi che il gruppo di parametri del cluster modificato sia disponibile prima di collegarlo al cluster. È possibile utilizzare l' AWS CLI `describe-db-cluster-parameters`operazione Console di gestione AWS o per verificare che il gruppo di parametri del cluster sia stato modificato. Per ulteriori informazioni, consulta [Descrizione dei gruppi di parametri del cluster](cluster_parameter_groups-describe.md). ------ #### [ Using the Console di gestione AWS ] Segui questi passaggi per modificare un gruppo di parametri Amazon DocumentDB personalizzato. Non puoi modificare un gruppo di parametri `default`. Se desideri modificare un valore nel gruppo di parametri `default`, puoi [copiare il gruppo di parametri del cluster predefinito](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo e quindi applicare il gruppo di parametri modificato al cluster. Per ulteriori informazioni sull'applicazione dei gruppi di parametri al cluster, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). **Per modificare un gruppo di parametri del cluster personalizzato** 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 riquadro di navigazione sul lato sinistro della console scegli **Parameter groups (Gruppi di parametri)**. Nell'elenco dei gruppi di parametri, scegli il nome del gruppo di parametri da modificare. **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. Per ogni parametro nel gruppo di parametri che desideri modificare, procedi nel seguente modo: 1. Individua il parametro che vuoi modificare e verifica che sia modificabile controllando se è elencato come `true` nella colonna **Modifiable (Modificabile)**. 1. Se è modificabile, seleziona il parametro e scegli **Edit (Modifica)** in alto a destra nella pagina della console. 1. Nella finestra di dialogo **Modify `` (Modifica)**, apporta le modifiche desiderate. Quindi scegli **Modify cluster parameter (Modifica parametro del cluster)** oppure scegli **Cancel (Annulla)** per annullare le modifiche. ------ #### [ Using the AWS CLI ] Puoi modificare o modificare qualsiasi parametro modificabile in un gruppo `ApplyMethod` di parametri del cluster Amazon DocumentDB personalizzato utilizzando il. `ParameterValue` `Description` AWS CLI Non puoi apportare modifiche direttamente in un gruppo di parametri del cluster predefinito. Per modificare i parametri di un gruppo di parametri del cluster personalizzato, utilizza l'operazione `modify-db-cluster-parameter-group` con i parametri seguenti. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster che stai modificando. + **--parameters**: obbligatorio. I parametri che stai modificando. Per un elenco dei parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB, consulta la. [Riferimento ai parametri del cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md) Ogni voce del parametro deve includere: + **ParameterName**— Il nome del parametro che stai modificando. + **ParameterValue**— Il nuovo valore per questo parametro. + **ApplyMethod**— Come si desidera applicare le modifiche a questo parametro. I valori consentiti sono `immediate` e `pending-reboot`. **Nota** I parametri con `ApplyType` per `static` devono avere `ApplyMethod` per `pending-reboot`. **Example - Modifica del valore di un parametro** In questo esempio, puoi elencare i valori dei parametri di `sample-parameter-group` e modificare il parametro `tls`. Quindi, dopo 5 minuti, puoi elencare di nuovo i valori dei parametri di `sample-parameter-group` per visualizzare i valori modificati. 1. Elenca i parametri e i relativi valori di `sample-parameter-group`. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. Modifica il parametro `tls` in modo che il valore sia `disabled`. Non puoi modificare `ApplyMethod` perché `ApplyType` è `static`. Per Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` Per Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Attendi almeno 5 minuti. 1. Elenca i valori dei parametri di `sample-parameter-group` per verificare che il parametro `tls` sia stato modificato. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "ParameterValue": "false", "ParameterName": "enable_audit_logs", "ApplyType": "dynamic", "DataType": "string", "Description": "Enables auditing on cluster.", "AllowedValues": "true,false", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterValue": "disabled", "ParameterName": "tls", "ApplyType": "static", "DataType": "string", "Description": "Config to enable/disable TLS", "AllowedValues": "disabled,enabled", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Modifica dei cluster Amazon DocumentDB per utilizzare gruppi di parametri di cluster personalizzati Quando crei un cluster Amazon DocumentDB, viene creato automaticamente un gruppo di `default.docdb4.0` parametri per quel cluster. Non è consentito modificare il gruppo di parametri `default`. Puoi invece modificare il tuo cluster Amazon DocumentDB per associarvi un nuovo gruppo di parametri personalizzato. Questa sezione spiega come modificare un cluster Amazon DocumentDB esistente per utilizzare un gruppo di parametri del cluster personalizzato utilizzando Console di gestione AWS and the AWS Command Line Interface ()AWS CLI. ------ #### [ Using the Console di gestione AWS ] **Per modificare un cluster Amazon DocumentDB per utilizzare un nuovo gruppo di parametri di cluster non predefinito** 1. Prima di iniziare, assicurati di aver creato un cluster Amazon DocumentDB e un gruppo di parametri del cluster. Vedere [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md) e [Creazione di gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-create.md) per ulteriori istruzioni. 1. Dopo aver creato il gruppo di parametri del cluster, apri la console Amazon DocumentDB all'indirizzo. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Nel riquadro di navigazione scegliere **Clusters (Cluster)** per aggiungere il nuovo gruppo di parametri a un cluster. 1. Scegliere il cluster a cui si desidera associare il gruppo di parametri. Scegliere **Actions (Operazioni)**, quindi scegliere **Modify (Modifica)** per modificare il cluster. 1. In **Cluster options (Opzioni cluster)**, scegliere il nuovo gruppo di parametri a cui si desidera associare il cluster. 1. Scegliere **Continue (Continua)** per visualizzare un riepilogo delle modifiche. 1. Dopo aver verificato le modifiche, è possibile applicarle immediatamente o durante la successiva finestra di manutenzione in **Scheduling of modifications (Pianificazione delle modifiche)**. 1. Scegliere **Modify cluster (Modifica cluster)** per aggiornare il cluster con il nuovo gruppo di parametri. ------ #### [ Using the AWS CLI ] Prima di iniziare, assicurati di aver creato un cluster Amazon DocumentDB e un gruppo di parametri del cluster. È possibile [creare un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) utilizzando l' AWS CLI `create-db-cluster`operazione. È possibile [creare un gruppo di parametri del cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) utilizzando l' AWS CLI `create-db-cluster-parameter-group`operazione. Per aggiungere il nuovo gruppo di parametri del cluster al cluster, utilizzare l' AWS CLI `modify-db-cluster`operazione con i seguenti parametri. + **-- db-cluster-identifier** — Il nome del cluster (ad esempio,`sample-cluster`). + **-- db-cluster-parameter-group -name** — Il nome del gruppo di parametri a cui desiderate associare il cluster (ad esempio,`sample-parameter-group`). **Example** ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` "DBCluster": { "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", ... } ``` ------ # Copia dei gruppi di parametri del cluster Amazon DocumentDB Puoi creare una copia di un gruppo di parametri del cluster in Amazon DocumentDB utilizzando Console di gestione AWS o il AWS Command Line Interface ()AWS CLI. ------ #### [ Using the Console di gestione AWS ] La procedura seguente ti guida nella creazione di un nuovo gruppo di parametri del cluster eseguendo una copia di un gruppo di parametri cluster esistente. **Per copiare un gruppo di parametri 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. 1. Nel riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere il nome del gruppo di parametri del cluster di cui si desidera visualizzare i dettagli. 1. Scegliere **Actions (Operazioni)**, quindi scegliere **Copy (Copia)** per copiare il gruppo di parametri. 1. In **Copy options (Opzioni copia)**, immettere un nome e una descrizione per il nuovo gruppo di parametri del cluster. Quindi scegliere **Copy (Copia)** per salvare le modifiche. ------ #### [ Using the AWS CLI ] Per copiare un gruppo di parametri del cluster, utilizza l'operazione `copy-db-cluster-parameter-group` con i parametri seguenti. + **--source-db-cluster-parameter-group-identifier**: obbligatorio. Il nome o l'Amazon Resource Name (ARN) del gruppo di parametri del cluster da copiare. Se i gruppi di parametri del cluster di origine e di destinazione coincidono Regione AWS, l'identificatore può essere un nome o un ARN. Se i gruppi di parametri del cluster di origine e di destinazione sono diversi Regioni AWS, l'identificatore deve essere un ARN. + **--target-db-cluster-parameter-group-identifier**: obbligatorio. Il nome o l'ARN della copia del gruppo di parametri del cluster. Vincoli: + Non può essere null o vuoto. + Deve contenere da 1 a 255 lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + **--target-db-cluster-parameter-group-description**: obbligatorio. Una descrizione per la copia del gruppo di parametri del cluster fornita dall'utente. **Example** Il codice seguente crea una copia di `sample-parameter-group`, denominandola `sample-parameter-group-copy`. Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier sample-parameter-group \ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy \ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` Per Windows: ``` aws docdb copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier sample-parameter-group ^ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy", "DBClusterParameterGroupName": "sample-parameter-group-copy", "DBParameterGroupFamily": "docdb4.0", "Description": "Copy of sample-parameter-group" } } ``` ------ # Reimpostazione dei gruppi di parametri del cluster Amazon DocumentDB Puoi ripristinare alcuni o tutti i valori dei parametri di un gruppo di parametri del cluster Amazon DocumentDB ai valori predefiniti utilizzando Console di gestione AWS o the AWS Command Line Interface (AWS CLI) per reimpostare il gruppo di parametri del cluster. ------ #### [ Using the Console di gestione AWS ] Attieniti alla seguente procedura per reimpostare alcuni o tutti i valori di un parametro di un gruppo di parametri del cluster ai valori predefiniti. **Per reimpostare i valori dei parametri di un gruppo di parametri 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 riquadro di navigazione sul lato sinistro della console scegli **Parameter groups (Gruppi di parametri)**. 1. Nel riquadro **Cluster parameter groups (Gruppi di parametri del cluster)**, scegliere il nome del gruppo di parametri del cluster da reimpostare. 1. Scegliere **Actions (Operazioni)**, quindi scegliere **Reset (Reimposta)** per reimpostare il gruppo di parametri. 1. Nella pagina di **conferma della reimpostazione del gruppo di parametri del cluster** restituita, confermare che si desidera reimpostare i valori predefiniti di tutti i parametri del cluster per il gruppo di parametri. Quindi scegliere **Reset (Reimposta)** per reimpostare il gruppo di parametri. È anche possibile selezionare **Cancel (Annulla)** per annullare le modifiche. ------ #### [ Using the AWS CLI ] Per reimpostare alcuni o tutti i valori di un parametro di un gruppo di parametri del cluster ai valori predefiniti, puoi utilizzare l'operazione `reset-db-cluster-parameter-group` con i parametri seguenti. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster da reimpostare. + **--parameters**— Facoltativo. Un elenco di `ParameterName` e `ApplyMethod` nel gruppo di parametri del cluster da ripristinare ai valori predefiniti. I parametri statici devono essere impostati su `pending-reboot` per essere applicati al successivo riavvio dell'istanza o quando viene eseguita la richiesta`reboot-db-instance`. Devi chiamare `reboot-db-instance` per ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato. Questo parametro e `--reset-all-parameters` sono reciprocamente esclusivi: puoi utilizzarne uno solo, non entrambi. + **--reset-all-parameters**oppure **--no-reset-all-parameters** — Facoltativo. Specifica se ripristinare tutti i parametri (`--reset-all-parameters`) o solo alcuni (`--no-reset-all-parameters`) ai valori predefiniti. Il parametro `--reset-all-parameters` e `--parameters` sono reciprocamente esclusivi: puoi utilizzarne uno solo, non entrambi. Quando reimposti l'intero gruppo, i parametri dinamici vengono aggiornati immediatamente. I parametri statici devono essere impostati su `pending-reboot` per essere applicati al successivo riavvio dell'istanza o quando viene eseguita la richiesta `reboot-db-instance`. Devi chiamare `reboot-db-instance` per ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato. **Example** **Esempio 1: reimpostazione di tutti i parametri ai valori predefiniti** Il codice seguente reimposta tutti i parametri nel gruppo di parametri del cluster `sample-parameter-group` ai valori predefiniti. Per Linux, macOS o Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --reset-all-parameters ``` Per Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --reset-all-parameters ``` **Esempio 2: reimpostazione di parametri specifici ai valori predefiniti** Il codice seguente reimposta il parametro `tls` nel gruppo di parametri del cluster `sample-parameter-group` al valore predefinito. Per Linux, macOS o Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --no-reset-all-parameters \ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` Per Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --no-reset-all-parameters ^ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` **Riavvio di un'istanza cluster** Prima di modificare il valore di un parametro statico, l'istanza cluster deve essere riavviata. Riavvia ogni istanza nel cluster a cui desideri applicare il parametro statico aggiornato. Per Linux, macOS o Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-cluster-instance ``` Per Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-cluster-instance ``` ------ # Eliminazione di gruppi di parametri del cluster Amazon DocumentDB Puoi eliminare un gruppo di parametri del cluster Amazon DocumentDB personalizzato utilizzando Console di gestione AWS o il AWS Command Line Interface ()AWS CLI. Non è possibile eliminare il gruppo di parametri del cluster `default.docdb4.0`. ------ #### [ Using the Console di gestione AWS ] **Per eliminare un gruppo di parametri 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Parameter groups (Gruppi di parametri)** scegli il pulsante di opzione a sinistra del gruppo di parametri del cluster da eliminare. 1. Scegli **Azioni**, quindi **Elimina**. 1. Nel riquadro di conferma **Delete (Elimina)** scegliere **Delete (Elimina)** per eliminare il gruppo di parametri del cluster. **Per mantenere il gruppo di parametri del cluster, scegli Annulla.** ------ #### [ Using the AWS CLI ] Per eliminare un gruppo di parametri del cluster, utilizza l'operazione `delete-db-cluster-parameter-group` con il parametro seguente. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster da eliminare. Deve essere un gruppo di parametri del cluster esistente. *Non è possibile eliminare il gruppo di parametri del cluster `default.docdb4.0`. * **Example - Eliminazione di un gruppo di parametri del cluster** L'esempio seguente descrive le tre fasi che consentono di eliminare un gruppo di parametri del cluster: 1. Ricerca del nome del gruppo di parametri del cluster da eliminare. 1. Eliminazione del gruppo di parametri del cluster specificato. 1. Verifica dell'avvenuta eliminazione del gruppo di parametri del cluster. **1. Cerca il nome del gruppo di parametri del cluster da eliminare.** Il codice seguente elenca i nomi di tutti i gruppi di parametri del cluster. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Per Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` L'output dell'operazione precedente è un elenco dei nomi dei gruppi di parametri del cluster simile al seguente (formato JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ], [ "sample-parameter-group-copy" ] ] ``` **2. Elimina un gruppo di parametri del cluster specifico.** Il codice seguente elimina il gruppo di parametri del cluster `sample-parameter-group-copy`. Per Linux, macOS o Unix: ``` aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Per Windows: ``` aws docdb delete-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Questa operazione non produce alcun output. **3. Verifica dell'avvenuta eliminazione del gruppo di parametri del cluster specificato.** Il codice seguente elenca i nomi di tutti i gruppi di parametri del cluster rimanenti. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Per Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` L'output dell'operazione precedente è un elenco dei gruppi di parametri del cluster simile al seguente (formato JSON). Il gruppo di parametri del cluster appena eliminato non deve comparire nell'elenco. L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ] ] ``` ------ # Riferimento ai parametri del cluster Amazon DocumentDB Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione *Apply Immediately (Applica immediatamente)*. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata dopo che avrai riavviato manualmente l'istanza. Puoi riavviare un'istanza utilizzando la console Amazon DocumentDB o chiamando esplicitamente. `reboot-db-instance` La tabella seguente mostra i parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB. **Parametri a livello di cluster Amazon DocumentDB** | Parametro | Valore predefinito | Valori validi | Modificabile | Applica tipo | Tipo di dati | Description | | --- | --- | --- | --- | --- | --- | --- | | audit\$1logs | disabled | abilitati, disabilitati, ddl, dml\$1read, dml\$1write, all, none | Sì | Dinamico | Stringa | Definisce se i log CloudWatch di controllo di Amazon sono abilitati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Sì | Dinamico | Numero intero | Definisce la durata del tempo (in secondi) in cui il registro del flusso di modifiche viene mantenuto e può essere consumato. | | default\$1collection\$1compression | disabled | abilitato, disabilitato (Amazon DocumentDB 5.0)/zstd, lz4, nessuno (Amazon Document 2.0) DB8 | Sì | Dinamico | Stringa | Definisce l'impostazione di compressione predefinita per le nuove raccolte in un cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler | disabled | abilitato, disabilitato | Sì | Dinamico | Stringa | Abilita il profiling per operazioni lente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler\$1sampling\$1rate | 1.0 | 0,0 - 1,0 | Sì | Dinamico | Float | Definisce la frequenza di campionamento per le operazioni registrate. | | profiler\$1threshold\$1ms | 100 | 50-2147483646 | Sì | Dinamico | Numero intero | Definisce la soglia per profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | planner\$1version | 3.0 | 1,0, 2,0, 3,0 | Sì | Dinamico | Float | Definisce la versione del pianificatore di query da utilizzare per le query.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | tls | abilitato | abilitato, disabilitato, fips-140-3, tls1.2\$1, tls1.3\$1 | Sì | Statico | Stringa | Definisce se sono necessarie connessioni Transport Layer Security (TLS). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | ttl\$1monitor | abilitato | abilitato, disabilitato | Sì | Dinamico | Stringa | Definisce se il monitoraggio Time to Live (TTL) è abilitato per il cluster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | # Modifica dei parametri del cluster Amazon DocumentDB In Amazon DocumentDB, *i gruppi di parametri del cluster* *sono costituiti da parametri* che si applicano a tutte le istanze create nel cluster. Per i gruppi di parametri del cluster personalizzati, puoi modificare un valore di parametro in qualsiasi momento o reimpostare tutti i valori dei parametri sulle impostazioni predefinite per i gruppi di parametri creati. Questa sezione descrive come visualizzare i parametri che costituiscono un gruppo di parametri del cluster Amazon DocumentDB e i relativi valori e come modificare o aggiornare questi valori. I parametri possono essere *dinamici* o *statici*. Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione `Apply Immediately`. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata solo dopo che avrai riavviato manualmente le istanze. ## Visualizzazione dei parametri di un gruppo di parametri del cluster Amazon DocumentDB Puoi visualizzare i parametri di un cluster Amazon DocumentDB e i relativi valori utilizzando o. Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] **Per visualizzare i dettagli di un gruppo di parametri 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Parameter groups (Gruppi di parametri)**, scegli il nome del gruppo di parametri del cluster di cui desideri visualizzare i dettagli. 1. La pagina risultante mostra i seguenti valori per ciascun parametro: nome del parametro, valore corrente, valori consentiti, se il parametro è modificabile, tipo di applicazione, tipo di dati e descrizione. ![\[Screenshot: nomi e valori dei parametri.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png) ------ #### [ Using the AWS CLI ] Per visualizzare i parametri e i valori di un gruppo di parametri del cluster, utilizza l'operazione `describe-db-cluster-parameters` con i parametri seguenti. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster di cui ottenere un elenco di parametri dettagliato. + **--source**— Facoltativo. Se fornito, restituisce solo i parametri per una determinata origine. Le origini dei parametri possono essere `engine-default`, `system` o `user`. **Example** Il codice seguente elenca i parametri e i relativi valori per il gruppo di parametri `custom3-6-param-grp`. Per ulteriori informazioni sul gruppo di parametri, ometti la riga `--query`. Per informazioni su tutti i gruppi di parametri, ometti la riga `--db-cluster-parameter-group-name`. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp \ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name custom3-6-param-grp ^ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "audit_logs", "disabled" ], [ "tls", "enabled" ], [ "ttl_monitor", "enabled" ] ] ``` ------ ## Modifica dei parametri di un gruppo di parametri del cluster Amazon DocumentDB Puoi modificare i parametri di un gruppo di parametri utilizzando o. Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] **Per aggiornare i parametri di un gruppo di parametri 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Parameter groups (Gruppi di parametri)** scegliere il gruppo di parametri del cluster di cui si desidera aggiornare i parametri. 1. La pagina risultante mostra i parametri e i relativi dettagli corrispondenti per questo gruppo di parametri del cluster. Selezionare un parametro da aggiornare. 1. In alto a destra della pagina, scegliere **Edit (Modifica)** per modificare il valore del parametro. Per ulteriori informazioni sui tipi di parametri del cluster, consulta [Riferimento ai parametri del cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). 1. Apportare la modifica, quindi scegliere **Modify cluster parameter (Modifica parametro cluster)** per salvare le modifiche. Per annullare le modifiche, selezionare **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] Per modificare i parametri di un gruppo di parametri del cluster, utilizzare l'operazione `modify-db-cluster-parameter-group` con i parametri seguenti. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster che stai modificando. + **--parameters**: obbligatorio. Il parametro o i parametri che stai modificando. Ogni voce del parametro deve includere: + **ParameterName**— Il nome del parametro che stai modificando. + **ParameterValue**— Il nuovo valore per questo parametro. + **ApplyMethod**— Come si desidera applicare le modifiche a questo parametro. I valori consentiti sono `immediate` e `pending-reboot`. **Nota** I parametri con `ApplyType` per `static` devono avere `ApplyMethod` per `pending-reboot`. **Per modificare i valori dei parametri di un gruppo di parametri del cluster (AWS CLI)** L'esempio seguente cambia il parametro `tls`. 1. **Elenca i parametri e i relativi valori di `sample-parameter-group`**. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. **Modifica il parametro `tls` in modo che il relativo valore sia `disabled`**. Non puoi modificare `ApplyMethod` perché `ApplyType` è `static`. Per Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` Per Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. **Attendi almeno 5 minuti.** 1. **Elenca i valori dei parametri di `sample-parameter-group`.** Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "tls", "ParameterValue": "disabled", "Description": "Config to enable/disable TLS", "Source": "user", "ApplyType": "static", "DataType": "string", "AllowedValues": "disabled,enabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Comprendere gli endpoint di Amazon DocumentDB Puoi usare gli endpoint Amazon DocumentDB (con compatibilità con MongoDB) per connetterti a un cluster o a un'istanza. Amazon DocumentDB ha tre diversi tipi di endpoint, ciascuno con un proprio scopo. **Topics** + [Individuazione degli endpoint di un cluster](db-cluster-endpoints-find.md) + [Individuazione dell'endpoint di un'istanza](db-instance-endpoint-find.md) + [Connessione agli endpoint](endpoints-connecting.md) **Endpoint del cluster** Un 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 singolo endpoint del cluster e un'istanza principale. Nel caso di un failover, l'endpoint del cluster viene rimappato alla nuova istanza primaria. **Endpoint di lettura** Un endpoint reader è 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. **Endpoint dell'istanza** Per endpoint dell'istanza si intende un endpoint che si connette a un'istanza specifica. Ogni istanza in un cluster, a prescindere che sia primaria o di replica, ha un proprio endpoint dell'istanza esclusivo. Si consiglia di non utilizzare gli endpoint dell'istanza nell'applicazione. Questo perché possono variare ruoli in caso di un failover, richiedendo in tal modo modifiche del codice nell'applicazione. # Individuazione degli endpoint di un cluster Puoi trovare l'endpoint del cluster e l'endpoint reader di un cluster utilizzando la console Amazon DocumentDB o. AWS CLI ------ #### [ Using the Console di gestione AWS ] **Per trovare gli endpoint di un cluster 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 **Clusters (Cluster)**. 1. Dall'elenco dei cluster scegli il nome del cluster desiderato. 1. **Nella pagina dei dettagli del cluster, seleziona la scheda Configurazione.** Nella sezione **Configurazioni e stato**, troverai l'endpoint **Cluster e l'endpoint** **Reader**. ![\[Sezione Configurazioni e stato che mostra gli endpoint del cluster e del lettore.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-endpoints.png) 1. Per connetterti a questo cluster, seleziona la scheda **Connettività e sicurezza**. Individua la stringa di connessione per la `mongo` shell e la stringa di connessione che può essere utilizzata nel codice dell'applicazione per connettersi al cluster. ![\[Sezione Connect che mostra una stringa per connettersi all'istanza con la shell mongo e una stringa per connettersi al cluster con un'applicazione.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-connection-strings.png) ------ #### [ Using the AWS CLI ] Per trovare gli endpoint del cluster e del lettore per il tuo cluster utilizzando AWS CLI, esegui il `describe-db-clusters` comando con questi parametri. **Parametri** + **--db-cluster-identifier**—Facoltativo. Specifica il cluster per il quale restituire l'endpoint. Se omesso, restituisce gli endpoint per un massimo di 100 cluster. + **--query**—Facoltativo. Specifica i campi da visualizzare. È utile per ridurre la quantità di dati da visualizzare per trovare gli endpoint. Se omesso, vengono restituite tutte le informazioni su un cluster. + **--region**—Facoltativo. Il parametro `--region` consente di specificare la regione a cui applicare il comando. Se omesso, viene usata la regione predefinita. **Example** L'esempio seguente restituisce l'endpoint `DBClusterIdentifier` (endpoint del cluster) e `ReaderEndpoint` per `sample-cluster`. Per Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --region us-east-1 \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` Per Windows: ``` aws docdb describe-db-clusters ^ --region us-east-1 ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "sample-cluster", 27017, "sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com", "sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com" ] ] ``` Dopo aver installato l'endpoint del cluster, puoi connetterti al cluster con `mongo` o `mongodb`. Per ulteriori informazioni, consulta [Connessione agli endpoint](endpoints-connecting.md). ------ # Individuazione dell'endpoint di un'istanza Puoi trovare l'endpoint per un'istanza utilizzando la console Amazon DocumentDB o il. AWS CLI ------ #### [ Using the Console di gestione AWS ] **Per trovare l'endpoint dell'istanza con 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 **Clusters (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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente. ![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png) 1. Seleziona la casella a sinistra dell'istanza che ti interessa. 1. Scorri la sezione **Details (Dettagli)** per individuare l'endpoint dell'istanza. ![\[Screenshot della console che mostra la pagina dei dettagli con l'endpoint dell'istanza evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-instance-endpoint.png) 1. Per connetterti a questa istanza, scorri fino alla sezione **Connect (Connetti)**. Individua la stringa di connessione per la shell `mongo` e una stringa di connessione che può essere utilizzata nel codice dell'applicazione per connetterti all'istanza. ![\[Schermata della console che mostra la sezione Connect con la shell mongo e le stringhe di connessione dell'applicazione evidenziate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-connection-strings.png) ------ #### [ Using the AWS CLI ] Per trovare l'endpoint dell'istanza utilizzando il AWS CLI, esegui il comando seguente con questi argomenti. **Argomenti** + **--db-instance-identifier**—Facoltativo. Specifica l'istanza per la quale restituire l'endpoint. Se omesso, restituisce l'endpoint per un massimo di 100 istanze. + **--query**—Facoltativo. Specifica i campi da visualizzare. È utile per ridurre la quantità di dati da visualizzare per trovare gli endpoint. Se omesso, vengono restituite tutte le informazioni su un'istanza. Il campo `Endpoint` ha tre membri, quindi la sua inclusione nella query, come nell'esempio seguente, restituisce tutti e tre i membri. Se sei interessato solo ad alcuni dei membri `Endpoint`, sostituisci `Endpoint` nella query con i membri desiderati, come nel secondo esempio. + **--region**—Facoltativo. Il parametro `--region` consente di specificare la regione a cui applicare il comando. Se omesso, viene usata la regione predefinita. **Example** Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` Per Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "sample-cluster-instance", { "Port": 27017, "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com", "HostedZoneId": "Z2R2ITUGPM61AM" } ] ] ``` Riducendo l'output per eliminare `HostedZoneId` del codice puoi modificare la query specificando `Endpoint.Port` e `Endpoint.Address`. Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` Per Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "sample-cluster-instance", 27017, "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com" ] ] ``` Dopo aver installato l'endpoint dell'istanza, puoi connetterti all'istanza con `mongo` o `mongodb`. Per ulteriori informazioni, consulta [Connessione agli endpoint](endpoints-connecting.md). ------ # Connessione agli endpoint Quando hai l'endpoint del cluster o dell'istanza, puoi connettersi a esso utilizzando la shell `mongo` o una stringa di connessione. ## Connessione tramite la shell mongo Utilizza la struttura seguente per costruire la stringa necessaria per connetterti al cluster o all'istanza utilizzando la shell `mongo`: ``` mongo \ --ssl \ --host Endpoint:Port \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` **Esempi della shell `mongo`** Connessione a un cluster. ``` mongo \ --ssl \ --host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` Connessione a un'istanza: ``` mongo \ --ssl \ --host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` ## Connessione tramite una stringa di connessione Utilizza la struttura seguente per costruire la stringa di connessione necessaria per connetterti al cluster o all'istanza. ``` mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` **Esempi di stringa di connessione** Connessione a un cluster. ``` mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` Connessione a un'istanza: ``` mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ```   # Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs Le risorse che AWS crei sono identificate in modo univoco con un Amazon Resource Name (ARN). Per alcune operazioni con Amazon DocumentDB (con compatibilità con MongoDB), devi identificare in modo univoco una risorsa Amazon DocumentDB specificandone l'ARN. Ad esempio, quando aggiungi un tag a una risorsa, devi fornire l'ARN della risorsa. **Topics** + [Costruzione di un ARN](#documentdb-arns-constructing) + [Ricerca di un ARN](#documentdb-arns-find) ## Creazione di un ARN per una risorsa Amazon DocumentDB Puoi creare un ARN per una risorsa Amazon DocumentDB utilizzando la seguente sintassi. Amazon DocumentDB condivide il formato di Amazon Relational Database Service (Amazon RDS). ARNs Amazon DocumentDB ARNs contiene `rds` e non contiene. `docdb` `arn:aws:rds:region:account_number:resource_type:resource_id` | Nome della regione | Regione | Zone di disponibilità (elaborazione) | | --- | --- | --- | | Stati Uniti orientali (Ohio) | `us-east-2` | 3 | | Stati Uniti orientali (Virginia settentrionale) | `us-east-1` | 6 | | Stati Uniti occidentali (Oregon) | `us-west-2` | 4 | | Africa (Città del Capo) | `af-south-1` | 3 | | Sud America (San Paolo) | `sa-east-1` | 3 | | Asia Pacifico (Hong Kong) | `ap-east-1` | 3 | | Asia Pacifico (Hyderabad) | `ap-south-2` | 3 | | Asia Pacifico (Malesia) | `ap-southeast-5` | 3 | | Asia Pacifico (Mumbai) | `ap-south-1` | 3 | | Asia Pacifico (Osaka) | `ap-northeast-3` | 3 | | Asia Pacifico (Seul) | `ap-northeast-2` | 4 | | Asia Pacifico (Singapore) | `ap-southeast-1` | 3 | | Asia Pacifico (Sydney) | `ap-southeast-2` | 3 | | Asia Pacifico (Giacarta) | `ap-southeast-3` | 3 | | Asia Pacifico (Melbourne) | `ap-southeast-4` | 3 | | Asia Pacifico (Thailandia) | `ap-southeast-7` | 3 | | Asia Pacifico (Tokyo) | `ap-northeast-1` | 3 | | Canada (Centrale) | `ca-central-1` | 3 | | Regione Cina (Pechino) | `cn-north-1` | 3 | | Cina (Ningxia) | `cn-northwest-1` | 3 | | Europa (Francoforte) | `eu-central-1` | 3 | | Europa (Zurigo) | `eu-central-2` | 3 | | Europa (Irlanda) | `eu-west-1` | 3 | | Europa (Londra) | `eu-west-2` | 3 | | Europa (Milano) | `eu-south-1` | 3 | | Europa (Parigi) | `eu-west-3` | 3 | | Europa (Spagna) | `eu-south-2` | 3 | | Europa (Stoccolma) | `eu-north-1` | 3 | | Messico (centrale) | `mx-central-1` | 3 | | Medio Oriente (Emirati Arabi Uniti) | `me-central-1` | 3 | | Israele (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (Stati Uniti occidentali) | `us-gov-west-1` | 3 | | AWS GovCloud (Stati Uniti orientali) | `us-gov-east-1` | 3 | **Nota** L'architettura Amazon DocumentDB separa storage ed elaborazione. Per il livello di storage, Amazon DocumentDB replica sei copie dei dati in tre zone di AWS disponibilità (). AZs AZs Quelli elencati nella tabella precedente sono il numero di istanze AZs che è possibile utilizzare in una determinata regione per fornire istanze di calcolo. Ad esempio, se avvii un cluster Amazon DocumentDB in ap-northeast-1, lo storage verrà replicato in sei modi su tre, ma le istanze di calcolo saranno disponibili solo in due. AZs AZs La tabella seguente mostra il formato da utilizzare per creare un ARN per una particolare risorsa Amazon DocumentDB. Amazon DocumentDB condivide il formato di Amazon RDS. ARNs Amazon DocumentDB ARNs contiene `rds` e non contiene. `docdb` | Tipo di risorsa | Formato ARN/Esempio | | --- | --- | | Istanza (`db`) | `arn:aws:rds:region:account_number:db:resource_id` 
arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
| | Cluster (`cluster`) | `arn:aws:rds:region:account_number:cluster:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
| | Gruppo di parametri del cluster (`cluster-pg`) | `arn:aws:rds:region:account_number:cluster-pg:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group
| | Gruppo di sicurezza (`secgrp`) | `arn:aws:rds:region:account_number:secgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
| | Snapshot del cluster (`cluster-snapshot`) | `arn:aws:rds:region:account_number:cluster-snapshot:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot
| | Gruppo di sottoreti (`subgrp`) | `arn:aws:rds:region:account_number:subgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10
| ## Ricerca dell'ARN di una risorsa Amazon DocumentDB Puoi trovare l'ARN di una risorsa Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI ------ #### [ Using the Console di gestione AWS ] Per trovare un ARN utilizzando la console, accedi alla risorsa di cui desideri l'ARN e visualizzane i relativi dettagli. Ad esempio, è possibile ottenere l'ARN per un cluster selezionando la scheda **Configurazione** nella pagina dei dettagli del cluster. L'ARN è disponibile nella sezione **Configurazioni e stato**, come mostrato nella schermata seguente. ![\[Screenshot della console che mostra un ARN nella sezione sullo stato e le configurazioni del riquadro dei dettagli.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/documentdb-arn.png) ------ #### [ Using the AWS CLI ] Per ottenere un ARN utilizzando il AWS CLI per una particolare risorsa Amazon DocumentDB, usa `describe` l'operazione per quella risorsa. La tabella seguente mostra ogni AWS CLI operazione e la proprietà ARN utilizzata con l'operazione per ottenere un ARN. | AWS CLI Comando | Proprietà ARN | | --- | --- | | `describe-db-instances` | `DBInstanceArn` | | `describe-db-clusters` | `DBClusterArn` | | `describe-db-parameter-groups` | `DBParameterGroupArn` | | `describe-db-cluster-parameter-groups` | `DBClusterParameterGroupArn` | | `describe-db-security-groups` | `DBSecurityGroupArn` | | `describe-db-snapshots` | `DBSnapshotArn` | | `describe-db-cluster-snapshots` | `DBClusterSnapshotArn` | | `describe-db-subnet-groups` | `DBSubnetGroupArn` | **Example - Ricerca dell'ARN per un cluster** L' AWS CLI operazione seguente trova l'ARN per il cluster. `sample-cluster` Per Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` Per Windows: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster" ] ``` **Example - ARNs Ricerca di più gruppi di parametri** Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` Per Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6" ] ``` ------ # Etichettatura delle risorse di Amazon DocumentDB Puoi utilizzare i tag Amazon DocumentDB (con compatibilità con MongoDB) per aggiungere metadati alle tue risorse Amazon DocumentDB. Questi tag possono essere utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse. Puoi utilizzare questi tag anche per tenere traccia dei costi raggruppando le spese per risorse con tag simili. Puoi taggare le seguenti risorse Amazon DocumentDB: + Cluster + Istanze + Snapshot + Snapshot cluster + Gruppi di parametri + Gruppi di parametri di cluster + Gruppi di sicurezza + Gruppi di sottoreti ## Panoramica dei tag di risorsa di Amazon DocumentDB Un tag Amazon DocumentDB è una coppia nome-valore che definisci e associ a una risorsa Amazon DocumentDB. Il nome viene definito *chiave*. L'indicazione di un valore per la chiave è un'operazione facoltativa. Puoi utilizzare i tag per assegnare informazioni arbitrarie a una risorsa Amazon DocumentDB. Una chiave tag potrebbe essere impiegata, ad esempio, per definire una categoria e il valore di tag potrebbe essere un elemento di tale categoria. Ad esempio, è possibile definire una chiave di tag `project` e un valore di tag di`Salix`, a indicare che la risorsa Amazon DocumentDB è assegnata al progetto Salix. Puoi anche utilizzare i tag per designare le risorse di Amazon DocumentDB da utilizzare per test o produzione utilizzando una chiave come `environment=test` o. `environment=production` Ti consigliamo di utilizzare un set coerente di chiavi di tag per semplificare il monitoraggio dei metadati associati alle risorse di Amazon DocumentDB. Puoi utilizzare i tag per organizzare la AWS fattura in modo da rispecchiare la tua struttura di costi. A tale scopo, registrati per ricevere la Account AWS fattura con i valori chiave dell'etichetta inclusi. Per visualizzare il costo delle risorse combinate, puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione per visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni, consulta [Utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *AWS Guida per l'utente di Billing and Cost Management*. Ogni risorsa Amazon DocumentDB ha un set di tag che contiene tutti i tag assegnati a quella risorsa. Un set di tag può contenere fino a 10 tag ma può anche essere vuoto. Se aggiungi un tag a una risorsa Amazon DocumentDB che ha la stessa chiave di un tag esistente sulla risorsa, il nuovo valore sovrascrive il vecchio valore. AWS non applica alcun significato semantico ai tag; i tag vengono interpretati rigorosamente come stringhe di caratteri. Amazon DocumentDB può impostare tag su un'istanza o altre risorse Amazon DocumentDB, a seconda delle impostazioni utilizzate al momento della creazione della risorsa. Ad esempio, Amazon DocumentDB potrebbe aggiungere un tag che indica che un'istanza è destinata alla produzione o al test. Puoi aggiungere un tag a una snapshot, tuttavia questo raggruppamento non sarà indicato riportato nella fattura. Puoi usare Console di gestione AWS o AWS CLI per aggiungere, elencare ed eliminare tag sulle risorse di Amazon DocumentDB. Quando utilizzi AWS CLI, devi fornire l'Amazon Resource Name (ARN) per la risorsa con cui desideri lavorare. Per ulteriori informazioni su Amazon DocumentDB ARNs, consulta. [Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs](documentdb-arns.md) ## Vincoli relativi ai tag I seguenti vincoli si applicano ai tag Amazon DocumentDB: + Numero massimo di tag per risorsa: 10 + Lunghezza massima della **chiave**: 128 caratteri Unicode + Lunghezza massima del **valore**: 256 caratteri Unicode + Caratteri validi per la **chiave** e il **valore**: lettere maiuscole e minuscole nel set di caratteri UTF-8, numeri, spazio e i seguenti caratteri: `_ . : / = + -` e `@` (espressioni regolari Java: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) + I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole. + Il prefisso `aws:` non può essere utilizzato per chiavi o valori dei tag, ma è riservato per AWS. ## Aggiungere e aggiornare tag su una risorsa Amazon DocumentDB Puoi aggiungere fino a 10 tag a una risorsa utilizzando Console di gestione AWS o il AWS CLI. ------ #### [ Using the Console di gestione AWS ] Il processo di aggiunta di un tag a una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, il tag viene aggiunto a un cluster. **Per aggiungere o aggiornare i tag in un cluster con 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 riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster a cui aggiungere i tag. 1. Scorri verso il basso fino alla sezione **Tags (Tag)** e scegli **Edit (Modifica)**. 1. Per ogni tag da aggiungere alla risorsa, procedi nel seguente modo: 1. Per aggiungere un nuovo tag, immetti il nome del tag nella casella **Key (Chiave)**. Per modificare il valore di un tag, individua il nome del tag nella colonna **Key (Chiave)**. 1. Per assegnare al tag un valore nuovo o aggiornato, inserisci un valore per il tag nella casella **Value (Valore)**. 1. Se desideri aggiungere altri tag, scegli **Add (Aggiungi)**. Altrimenti, al termine, scegli **Save (Salva)**. ------ #### [ Using the AWS CLI ] Il processo di aggiunta di un tag a una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, vengono aggiunti tre tag a un cluster. Il secondo tag `key2` non contiene valori. Usa l' AWS CLI operazione `add-tags-to-resource` con questi parametri. **Parametri** + **--resource-name**—L'ARN della risorsa Amazon DocumentDB a cui desideri aggiungere i tag. + **--tags**—Un elenco dei tag (coppia chiave-valore) che desideri aggiungere a questa risorsa nel formato. `Key=key-name,Value=tag-value` **Example** Per Linux, macOS o Unix: ``` aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` Per Windows: ``` aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` L'operazione `add-tags-to-resource` non produce alcun output. Per visualizzare i risultati, utilizza l'operazione `list-tags-for-resource`. ------ ## Elencare i tag su una risorsa Amazon DocumentDB Puoi usare Console di gestione AWS o the AWS CLI per ottenere un elenco dei tag per una risorsa Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] Il processo per elencare i tag in una risorsa è quasi identico, indipendentemente dal tipo di risorsa a cui si aggiunge il tag. In questo esempio, vengono elencati i tag per un cluster. **Per elencare i tag in un cluster con la console** 1. [Apri la console Amazon DocumentDB in https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster di cui desideri elencare i tag. 1. Per visualizzare un elenco dei tag in questa risorsa, scorri la sezione **Tags (Tag)**. ------ #### [ Using the AWS CLI ] Il processo per elencare i tag in una risorsa è quasi identico, indipendentemente dal tipo di risorsa di cui si elencano i tag. In questo esempio, vengono elencati i tag in un cluster. Usa l' AWS CLI operazione `list-tags-for-resource` con questi parametri. **Parametri** + **--resource-name**: obbligatorio. L'ARN della risorsa Amazon DocumentDB per cui desideri elencare i tag. **Example** Per Linux, macOS o Unix: ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Per Windows: ``` aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] } ``` ------ ## Rimozione di tag da una risorsa Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per rimuovere i tag dalle risorse di Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] Il processo di rimozione dei tag da una risorsa è quasi identico, indipendentemente dal tipo di risorsa. In questo esempio, vengono rimossi i tag da un cluster. **Per rimuovere tag da un cluster mediante la console** 1. [Apri la console Amazon DocumentDB in https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione scegli **clusters (cluster)**. 1. Seleziona il nome del cluster da cui desideri rimuovere i tag. 1. Scorri verso il basso fino alla sezione **Tags (Tag)** e scegli **Edit (Modifica)**. 1. Se desideri rimuovere tutti i tag da questa risorsa, scegli **Remove all (Rimuovi tutti)**. Altrimenti, per ogni tag da rimuovere dalla risorsa, procedi nel seguente modo: 1. Individua il nome del tag nella colonna **Key (Chiave)**. 1. Scegli **Remove (Rimuovi)** sulla stessa riga della chiave del tag. 1. Al termine, scegli **Save** (Salva). ------ #### [ Using the AWS CLI ] Il processo di rimozione di un tag da una risorsa è quasi identico, indipendentemente dal tipo di risorsa da cui viene rimosso il tag. In questo esempio, viene rimosso un tag da un cluster. Usa l' AWS CLI operazione `remove-tags-from-resource` con questi parametri. + **--resource-name**: obbligatorio. L'ARN della risorsa Amazon DocumentDB da cui desideri rimuovere i tag. + **--tag-keys**: obbligatorio. Un elenco di chiavi dei tag che desideri rimuovere da questa risorsa. **Example** Per Linux, macOS o Unix: ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Per Windows: ``` aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` L'operazione `removed-tags-from-resource` non produce alcun output. Per visualizzare i risultati, utilizza l'operazione `list-tags-for-resource`. ------ # Manutenzione di Amazon DocumentDB Periodicamente, Amazon DocumentDB esegue la manutenzione sulle risorse Amazon DocumentDB. La manutenzione spesso richiede aggiornamenti del motore di database (manutenzione del cluster) o del sistema operativo sottostante dell'istanza (manutenzione dell'istanza). Gli aggiornamenti del motore di database sono patch necessarie e includono correzioni di sicurezza, correzioni di bug e miglioramenti al motore di database. Sebbene la maggior parte delle patch del sistema operativo siano opzionali, se non le applichi per un certo periodo, la patch potrebbe essere richiesta e applicata automaticamente per mantenere il tuo livello di sicurezza. Pertanto, ti consigliamo di applicare gli aggiornamenti del sistema operativo alle istanze di Amazon DocumentDB non appena sono disponibili. Le patch del motore di database richiedono che i cluster Amazon DocumentDB vengano messi offline per un breve periodo. Una volta disponibili, queste patch vengono automaticamente programmate per essere applicate durante una prossima finestra di manutenzione programmata del cluster Amazon DocumentDB. Le operazioni di manutenzione su cluster e istanze hanno le loro rispettive finestre di manutenzione. Le modifiche a cluster e istanze che hai scelto di non applicare immediatamente vengono applicate anche durante la finestra di manutenzione. Per impostazione predefinita, quando crei un cluster, Amazon DocumentDB assegna una finestra di manutenzione sia per un cluster che per ogni singola istanza. Durante la creazione di un cluster o di un'istanza è possibile scegliere la finestra di manutenzione, che può anche essere modificata in qualsiasi momento per adeguarsi alla pianificazione o alle prassi del business. In genere è consigliabile scegliere finestre di manutenzione con impatto minimo sull'applicazione (per esempio, in serata o nel week end). **Topics** + [Notifiche per le patch del motore Amazon DocumentDB](#patch-notifications) + [Visualizzazione delle azioni di manutenzione in sospeso di Amazon DocumentDB](#view-pending-maintenance) + [Aggiornamenti del motore Amazon DocumentDB](#db-instance-updates-apply) + [Aggiornamenti avviati dall'utente](#user-initiated-updates) + [Gestione delle finestre di manutenzione di Amazon DocumentDB](#maintenance-window) + [Aggiornamenti del sistema operativo Amazon DocumentDB](#os-system-updates) ## Notifiche per le patch del motore Amazon DocumentDB Riceverai notifiche di manutenzione per le patch richieste al motore di database tramite eventi di salute in Health Dashboard (AHD) nella AWS console e tramite e-mail. Quando una patch di manutenzione del motore Amazon DocumentDB diventa disponibile in una particolare AWS regione, tutti gli account utente di Amazon DocumentDB interessati nella regione riceveranno una notifica AHD e via e-mail per ogni versione di Amazon DocumentDB interessata dalla patch. Puoi visualizzare queste notifiche nella sezione **Modifiche pianificate** dell'AHD nella console. AWS La notifica conterrà dettagli sulla tempistica della disponibilità delle patch, sulla pianificazione dell'applicazione automatica, sull'elenco dei cluster interessati e sulle note di rilascio. Questa notifica verrà inviata anche via e-mail all'indirizzo e-mail dell'utente root dell' AWS account. ![\[Console Amazon DocumentDB che mostra la scheda Modifiche pianificate per gli aggiornamenti delle patch del motore.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/scheduled-changes.png) Una volta ricevuta questa notifica, puoi scegliere di applicare automaticamente queste patch del motore ai tuoi cluster Amazon DocumentDB prima della data di applicazione automatica pianificata. Oppure puoi attendere che le patch del motore vengano applicate automaticamente durante una finestra di manutenzione imminente (opzione predefinita). **Nota** Lo **stato** della notifica nell'AHD sarà impostato su «In corso» fino al rilascio di una nuova patch del motore Amazon DocumentDB con una nuova versione della patch del motore. Una volta applicata la patch del motore al cluster Amazon DocumentDB, la versione della patch del motore del cluster verrà aggiornata in modo da riflettere la versione nella notifica. Puoi eseguire il `db.runCommand({getEngineVersion: 1})` comando per verificare questo aggiornamento. AWS Health si integra anche con Amazon EventBridge , che utilizza gli eventi per creare applicazioni scalabili basate sugli eventi e si integra con oltre 20 destinazioni AWS Lambda, tra cui Amazon Simple Queue Service (SQS) e altre. Puoi utilizzare il codice `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` evento per configurare Amazon EventBridge prima che le patch del motore diventino disponibili. Puoi configurare la risposta EventBridge all'evento ed eseguire automaticamente azioni come l'acquisizione di informazioni sull'evento, l'avvio di eventi aggiuntivi, l'invio di notifiche tramite canali aggiuntivi come notifiche push e l'adozione di azioni correttive o di altro tipo AWS Console Mobile Application, quando una patch del motore Amazon DocumentDB diventa disponibile nella tua regione. Nel raro scenario in cui Amazon DocumentDB annulli una patch del motore, riceverai una notifica AHD e un'e-mail che ti informa dell'annullamento. Di conseguenza, puoi utilizzare il codice `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` evento per configurare Amazon in modo EventBridge che risponda a questo evento. Consulta la *Amazon EventBridge User Guide* per ulteriori informazioni sull'uso [ EventBridge delle regole di Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). ## Visualizzazione delle azioni di manutenzione in sospeso di Amazon DocumentDB È possibile verificare se è disponibile un aggiornamento di manutenzione per il cluster utilizzando Console di gestione AWS o il AWS CLI. Se è disponibile un aggiornamento, puoi scegliere una di queste operazioni: + Rimanda un'azione di manutenzione attualmente pianificata per la prossima finestra di manutenzione (solo per le patch del sistema operativo). + Applica immediatamente le operazioni di manutenzione. + Pianificare le operazioni di manutenzione perché vengano avviate durante la successiva finestra di manutenzione. **Nota** Se non intraprendi alcuna azione, le azioni di manutenzione richieste, come le patch del motore, verranno applicate automaticamente in una finestra di manutenzione programmata imminente. La finestra di manutenzione determina l'avvio delle operazioni in sospeso, ma non limita il tempo di esecuzione totale di tali operazioni. ------ #### [ Using the 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. Se è disponibile un aggiornamento, è indicato dalla parola Available, ****Required**** o **Next Window** nella colonna **Maintenance** per il cluster sulla console Amazon DocumentDB, come illustrato di seguito: ![\[Console Amazon DocumentDB che mostra la colonna Maintenance per i cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png) 1. Per intraprendere un'azione, scegli il cluster per visualizzarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**. ![\[Console Amazon DocumentDB che mostra la finestra di manutenzione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-maint-3.png) ------ #### [ Using the AWS CLI ] Utilizza la seguente AWS CLI operazione per determinare quali azioni di manutenzione sono in sospeso. L'output di seguito mostra che non ci sono operazioni di manutenzione in attesa. ``` aws docdb describe-pending-maintenance-actions ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "PendingMaintenanceActions": [] } ``` ------ ## Aggiornamenti del motore Amazon DocumentDB Con Amazon DocumentDB, puoi scegliere quando applicare le operazioni di manutenzione. Puoi decidere quando Amazon DocumentDB applicare gli aggiornamenti utilizzando o. Console di gestione AWS AWS CLI Utilizza le procedure descritte in questo argomento per aggiornare immediatamente o pianificare un aggiornamento per il tuo cluster. ------ #### [ Using the Console di gestione AWS ] Puoi utilizzare la console per gestire gli aggiornamenti per i tuoi cluster Amazon DocumentDB. **Per gestire un aggiornamento per un 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**. 1. Nell'elenco dei cluster, scegliere il pulsante accanto al nome del cluster a cui applicare l'operazione di manutenzione. 1. Nel menu **Actions (Operazioni)** scegliere una di queste opzioni: + **Upgrade Now (Esegui l'aggiornamento ora)** per eseguire subito le attività di manutenzione in sospeso. + **Upgrade at next window (Aggiorna alla prossima finestra)** per eseguire le attività di manutenzione in sospeso durante la finestra di manutenzione successiva del cluster. In alternativa, puoi fare clic su **Applica ora** o **Applica alla prossima finestra di manutenzione** nella sezione Manutenzione in sospeso della scheda **Manutenzione e backup** del cluster (vedi **Utilizzo del** file Console di gestione AWS nella sezione precedente). **Nota** Se non ci sono attività di manutenzione in sospeso, tutte le opzioni precedenti sono inattive. ------ #### [ Using the AWS CLI ] Per applicare un aggiornamento in sospeso a un cluster, utilizzare l'operazione. `apply-pending-maintenance-action` AWS CLI **Parameters** + **--resource-identifier**—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso. + **--apply-action**—L'azione di manutenzione in sospeso da applicare a questa risorsa. Valori validi: `system-update` e `db-upgrade`. + **--opt-in-type**—Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo `immediate` non può essere annullata. Valori validi: + `immediate`—Applica immediatamente l'azione di manutenzione. + `next-maintenance`—Applica l'azione di manutenzione durante la finestra di manutenzione successiva per la risorsa. + `undo-opt-in`—Annulla tutte le richieste di `next-maintenance` opt-in esistenti. **Example** Per Linux, macOS o Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate ``` Per Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate ``` Per restituire un elenco di risorse con almeno un aggiornamento in sospeso, usa il comando. `describe-pending-maintenance-actions` AWS CLI **Example** Per Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` Per Windows: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] } ``` È inoltre possibile restituire un elenco di risorse per un cluster specificando il `--filters` parametro dell'`describe-pending-maintenance-actions` AWS CLI operazione. Il formato dell'operazione `--filters` è `Name=filter-name,Values=resource-id,...`. `db-cluster-id`è il valore accettabile per il `Name` parametro del filtro. Questo valore accetta un elenco di identificatori di cluster o ARNs. L'elenco restituito include solo le azioni di manutenzione in sospeso per i cluster identificati da questi identificatori o. ARNs L'esempio seguente restituisce le operazioni di manutenzione in sospeso per i cluster `sample-cluster1` e `sample-cluster2`. **Example** Per Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` Per Windows: ``` aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` ------ ### Applica le date Ogni operazione di manutenzione ha una rispettiva data di applicazione che è possibile trovare nella descrizione delle operazioni di manutenzione in attesa. Quando leggi l'output delle azioni di manutenzione in sospeso di AWS CLI, vengono elencate tre date. Questi valori di data `null` si riferiscono a quando la manutenzione è facoltativa. I valori vengono inseriti una volta pianificata o applicata l'azione di manutenzione corrispondente. + **CurrentApplyDate**—La data in cui l'azione di manutenzione verrà applicata immediatamente o durante la finestra di manutenzione successiva. + **ForcedApplyDate**—La data in cui la manutenzione verrà applicata automaticamente, indipendentemente dalla finestra di manutenzione. + **AutoAppliedAfterDate**—La data dopo la quale la manutenzione verrà applicata durante la finestra di manutenzione del cluster. ## Aggiornamenti avviati dall'utente In qualità di utente di Amazon DocumentDB, puoi avviare aggiornamenti ai tuoi cluster o istanze. Ad esempio, puoi modificare la classe di un'istanza con una con più o meno memoria oppure puoi modificare il gruppo di parametri di un cluster. Amazon DocumentDB visualizza queste modifiche in modo diverso dagli aggiornamenti avviati da Amazon DocumentDB. Per ulteriori informazioni sulla modifica di un cluster o di un'istanza, consulta: + [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md) + [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md) Per vedere un elenco delle modifiche in attesa avviate manualmente dall'utente, esegui il comando seguente. **Example** **Per visualizzare le modifiche in attesa avviate dall'utente per le tue istanze** Per Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` Per Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). In questo caso, per `sample-cluster-instance` è in attesa il passaggio a una classe di istanza `db.r5.xlarge`, mentre per `sample-cluster-instance-2` non ci sono modifiche in attesa. ``` [ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ] ``` ## Gestione delle finestre di manutenzione di Amazon DocumentDB Ogni istanza e ogni cluster hanno una finestra di manutenzione settimanale durante la quale vengono applicate le eventuali modifiche in attesa. La finestra di manutenzione è un'opportunità per controllare quando vengono applicate le modifiche e le patch software, nel caso in cui siano richieste o obbligatorie. Se un evento di manutenzione è pianificato per una settimana specifica, viene avviato durante la finestra di manutenzione di 30 minuti specificata dall'utente. La maggior parte degli eventi di manutenzione viene completata durante la finestra di manutenzione di 30 minuti, tuttavia l'esecuzione degli eventi di manutenzione di dimensioni maggiori può richiedere più di 30 minuti per il completamento. La finestra di manutenzione di 30 minuti viene selezionata casualmente da un blocco di tempo di 8 ore per ogni regione. Se non specifichi una finestra di manutenzione preferita quando crei l'istanza o il cluster, Amazon DocumentDB assegna una finestra di manutenzione di 30 minuti in un giorno della settimana selezionato casualmente. La seguente tabella elenca i blocchi temporali per ciascuna regione da cui sono assegnate le finestre di manutenzione predefinite. | Nome della regione | Regione | Blocco di tempo UTC | | --- | --- | --- | | Stati Uniti orientali (Ohio) | us-east-2 | 03:00-11:00 | | Stati Uniti orientali (Virginia settentrionale) | us-east-1 | 03:00-11:00 | | Stati Uniti occidentali (Oregon) | us-west-2 | 06:00-14:00 | | Africa (Città del Capo) | af-south-1 | 03:00 — 11:00 | | Asia Pacific (Hong Kong) | ap-east-1 | 06:00-14:00 | | Asia Pacifico (Hyderabad) | ap-south-2 | 06:30 — 14:30 | | Asia Pacifico (Malesia) | ap-southeast-5 | 13:00-21:00 | | Asia Pacifico (Mumbai) | ap-south-1 | 06:00-14:00 | | Asia Pacifico (Osaka-Locale) | ap-northeast-3 | 12:00-20:00 | | Asia Pacific (Seoul) | ap-northeast-2 | 13:00-21:00 | | Asia Pacifico (Singapore) | ap-southeast-1 | 14:00-22:00 | | Asia Pacifico (Sydney) | ap-southeast-2 | 12:00-20:00 | | Asia Pacifico (Giacarta) | ap-southeast-3 | 08:00-16:00 | | Asia Pacifico (Melbourne) | ap-southeast-4 | 11:00-19:00 | | Asia Pacifico (Thailandia) | ap-southeast-7 | 15:00-23:00 | | Asia Pacifico (Tokyo) | ap-northeast-1 | 13:00-21:00 | | Canada (Centrale) | ca-central-1 | 03:00-11:00 | | Cina (Pechino) | cn-north-1 | 06:00-14:00 | | China (Ningxia) | cn-northwest-1 | 06:00-14:00 | | Europa (Francoforte) | eu-central-1 | 21:00-05:00 | | Europa (Zurigo) | eu-central-2 | 02:00-10:00 | | Europa (Irlanda) | eu-west-1 | 22:00-06:00 | | Europe (London) | eu-west-2 | 22:00-06:00 | | Europe (Milan) | eu-south-1 | 02:00-10:00 | | Europa (Parigi) | eu-west-3 | 23:59-07:29 | | Europa (Spagna) | eu-south-2 | 02:00 — 10:00 | | Europa (Stoccolma) | eu-north-1 | 04:00 — 12:00 | | Messico (Centrale) | mx-central-1 | 03:00-11:00 | | Medio Oriente (Emirati Arabi Uniti) | me-central-1 | 05:00 — 13:00 | | Sud America (San Paolo) | sa-east-1 | 00:00-08:00 | | Israele (Tel Aviv) | il-central-1 | 04:00-12:00 | | AWS GovCloud (Stati Uniti orientali) | us-gov-east-1 | 17:00-01:00 | | AWS GovCloud (Stati Uniti occidentali) | us-gov-west-1 | 06:00-14:00 | ### Modifica delle finestre di manutenzione di Amazon DocumentDB La finestra di manutenzione deve essere eseguita nel momento di utilizzo più basso e quindi potrebbe essere necessario cambiarla di tanto in tanto. In questo lasso di tempo, il cluster o l'istanza non è disponibile solo in caso vengano applicate modifiche al sistema (ad esempio per un'operazione di storage su larga scala o la modifica della classe di un'istanza) che richiedono un'interruzione. L'inattività dura solo per il tempo strettamente necessario all'esecuzione delle modifiche richieste. Per gli aggiornamenti al motore di database, Amazon DocumentDB utilizza la finestra di manutenzione preferita del cluster e non la finestra di manutenzione per le singole istanze. **Per modificare la finestra di manutenzione** + Per un cluster: consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md) + Per un'istanza: consulta [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md). ## Aggiornamenti del sistema operativo Amazon DocumentDB Le istanze nei cluster Amazon DocumentDB richiedono occasionalmente aggiornamenti del sistema operativo. Amazon DocumentDB aggiorna il sistema operativo a una versione più recente per migliorare le prestazioni del database e il livello di sicurezza generale dei clienti. Gli aggiornamenti del sistema operativo non modificano la versione del motore del cluster o la classe di istanza di un'istanza Amazon DocumentDB. Ti consigliamo di aggiornare prima le istanze reader in un cluster, poi l'istanza writer per massimizzare la disponibilità del cluster. Non è consigliabile aggiornare contemporaneamente le istanze Reader e Writer, poiché in caso di failover potrebbero verificarsi tempi di inattività più lunghi. La maggior parte degli aggiornamenti del sistema operativo per Amazon DocumentDB sono facoltativi e non hanno una data prestabilita per applicarli. Tuttavia, se non applichi questi aggiornamenti per un certo periodo, alla fine potrebbero diventare necessari e applicati automaticamente durante la finestra di manutenzione dell'istanza. Questo serve a mantenere il livello di sicurezza del database. Per evitare interruzioni impreviste, ti consigliamo di applicare gli aggiornamenti del sistema operativo alle istanze di Amazon DocumentDB non appena sono disponibili e di impostare la finestra di manutenzione dell'istanza nel momento che preferisci, in base alle tue esigenze aziendali. Per ricevere una notifica quando diventa disponibile un nuovo aggiornamento facoltativo, è possibile iscriversi a RDS-EVENT-0230 nella categoria degli eventi di patch di sicurezza. Per informazioni sulla sottoscrizione agli eventi di Amazon DocumentDB, [consulta Abbonamento agli abbonamenti agli eventi di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html). È possibile che si verifichi un failover durante la manutenzione del cluster o dell'istanza, se l'istanza è un'istanza primaria. Per migliorare la tua disponibilità, ti consigliamo di utilizzare più di un'istanza per i cluster Amazon DocumentDB. Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md). **Nota** Per alcune funzionalità di gestione, Amazon DocumentDB utilizza la tecnologia operativa condivisa con Amazon Relational Database Service (Amazon RDS). **Importante** L'istanza Amazon DocumentDB verrà messa offline durante l'aggiornamento del sistema operativo. Puoi ridurre al minimo i tempi di inattività del cluster disponendo di un cluster multiistanza. Se non disponi di un cluster a più istanze, puoi scegliere di crearne temporaneamente uno aggiungendo istanze secondarie per eseguire questa manutenzione, quindi eliminando le istanze Reader aggiuntive una volta completata la manutenzione (verranno applicate le normali tariffe per l'istanza secondaria). **Nota** Potrebbe essere necessario rimanere aggiornati su tutti gli aggiornamenti facoltativi e obbligatori per soddisfare vari obblighi di conformità. Ti consigliamo di applicare regolarmente tutti gli aggiornamenti resi disponibili da Amazon DocumentDB durante le finestre di manutenzione. Puoi usare Console di gestione AWS o the AWS CLI per determinare se è disponibile un aggiornamento. ------ #### [ Using the Console di gestione AWS ] Per determinare se un aggiornamento è disponibile, utilizzare 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, scegli **Clusters**, quindi seleziona l'istanza. 1. Scegli **Manutenzione**. 1. Nella sezione **Manutenzione in sospeso**, trova l'aggiornamento del sistema operativo. ![\[Console Amazon DocumentDB che mostra la colonna Maintenance per i cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/maintenance-available-1.png) Puoi selezionare l'aggiornamento del sistema operativo e fare clic su **Applica ora o Applica** **alla finestra di manutenzione successiva** nella sezione Manutenzione in **sospeso**. **Se il valore di manutenzione è **nella finestra successiva**, rimanda gli elementi di manutenzione scegliendo Rinvia aggiornamento.** Non puoi rinviare un’azione di manutenzione se è già stata avviata. ****In alternativa, puoi scegliere l'istanza da un elenco di cluster facendo clic su Cluster nel riquadro di navigazione e selezionando **Applica ora o Applica** **alla finestra di manutenzione successiva** dal menu Azioni.**** ------ #### [ Using the AWS CLI ] Per determinare se è disponibile un aggiornamento utilizzando il AWS CLI, chiamate il `describe-pending-maintenance-actions` comando: ``` aws docdb describe-pending-maintenance-actions ``` ``` { "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] } ``` ------ Gli aggiornamenti del sistema operativo sono specifici per le versioni del motore e le classi di istanze di Amazon DocumentDB. Pertanto, le istanze di Amazon DocumentDB ricevono o richiedono aggiornamenti in momenti diversi. Quando è disponibile un aggiornamento del sistema operativo per l'istanza in base alla versione del motore e alla classe di istanza, l'aggiornamento viene visualizzato nella console. Può essere visualizzato anche eseguendo il AWS CLI `describe-pending-maintenance-actions` comando o chiamando l'operazione `DescribePendingMaintenanceActions` API. Se non stai eseguendo l'ultima versione di patch del cluster del tuo motore Amazon DocumentDB, potresti non vedere l'aggiornamento del sistema operativo elencato come manutenzione disponibile. Per visualizzare e gestire l'aggiornamento del sistema operativo, devi prima eseguire l'aggiornamento alla versione più recente della patch del motore. # Comprensione dei ruoli collegati ai servizi Amazon DocumentDB (con compatibilità con MongoDB) utilizza AWS Identity and Access Management ruoli collegati ai servizi (IAM). Un [ruolo collegato ai servizi](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) è un tipo unico di ruolo IAM collegato direttamente ad Amazon DocumentDB. I ruoli collegati ai servizi sono predefiniti da Amazon DocumentDB e includono tutte le autorizzazioni richieste dal servizio per chiamare altri servizi per tuo conto. AWS Un ruolo collegato ai servizi semplifica l'utilizzo di Amazon DocumentDB perché non è necessario aggiungere manualmente le autorizzazioni necessarie. Amazon DocumentDB definisce le autorizzazioni dei suoi ruoli collegati ai servizi e, se non diversamente definito, solo Amazon DocumentDB può assumerne i ruoli. Le autorizzazioni definite includono la policy di trust e la policy delle autorizzazioni. Una policy delle autorizzazioni specifica non può essere collegata a un’altra entità IAM. È possibile eliminare i ruoli solo dopo aver eliminato le risorse correlate. Questo protegge le tue risorse Amazon DocumentDB perché non puoi rimuovere inavvertitamente l'autorizzazione ad accedere alle risorse. Per informazioni sugli altri servizi che supportano i ruoli collegati ai servizi, consulta la sezione [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e cerca i servizi che riportano **Sì** nella colonna **Ruolo associato ai servizi**. Scegli **Sì** in corrispondenza di un link per visualizzare la documentazione relativa al ruolo collegato ai servizi per tale servizio. ## Autorizzazioni di ruolo collegate al servizio Amazon DocumentDB Amazon DocumentDB (compatibile con MongoDB) utilizza il ruolo collegato ai servizi denominato RDS per **AWSServiceRoleForconsentire** ad Amazon DocumentDB di chiamare i servizi per conto dei tuoi cluster. AWS Il ruolo collegato al servizio AWSService RoleFor RDS prevede che i seguenti servizi assumano il ruolo: + `docdb.amazonaws.com` La policy di autorizzazione dei ruoli consente ad Amazon DocumentDB di completare le seguenti azioni sulle risorse specificate: + Operazioni su `ec2`: + `AssignPrivateIpAddresses` + `AuthorizeSecurityGroupIngress` + `CreateNetworkInterface` + `CreateSecurityGroup` + `DeleteNetworkInterface` + `DeleteSecurityGroup` + `DescribeAvailabilityZones` + `DescribeInternetGateways` + `DescribeSecurityGroups` + `DescribeSubnets` + `DescribeVpcAttribute` + `DescribeVpcs` + `ModifyNetworkInterfaceAttribute` + `RevokeSecurityGroupIngress` + `UnassignPrivateIpAddresses` + Operazioni su `sns`: + `ListTopic` + `Publish` + Operazioni su `cloudwatch`: + `PutMetricData` + `GetMetricData` + `CreateLogStream` + `PullLogEvents` + `DescribeLogStreams` + `CreateLogGroup` **Nota** Per consentire a un’entità IAM (come un utente, un gruppo o un ruolo) di creare, modificare o eliminare un ruolo collegato al servizio è necessario configurare le relative autorizzazioni. Potrebbe essere visualizzato il messaggio di errore seguente: **Unable to create the resource. (Impossibile creare la risorsa. Verify that you have permission to create service linked role. (Verifica di possedere le autorizzazioni necessarie per creare un ruolo collegato ai servizi.) Otherwise wait and try again later. (In caso contrario, attendi e riprova più tardi.** Se viene visualizzato questo errore, verifica che le autorizzazioni seguenti siano abilitate: ``` { "Action": "iam:CreateServiceLinkedRole", "Effect": "Allow", "Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS", "Condition": { "StringLike": { "iam:AWSServiceName":"rds.amazonaws.com" } } } ``` Per ulteriori informazioni, consulta [Autorizzazioni del ruolo collegato ai servizi](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) nella *Guida per l'utente di IAM*. ## Creazione di un ruolo collegato al servizio Amazon DocumentDB Non hai bisogno di creare manualmente un ruolo collegato ai servizi. Quando crei un cluster, Amazon DocumentDB crea automaticamente il ruolo collegato al servizio. Se devi ricreare un ruolo collegato ai servizi che hai precedentemente eliminato, puoi utilizzare lo stesso processo per ricreare il ruolo nel tuo account. Quando crei un cluster, Amazon DocumentDB crea nuovamente il ruolo collegato al servizio per te. ## Modifica di un ruolo collegato al servizio Amazon DocumentDB Amazon DocumentDB non consente di modificare il ruolo collegato al servizio AWSService RoleFor RDS. Dopo avere creato un ruolo collegato al servizio, non sarà possibile modificarne il nome perché varie entità potrebbero farvi riferimento. Tuttavia, puoi modificare la descrizione del ruolo utilizzando IAM. Per ulteriori informazioni, consulta [Modifica di un ruolo collegato ai servizi](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) nella *Guida per l'utente di IAM*. ## Eliminazione di un ruolo collegato al servizio Amazon DocumentDB Se non è più necessario utilizzare una funzionalità o un servizio che richiede un ruolo collegato al servizio, ti consigliamo di eliminare il ruolo. In questo modo non sarà più presente un’entità non utilizzata che non viene monitorata e gestita attivamente. Tuttavia, prima di poter eliminare il ruolo collegato ai servizi, dovrai eliminare tutti i cluster . ### Pulizia di un ruolo collegato al servizio Amazon DocumentDB Prima di utilizzare IAM per eliminare un ruolo collegato ai servizi, devi innanzitutto verificare che il ruolo non abbia sessioni attive ed eliminare tutte le risorse utilizzate dal ruolo. **Per verificare la presenza di una sessione attiva del ruolo collegato ai servizi utilizzando la console** 1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. Nel pannello di navigazione della console IAM, scegli **Ruoli**, quindi scegli il nome (non la casella di controllo) del ruolo **AWSServiceRoleForRDS**. 1. Nella pagina **Summary** (Riepilogo) per il ruolo selezionato, scegliere la scheda **Access Advisor (Consulente accessi)**. 1. Nella scheda **Access Advisor (Consulente accessi)** esaminare l'attività recente per il ruolo collegato ai servizi. **Nota** Se non sei sicuro che Amazon DocumentDB stia utilizzando AWSService RoleFor il ruolo RDS, puoi provare a eliminare il ruolo. Se il servizio sta utilizzando il ruolo, l’eliminazione non andrà a buon fine e potrai visualizzare le regioni in cui il ruolo viene utilizzato. Se il ruolo è in uso, prima di poterlo eliminare dovrai attendere il termine della sessione. Non puoi revocare la sessione per un ruolo collegato al servizio. Se desideri rimuovere il ruolo AWSService RoleFor RDS, devi prima eliminare *tutte le* istanze e i cluster. Per informazioni sull'eliminazione delle istanze e dei cluster, consulta i seguenti argomenti: + [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md) + [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md) ## Regioni supportate per i ruoli collegati ai servizi Amazon DocumentDB Amazon DocumentDB supporta l'utilizzo di ruoli collegati ai servizi in tutte le regioni in cui il servizio è disponibile. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability](https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability).   # Utilizzo dei flussi di modifica con Amazon DocumentDB La funzionalità Change Streams di Amazon DocumentDB (con compatibilità con MongoDB) fornisce una sequenza temporale di eventi di modifica che si verificano all'interno delle raccolte del cluster. Puoi leggere gli eventi da un flusso di modifica per implementare molti casi d'uso diversi, inclusi i seguenti: + Notifica di modifica + Ricerca di testo completo con Amazon OpenSearch Service (OpenSearch Service) + Analisi con Amazon Redshift Le applicazioni possono utilizzare i flussi di modifica per sottoscrivere tutte le modifiche ai dati su singole raccolte. Gli eventi di flussi di modifica vengono ordinati man mano che si verificano nel cluster e vengono archiviati per 3 ore (valore predefinito) dopo la registrazione dell'evento. Il periodo di conservazione può essere esteso fino a 7 giorni utilizzando il `change_stream_log_retention_duration` parametro. Per modificare il periodo di conservazione del flusso di modifica, consulta [Modifica della durata di conservazione del registro del flusso di modifica](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-modifying_log_retention). **Topics** + [Operazioni supportate](#change_streams-supported_ops) + [Fatturazione](#change_streams-billing) + [Limitazioni](#change_streams-limitations) + [Abilitare i flussi di modifica](#change_streams-enabling) + [Esempio: utilizzo dei flussi di modifica con Python](#change_streams-using_example) + [Ricerca completa del documento](#change_streams-lookup) + [Ripresa di un flusso di modifiche](#change_streams-resuming) + [Ripresa di un flusso di modifiche con `startAtOperationTime`](#change_streams-startAtOperation) + [Ripresa di un flusso di modifiche con `postBatchResumeToken`](#change_streams-postBatchResumeToken) + [Transazioni nei flussi di modifica](#change_streams-transactions) + [Modifica della durata di conservazione del registro del flusso di modifiche](#change_streams-modifying_log_retention) + [Utilizzo dei flussi di modifica su istanze secondarie](#change-streams-secondary-instances) ## Operazioni supportate Amazon DocumentDB supporta le seguenti operazioni per i flussi di modifica: + Tutti gli eventi di modifica supportati in `db.collection.watch()` MongoDB `db.watch()` e nell'API. `client.watch()` + Ricerca completa dei documenti per gli aggiornamenti. + Fasi di aggregazione:`$match`, `$project``$redact`, e e. `$addFields` `$replaceRoot` + Ripresa di un flusso di modifiche da un token di curriculum + Ripresa di un flusso di modifiche da un timestamp utilizzando `startAtOperation` (applicabile a Amazon DocumentDB 4.0\$1) ## Fatturazione La funzionalità dei flussi di modifica di Amazon DocumentDB è disabilitata per impostazione predefinita e non comporta costi aggiuntivi finché non viene abilitata. L'utilizzo di flussi di modifiche in un cluster comporta costi di lettura e scrittura e di archiviazione aggiuntivi. IOs È possibile utilizzare l'operazione `modifyChangeStreams` API per abilitare questa funzionalità per il cluster. Per ulteriori informazioni sui prezzi, consulta i prezzi di [Amazon DocumentDB.](https://aws.amazon.com/documentdb/pricing/) ## Limitazioni I flussi di modifica presentano le seguenti limitazioni in Amazon DocumentDB: + Su Amazon DocumentDB 3.6. e Amazon DocumentDB 4.0, i flussi di modifica possono essere aperti solo da una connessione all'istanza principale di un cluster Amazon DocumentDB. La lettura dai flussi di modifica su un'istanza di replica non è supportata su Amazon DocumentDB 3.6. e Amazon DocumentDB 4.0. Quando si richiama l'operazione API `watch()`, è necessario specificare una preferenza di lettura `primary` per assicurare che tutte le letture siano indirizzate all'istanza primaria (consulta la sezione [Esempio](#change_streams-using_example)). + Su Amazon DocumentDB 5.0, i flussi di modifica possono essere aperti sia da istanze primarie che da istanze secondarie, inclusi i cluster globali. Puoi specificare una preferenza di lettura secondaria per reindirizzare i flussi di modifica verso istanze secondarie. [Utilizzo dei flussi di modifica su istanze secondarie](#change-streams-secondary-instances)Per ulteriori best practice e limitazioni, consulta la sezione. + Gli eventi scritti in un flusso di modifiche per una raccolta sono disponibili per un massimo di 7 giorni (l'impostazione predefinita è 3 ore). I dati dei flussi di modifiche vengono eliminati dopo la finestra della durata di conservazione del log, anche se non si sono verificate nuove modifiche. + Un'operazione di scrittura di lunga durata su una raccolta come `updateMany` o `deleteMany` può temporaneamente bloccare la scrittura degli eventi dei flussi di modifica fino al completamento della lunga operazione di scrittura. + Amazon DocumentDB non supporta il log delle operazioni MongoDB (). `oplog` + Con Amazon DocumentDB, devi abilitare esplicitamente i flussi di modifica su una determinata raccolta. + Se la dimensione totale di un evento di flussi di modifica (inclusi i dati di modifica e il documento completo, se richiesto) è maggiore di `16 MB`, il client incontrerà un errore di lettura nei flussi di modifiche. + Il driver Ruby non è attualmente supportato quando si utilizza `db.watch()` e `client.watch()` con Amazon DocumentDB 3.6. + L'output del `updateDescription` comando nei flussi di modifica è diverso in Amazon DocumentDB rispetto a MongoDB quando il valore aggiornato del campo è lo stesso di quello precedente: + Amazon DocumentDB non restituisce un campo nell'`updateDescription`output se il campo fornito è specificato nel `$set` comando e il suo valore di destinazione è già uguale al valore di origine. + MongoDB restituisce il campo nell'output, anche se il valore specificato è uguale al valore corrente. ## Abilitare i flussi di modifica Puoi abilitare i flussi di modifica di Amazon DocumentDB per tutte le raccolte all'interno di un determinato database o solo per raccolte selezionate. Di seguito sono riportati esempi di come abilitare i flussi di modifica per diversi casi d'uso utilizzando la shell mongo. Le stringhe vuote vengono trattate come caratteri jolly quando si specificano i nomi del database e della raccolta. ``` //Enable change streams for the collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: true}); ``` ``` //Disable change streams on collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: false}); ``` ``` //Enable change streams for all collections in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "", enable: true}); ``` ``` //Enable change streams for all collections in all databases in a cluster db.adminCommand({modifyChangeStreams: 1, database: "", collection: "", enable: true}); ``` I flussi di modifica saranno abilitati per una raccolta se una delle seguenti condizioni è vera: + Sia il database sia la raccolta sono abilitati in modo esplicito. + Il database contenente la raccolta è abilitato. + Tutti i database sono abilitati. L'eliminazione di una raccolta da un database non disabilita i flussi di modifica per tale raccolta se il database padre dispone anche di flussi di modifiche abilitati o se tutti i database nel cluster sono abilitati. Se viene creata una nuova raccolta con lo stesso nome della raccolta eliminata, i flussi di modifica verranno abilitati per tale raccolta. È possibile elencare tutti i flussi di modifiche abilitati del cluster utilizzando la fase della pipeline di aggregazione `$listChangeStreams`. Tutte le fasi di aggregazione supportate da Amazon DocumentDB possono essere utilizzate nella pipeline per ulteriori elaborazioni. Se una raccolta precedentemente abilitata è stata disabilitata, non verrà visualizzata nell'output `$listChangeStreams`. ``` //List all databases and collections with change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}], cursor:{}})); ``` ``` //List of all databases and collections with change streams enabled { "database" : "test", "collection" : "foo" } { "database" : "bar", "collection" : "" } { "database" : "", "collection" : "" } ``` ``` //Determine if the database “bar” or collection “bar.foo” have change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}, {$match: {$or: [{database: "bar", collection: "foo"}, {database: "bar", collection: ""}, {database: "", collection: ""}]}} ], cursor:{}})); ``` ## Esempio: utilizzo dei flussi di modifica con Python Di seguito è riportato un esempio di utilizzo di un flusso di modifiche di Amazon DocumentDB con Python a livello di raccolta. ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #While ‘Primary’ is the default read preference, here we give an example of #how to specify the required read preference when reading the change streams coll = db.get_collection('foo', read_preference=ReadPreference.PRIMARY) #Create a stream object stream = coll.watch() #Write a new document to the collection to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ #Generate a new change event by updating a document result = coll.update_one({'x': 1}, {'$set': {'x': 2}}) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf99d400000001010000000100009025'}, 'clusterTime': Timestamp(1571789268, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 2}}} """ ``` Di seguito è riportato un esempio di utilizzo di un flusso di modifiche di Amazon DocumentDB con Python a livello di database. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #Create a stream object stream = db.watch() coll = db.get_collection('foo') #Write a new document to the collection foo to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ coll = db.get_collection('foo1') #Write a new document to another collection to generate a change event coll.insert_one({'x': 1}) print(stream.try_next()) """ Expected Output: Since the change stream cursor was the database level you can see change events from different collections in the same database {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo1', 'db': 'bar'}, 'operationType': 'insert'} """ ``` ## Ricerca completa del documento L'evento di modifica dell'aggiornamento non include il documento completo, ma include solo la modifica apportata. Se il caso d'uso richiede il documento completo interessato da un aggiornamento, è possibile abilitare la ricerca completa del documento all'apertura del flusso. Il documento `fullDocument` per un evento di aggiornamento del flusso di modifiche rappresenta la versione più recente del documento aggiornato al momento della ricerca del documento. Se si sono verificate modifiche tra l'operazione di aggiornamento e la ricerca `fullDocument`, il documento `fullDocument` potrebbe non rappresentare lo stato del documento al momento dell'aggiornamento. Per creare un oggetto stream con la ricerca degli aggiornamenti abilitata, utilizzate questo esempio: ``` stream = coll.watch(full_document='updateLookup') #Generate a new change event by updating a document result = coll.update_one({'x': 2}, {'$set': {'x': 3}}) stream.try_next() ``` L'output dell'oggetto stream sarà simile al seguente: ``` {'_id': {'_data': '015daf9b7c00000001010000000100009025'}, 'clusterTime': Timestamp(1571789692, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'fullDocument': {'_id': ObjectId('5daf9502ea258751778163d7'), 'x': 3}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 3}}} ``` ## Ripresa di un flusso di modifiche È possibile riprendere un flusso di modifiche successivamente utilizzando un token di ripresa, che è uguale al campo `_id` dell'ultimo documento dell'evento di modifica recuperato. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem', retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() token = event['_id'] print(token) """ Output: This is the resume token that we will later us to resume the change stream {'_data': '015daf9c5b00000001010000000100009025'} """ #Python provides a nice shortcut for getting a stream’s resume token print(stream.resume_token) """ Output {'_data': '015daf9c5b00000001010000000100009025'} """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) #Generate another change event by inserting a document result = coll.insert_one({'y': 5}) #Open a stream starting after the selected resume token stream = db.watch(full_document='updateLookup', resume_after=token) #Our first change event is the update with the specified _id print(stream.try_next()) """ #Output: Since we are resuming the change stream from the resume token, we will see all events after the first update operation. In our case, the change stream will resume from the update operation {x:5} {'_id': {'_data': '015f7e8f0c000000060100000006000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602129676, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2')}, 'fullDocument': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2'), 'x': 5}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ #Followed by the insert print(stream.try_next()) """ #Output: {'_id': {'_data': '015f7e8f0c000000070100000007000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602129676, 7), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94')}, 'fullDocument': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94'), 'y': 5}} """ ``` ## Ripresa di un flusso di modifiche con `startAtOperationTime` È possibile riprendere un flusso di modifiche in un secondo momento da un determinato timestamp utilizzando. `startAtOperationTime` **Nota** La capacità di utilizzo `startAtOperationTime` è disponibile in Amazon DocumentDB 4.0\$1. Quando viene utilizzato`startAtOperationTime`, il cursore del flusso di modifica restituirà solo le modifiche avvenute in corrispondenza o dopo il timestamp specificato. I `resumeAfter` comandi `startAtOperationTime` and si escludono a vicenda e quindi non possono essere usati insieme. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='rds-root-ca-2020.pem',retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() timestamp = event['clusterTime'] print(timestamp) """ Output Timestamp(1602129114, 4) """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) result = coll.insert_one({'y': 5}) #Generate another change event by inserting a document #Open a stream starting after specified time stamp stream = db.watch(start_at_operation_time=timestamp) print(stream.try_next()) """ #Output: Since we are resuming the change stream at the time stamp of our first update operation (x:4), the change stream cursor will point to that event {'_id': {'_data': '015f7e941a000000030100000003000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602130970, 3), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e9417c423bafbfd9adbb1')}, 'updateDescription': {'updatedFields': {'x': 4}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: The second event will be the subsequent update operation (x:5) {'_id': {'_data': '015f7e9502000000050100000005000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602131202, 5), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e94ffc423bafbfd9adbb2')}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: And finally the last event will be the insert operation (y:5) {'_id': {'_data': '015f7e9502000000060100000006000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602131202, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e95025c4a569e0f6dde92')}, 'fullDocument': {'_id': ObjectId('5f7e95025c4a569e0f6dde92'), 'y': 5}} """ ``` ## Ripresa di un flusso di modifiche con `postBatchResumeToken` Il flusso di modifiche di Amazon DocumentDB ora restituisce un campo aggiuntivo chiamato. `postBatchResumeToken` Questo campo viene restituito dal `$changestream` comando e dal `getMore` comando. Esempio del `$changestream` comando in Python: ``` db.command({"aggregate": "sales", "pipeline": [{ "$changeStream": {}}], "cursor": {"batchSize": 1}}) ``` Output previsto: ``` cursor" : { "firstBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` Esempio del `getMore` comando in Python: ``` db.command({"getMore": NumberLong(), "collection": "sales", "batchSize": 1 }) ``` Output previsto ``` cursor" : { "nextBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` Il `postBatchResumeToken` campo può essere utilizzato per aprire nuovi cursori Change Stream nel `resumeAfter` campo, in modo simile a come viene utilizzato il token resume. Apri uno stream che inizia dopo quello selezionato: `postBatchResumeToken` ``` post_batch_resume_token = output['cursor']['postBatchResumeToken'] stream = db.watch(full_document='updateLookup', resume_after=post_batch_resume_token) ``` A differenza di un normale token di curriculum che corrisponde sempre a una voce del registro delle operazioni (oplog) che riflette un evento effettivo, `postBatchResumeToken` corrisponde a una voce oplog rilevata dal flusso di modifiche sul server, che non è necessariamente una modifica corrispondente. Il tentativo di riprendere con un vecchio token di riavvio normale forzerà il database a scansionare tutte le voci oplog comprese tra il timestamp specificato e l'ora corrente. Ciò può generare molte query internamente con ogni sottoquery che esegue la scansione per un breve periodo di tempo. Ciò causerà un picco nell'utilizzo della CPU e ridurrà le prestazioni del database. La ripresa con l'ultimo `postBatchResumeToken` salta la scansione delle voci di oplog non corrispondenti. ## Transazioni nei flussi di modifica Gli eventi Change Stream non conterranno eventi derivanti da transazioni interrotte senza impegno and/or . Ad esempio, se si avvia una transazione con una sola `INSERT` operazione e se `UPDATE` l'operazione ha esito positivo, ma l'`INSERT``UPDATE`operazione ha esito negativo, la transazione verrà annullata. Poiché questa transazione è stato ripristinato, il flusso di modifiche non conterrà alcun evento relativo a questa transazione. ## Modifica della durata di conservazione del registro del flusso di modifiche È possibile modificare la durata di conservazione del registro del flusso di modifiche in modo che sia compresa tra 1 ora e 7 giorni utilizzando il Console di gestione AWS AWS CLI. ------ #### [ Using the Console di gestione AWS ] **Per modificare la durata di conservazione del registro del flusso di modifica** 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 riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. **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 riquadro **Parameter groups (Gruppi di parametri)** scegliere il gruppo di parametri cluster associato al cluster. Per identificare il gruppo di parametri del cluster associato al cluster, consulta [Determinazione del gruppo di parametri di un cluster Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). 1. La pagina risultante mostra i parametri e i relativi dettagli corrispondenti per questo gruppo di parametri del cluster. Selezionare il parametro `change_stream_log_retention_duration`. 1. In alto a destra della pagina, scegliere **Edit (Modifica)** per modificare il valore del parametro. Il `change_stream_log_retention_duration` parametro può essere modificato per essere compreso tra 1 ora e 7 giorni. 1. Apportare la modifica, quindi scegliere **Modify cluster parameter (Modifica parametro cluster)** per salvare le modifiche. Per annullare le modifiche, selezionare **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] Per modificare il parametro `change_stream_log_retention_duration` di un gruppo di parametri del cluster, utilizzare l'operazione `modify-db-cluster-parameter-group` con i parametri seguenti. + **--db-cluster-parameter-group-name**: obbligatorio. Il nome del gruppo di parametri del cluster che stai modificando. Per identificare il gruppo di parametri del cluster associato al cluster, consulta [Determinazione del gruppo di parametri di un cluster Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). + **--parameters**: obbligatorio. Il parametro che stai modificando. Ogni voce del parametro deve includere: + **ParameterName**— Il nome del parametro che state modificando. In questo caso, è `change_stream_log_retention_duration` + **ParameterValue**— Il nuovo valore per questo parametro. + **ApplyMethod**— Come si desidera applicare le modifiche a questo parametro. I valori consentiti sono `immediate` e `pending-reboot`. **Nota** I parametri con `ApplyType` per `static` devono avere `ApplyMethod` per `pending-reboot`. 1. Per modificare i valori del parametro `change_stream_log_retention_duration`, eseguire il comando seguente e sostituire `parameter-value` con il valore a cui si desidera modificare il parametro. Per Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` Per Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Attendi almeno 5 minuti. 1. Elenca i valori dei parametri di `sample-parameter-group` per essere certo che le modifiche siano state apportate. Per Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Per Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "12345", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "immediate" } ] } ``` ------ **Nota** La conservazione dei log del flusso di modifiche non eliminerà i log più vecchi del `change_stream_log_retention_duration` valore configurato finché la dimensione del registro non sarà superiore a (>) 51.200 MB. ## Utilizzo dei flussi di modifica su istanze secondarie Per iniziare a utilizzare change stream su istanze secondarie, apri il cursore change stream con `readPreference` come secondario. Puoi aprire un cursore del flusso di modifica per controllare gli eventi di modifica su una raccolta specifica o su tutte le raccolte in un cluster o database. Puoi aprire un cursore Change Stream su qualsiasi istanza Amazon DocumentDB e recuperare documenti Change Stream da entrambe le istanze Writer e Reader. Puoi condividere i token change stream (come `resumeToken` or`startOperationTime`) tra diversi cursori di change stream aperti su un'istanza writer e reader. **Esempio** ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint" client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] # Make sure to use SECONDARY to redirect cursor reads from secondary instances coll = db.get_collection('foo', read_preference=ReadPreference.SECONDARY) # Create a stream object on RO. The token needs to generated from PRIMARY. stream = coll.watch(resumeAfter=token) for event in stream: print(event) ``` **Linee guida e limitazioni per i flussi di modifica sulle istanze secondarie** + Gli eventi del flusso di modifiche devono essere replicati dall'istanza principale alle istanze secondarie. Puoi monitorare il ritardo dalla `DBInstanceReplicaLag` metrica in Amazon. CloudWatch + I timestamp sulle istanze secondarie potrebbero non essere sempre sincronizzati con l'istanza principale. In questo caso, aspettatevi ritardi sul timestamp dell'istanza secondaria in modo che possa recuperare il ritardo. Come procedura ottimale, consigliamo di utilizzare `startAtOperationTime` o `resumeToken` avviare l'orologio sull'istanza secondaria. + Potresti riscontrare un throughput inferiore sulle istanze secondarie rispetto all'istanza principale se le dimensioni del documento sono grandi`fullDocumentLookup`, lo stai facendo e il carico di lavoro di scrittura simultanea sull'istanza principale è elevato. Come procedura ottimale, ti consigliamo di monitorare il rapporto di accessi della cache del buffer sulla cache secondaria e di assicurarti che il rapporto di accessi della cache del buffer sia elevato. # Utilizzo di Collation in Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 ora supporta la collazione. La collazione consente di configurare regole specifiche della lingua per il confronto di stringhe. Con le regole di confronto, è possibile specificare regole per i confronti con distinzione tra maiuscole e minuscole o specificare una lingua locale. Le regole di confronto possono essere configurate a livello di raccolta o di indice in DocumentDB 8.0. Quando si utilizza la collazione in DocumentDB, internamente viene creato un documento di confronto con i seguenti parametri. ``` { locale: string, caseLevel: boolean, caseFirst: string, strength: int, numericOrdering: boolean, alternate: string, maxVariable: string, backwards: boolean, normalization: boolean } ``` ## Limitazioni Collation presenta le seguenti limitazioni in Amazon DocumentDB: + Collation è compatibile con planner v3 disponibile in Amazon DocumentDB 8.0. Il passaggio a plannerv2 o plannerv1 può causare comportamenti incoerenti, inclusi gli errori «Index not found». + A causa delle differenze intrinseche tra le librerie, se viene esportata una raccolta mongodb con regole di confronto, sarà necessario aggiornare i file metadata.bson e modificarne la versione dalla 57.1 alla 60.2 prima della migrazione. + In rari casi, le impostazioni di confronto potrebbero violare il limite interno sul numero di caratteri, causando il seguente errore. «Errore: il documento di confronto ha più attributi non predefiniti di quelli supportati. Riduci il numero di opzioni.» In questo caso, prova a ridurre le opzioni fornite nel documento di confronto o, in alternativa, puoi provare a utilizzare i valori predefiniti laddove possibile. # Utilizzo delle viste in Amazon DocumentDB 8.0 + Amazon DocumentDB 8.0 ora supporta le visualizzazioni. Le viste funzionano come raccolte virtuali che presentano dati in base a operazioni di aggregazione specificate. Quando si crea una vista, si definisce una query che trasforma i dati da una o più raccolte di fonti. Amazon DocumentDB 8.0 esegue questa query ogni volta che si accede alla vista, senza consumare risorse di storage aggiuntive. A differenza delle raccolte standard, le viste in Amazon DocumentDB 8.0 non archiviano documenti su disco, il che le rende una soluzione efficiente per presentare dati trasformati o filtrati alle applicazioni. Per creare una vista in Amazon DocumentDB, puoi utilizzare il comando createView o il metodo helper db.createView (): ``` db.createView("viewName","sourceCollection", [ { $match: { status: "active" } }, { $project: { _id: 1, name: 1, email: 1 } } ] ) ``` Questo crea una vista denominata «viewName» basata su «SourceCollection» che include solo documenti e progetti attivi, solo i campi \$1id, name ed email. Le viste in Amazon DocumentDB sono di sola lettura. Le operazioni di scrittura sulle viste restituiranno un errore. Per prestazioni ottimali con set di dati di grandi dimensioni, puoi strutturare le tue pipeline di visualizzazione per massimizzare l'efficienza. Per pipeline di aggregazione complesse, si consiglia di utilizzare la fase \$1match come prima fase o all'inizio della pipeline per ridurre il numero di documenti che le fasi successive devono elaborare, migliorando così le prestazioni delle query. ## Best practice Di seguito sono elencate alcune best practice da seguire con Views. + Filtra in anticipo: utilizza \$1match Stages nelle prime fasi di visualizzazione delle pipeline per ridurre la quantità di dati elaborati. + Evita le aggregazioni complesse: per viste ad accesso frequente con aggregazioni complesse, prendi in considerazione la creazione di una raccolta separata con risultati precalcolati che vengono aggiornati periodicamente. + Pianificazione dell'indice: assicurati che i campi utilizzati nelle pipeline di visualizzazione, specialmente nelle operazioni \$1match e \$1sort, siano indicizzati correttamente nella raccolta di origine. + Ottimizzazione delle query: utilizza il comando explain per capire come vengono eseguite le query di visualizzazione e ottimizzarle di conseguenza. + Alternative per le visualizzazioni: date le differenze funzionali tra le viste di Amazon DocumentDB e MongoDB, prendi in considerazione l'utilizzo di raccolte regolari con aggiornamenti pianificati come alternativa alle viste in caso di limitazioni. ## Compatibilità con gli operatori di aggregazione Amazon DocumentDB supporta molti operatori di aggregazione nelle definizioni delle viste, pur continuando a espandere la compatibilità. Quando usi le viste, concentrati su questi operatori supportati: + \$1match per filtrare i documenti + \$1project per la selezione e la trasformazione dei campi + \$1addFields per aggiungere campi calcolati + \$1sort per ordinare i risultati + \$1limit e \$1skip per l'impaginazione Alcuni operatori specializzati come \$1currentOp, \$1replaceRoot e \$1geoEar attualmente lavorano su query di aggregazione diretta anziché visualizzare le definizioni. ## Sfruttamento di indici e visualizzazioni Le viste in Amazon DocumentDB 8.0 utilizzano gli indici della raccolta sottostante. Di conseguenza, non è possibile creare, eliminare o ricostruire gli indici direttamente su una vista. Tuttavia, indici ben progettati nella raccolta di sorgenti possono migliorare in modo significativo le prestazioni delle query di visualizzazione Di seguito sono riportati alcuni passaggi per ottimizzare le prestazioni delle query sulle viste: + Assicurati che esistano indici appropriati nei campi di raccolta dei sorgenti utilizzati nella pipeline della vista, specialmente nelle operazioni \$1match e \$1sort + Utilizzate il metodo explain () per analizzare i piani di esecuzione delle query e verificare l'utilizzo dell'indice. Ad esempio `db.viewName.find({...}).explain() ` # Utilizzo AWS Lambda con stream di modifica Amazon DocumentDB è integrato AWS Lambda in modo da poter utilizzare le funzioni Lambda per elaborare i record in un flusso di modifiche. La mappatura delle sorgenti degli eventi Lambda è una risorsa che può essere utilizzata per richiamare funzioni Lambda al fine di elaborare eventi Amazon DocumentDB che non richiamano direttamente Lambda. Con Amazon DocumentDB change stream come fonte di eventi, puoi creare applicazioni basate sugli eventi che rispondono ai cambiamenti nei tuoi dati. Ad esempio, puoi utilizzare le funzioni Lambda per elaborare nuovi documenti, tenere traccia degli aggiornamenti dei documenti esistenti o registrare i documenti eliminati. Puoi configurare una mappatura dell'origine degli eventi per inviare i record dal flusso di modifiche di Amazon DocumentDB a una funzione Lambda. Gli eventi possono essere inviati uno alla volta o raggruppati per una maggiore efficienza e verranno elaborati in ordine. È possibile configurare il comportamento in batch della mappatura delle sorgenti degli eventi in base alla durata di una finestra temporale specifica (da 0 a 300 secondi) o al numero di record in batch (limite massimo di 10.000 record). Puoi creare più mappature delle sorgenti degli eventi per elaborare gli stessi dati con più funzioni Lambda o per elaborare elementi distinti da più flussi con un'unica funzione. Se la funzione restituisce un errore, Lambda riprova il batch finché non viene elaborato correttamente. Nel caso in cui gli eventi nel flusso di modifiche siano scaduti, Lambda disabiliterà la mappatura dell'origine degli eventi. In questo caso, puoi creare una nuova mappatura delle sorgenti degli eventi e configurarla con una posizione iniziale a tua scelta. Le mappature delle origini eventi Lambda elaborano gli eventi almeno una volta a causa della natura distribuita dei relativi poller. Di conseguenza, in rari casi, la tua funzione Lambda potrebbe ricevere eventi duplicati. Segui le migliori pratiche per lavorare con AWS Lambda le funzioni e crea funzioni idempotenti per evitare problemi legati alla duplicazione degli eventi. Per ulteriori informazioni, consulta [Using AWS Lambda console with Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) nella *AWS Lambda Developer* Guide. Come best practice in materia di prestazioni, la funzione Lambda deve essere di breve durata. Per evitare di introdurre ritardi di elaborazione non necessari, inoltre, non dovrebbe eseguire una logica complessa. In particolare, per un flusso a velocità elevata, è meglio attivare flussi di lavoro Step Function di post-elaborazione asincrona rispetto a funzioni Lambda sincrone a lunga durata. Per ulteriori informazioni in merito AWS Lambda, consulta la [AWS Lambda Developer Guide](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html). ## Limitazioni Di seguito sono riportate le limitazioni da considerare quando si lavora con Amazon DocumentDB e: AWS Lambda + AWS Lambda è attualmente supportato solo su Amazon DocumentDB 4.0 e 5.0. + AWS Lambda attualmente non è supportato su cluster elastici o cluster globali. + AWS Lambda le dimensioni del payload non possono superare i 6 MB. *Per ulteriori informazioni sulle dimensioni dei batch Lambda, consulta «Comportamento in batch» nella sezione [Lambda Event Source Mappings](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-batching) della Developer Guide.AWS Lambda *