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à.
# 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 con provisioning. Quando si crea 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 della fonte.
Quando crei cloni dai tuoi cluster Amazon DocumentDB, i cloni vengono creati nel tuo AWS account, lo stesso account proprietario del cluster Amazon DocumentDB di origine.
**Topics**
+ [Panoramica sulla clonazione di Amazon DocumentDB](#db-cloning-overview)
+ [Note sull'utilizzo per la 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 sulla clonazione di Amazon DocumentDB
Amazon DocumentDB utilizza un protocollo * copy-on-write 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 spazio di archiviazione 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 copy-on-write, consulta [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 Amazon DocumentDB in modo diverso dal cluster Amazon DocumentDB di origine. Ad esempio, potresti non aver bisogno di 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 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.
## Note sull'utilizzo per la 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 agisce come un ripristino point-in-time.
+ Non puoi creare un clone in una AWS regione diversa dal cluster Amazon DocumentDB di origine.
+ Non puoi creare un clone da un cluster Amazon DocumentDB privo di istanze DB. Puoi clonare solo i 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. Tuttavia, le sottoreti in quei VPC devono essere associate alle stesse zone di disponibilità.
## Come funziona la clonazione di Amazon DocumentDB
La clonazione di Amazon DocumentDB funziona sul livello di storage di un cluster Amazon DocumentDB. Utilizza un * protocollo * copy-on-write veloce ed efficiente in termini di spazio 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**
+ [Informazioni sul protocollo copy-on-write](#db-copy-on-write-protocol)
+ [Eliminazione di un volume cluster di origine](#db-deleting-source-cluster-volume)
### Informazioni sul 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.
Quando viene creato il clone, in genere non è necessario alcuno spazio di archiviazione aggiuntivo. Il protocollo copy-on-write 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, puoi un esempio del protocollo copy-on-write in azione utilizzando lo stesso cluster A e il relativo clone, B, come illustrato 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 il cluster (A) ora punta alle pagine 1 [A], 2, 3 e 4, mentre il clone (B) fa ancora riferimento alle pagine originali.
Sul clone, viene apportata una modifica a pagina 4 sul volume di archiviazione. Invece di scrivere sulla pagina originale 4, 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.
Poiché nel tempo si verificano ulteriori modifiche sia nel volume del cluster Amazon DocumentDB di origine che nel clone, è necessario più spazio di archiviazione 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, puoi utilizzare le procedure Console di gestione AWS o the AWS CLI e le seguenti.
Utilizzando la clonazione di Amazon DocumentDB, puoi creare un clone del cluster Amazon DocumentDB con provisioning da un cluster Amazon DocumentDB con provisioning.
------
#### [ 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 crea il clone. Il cluster DB deve essere di proprietà dello 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 AWS account 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. Scegli il tuo cluster Amazon DocumentDB dall'elenco e, per ** Azioni**, scegli ** Crea clone. **
Viene visualizzata la pagina Crea clone, in cui è possibile configurare un identificatore del ** 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.
1. Per le impostazioni ** di rete**, scegli un gruppo di ** sottorete ** per il tuo caso d'uso e i gruppi di sicurezza VPC associati.
1. Perché ** Encryption-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 nel cluster di origine non è abilitata la crittografia, sono disponibili ** le opzioni ** Abilita crittografia ed è possibile scegliere di abilitare o disabilitare la crittografia.
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 abilitando la protezione dall'eliminazione accidentale del cluster (abilitata per impostazione predefinita).
1. Completa l'immissione di tutte le impostazioni per il clone del tuo cluster Amazon DocumentDB. Per ulteriori informazioni sulle impostazioni del cluster e delle istanze 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 viene creato, il clone viene elencato con gli altri cluster Amazon DocumentDB nella sezione ** Database ** della console e ne viene visualizzato lo stato corrente. Il clone è pronto per l'utilizzo quando lo stato diventa **Disponibile**.
------
#### [ Using the AWS CLI ]
L'utilizzo di AWS CLI per clonare il 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. In altre parole, 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. Creare 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) della CLI. I parametri utilizzati con questo comando controllano il tipo di capacità e altri dettagli del cluster Amazon DocumentDB vuoto (clone) in fase di creazione.
1. Crea l'istanza Amazon DocumentDB per il clone utilizzando il comando CLI [ create-db-instance per ricreare l'istanza Amazon DocumentDB nel ](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) cluster Amazon DocumentDB ripristinato.
I comandi seguenti presuppongono che sia impostato con la AWS CLI tua regione come 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**
**Creazione del 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 si passa dipende dal tipo di clone che si desidera creare.
Utilizza la seguente procedura per creare un clone Amazon DocumentDB con provisioning da un cluster Amazon DocumentDB con provisioning.
**Per creare un clone della stessa modalità di 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. Il nome del clone viene assegnato 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) della 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 **
Emettere il comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) della CLI per creare l'istanza database per il clone.
Il `--db-instance-class` parametro viene utilizzato solo per i cluster Amazon DocumentDB su cui è stato effettuato il provisioning.
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 | Descrizione |
| --- | --- |
| --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 | Specifica `copy-on-write` come `--restore-type` per 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. |
------