Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Klonen eines Volumes für einen Amazon DocumentDB-Cluster
Durch das Klonen von Amazon DocumentDB können Sie einen neuen Cluster erstellen, der dasselbe Amazon DocumentDB-Cluster-Volume verwendet und dieselben Daten wie das Original hat. Der Prozess ist so konzipiert, dass er schnell und kostengünstig ist. Der neue Cluster mit dem zugehörigen Datenvolume wird als *clone* (Klon) bezeichnet. Das Erstellen eines Klons ist schneller und platzsparender als das physische Kopieren der Daten mit anderen Techniken, wie z. B. das Wiederherstellen eines Snapshots.
Amazon DocumentDB unterstützt die Erstellung eines von Amazon DocumentDB bereitgestellten Klons aus einem bereitgestellten Amazon DocumentDB-Cluster. Wenn Sie einen Clone mit einer anderen Bereitstellungskonfiguration als der Quelle erstellen, wird der Clone mit der neuesten Version der Amazon DocumentDB DocumentDB-Engine der Quelle erstellt.
Wenn Sie Klone aus Ihren Amazon DocumentDB-Clustern erstellen, werden die Klone in Ihrem Konto erstellt AWS — demselben Konto, dem der Amazon DocumentDB DocumentDB-Quellcluster gehört.
**Topics**
+ [Überblick über das Klonen von Amazon DocumentDB](#db-cloning-overview)
+ [Einschränkungen beim Klonen von Amazon DocumentDB](#db-cloning-limitations)
+ [So funktioniert das Klonen von Amazon DocumentDB](#db-how-db-cloning-works)
+ [Einen Amazon DocumentDB-Klon erstellen](#db-creating-db-clone)
## Überblick über das Klonen von Amazon DocumentDB
Amazon DocumentDB verwendet ein *copy-on-write Protokoll*, um einen Klon zu erstellen. Dieser Mechanismus verwendet minimalen zusätzlichen Speicherplatz, um einen ersten Klon zu erstellen. Wenn der Klon zum ersten Mal erstellt wird, behält Amazon DocumentDB eine einzige Kopie der Daten, die vom Quell-DB-Cluster und dem neuen (geklonten) Amazon DocumentDB-Cluster verwendet werden. Zusätzlicher Speicherplatz wird nur zugewiesen, wenn Änderungen an Daten (auf dem Amazon DocumentDB-Speichervolume) durch den Amazon DocumentDB-Quellcluster oder den Amazon DocumentDB-Cluster-Klon vorgenommen werden. Weitere Informationen über das copy-on-write Protokoll finden Sie unter. [So funktioniert das Klonen von Amazon DocumentDB](#db-how-db-cloning-works)
Das Klonen von Amazon DocumentDB ist besonders nützlich, um schnell Testumgebungen mit Ihren Produktionsdaten einzurichten, ohne das Risiko einer Datenbeschädigung einzugehen. Sie können Klone für viele Arten von Anwendungen verwenden, z. B. für Folgende:
+ Experimentieren Sie mit möglichen Änderungen (z. B. Schemaänderungen und Parametergruppenänderungen), um alle Auswirkungen zu bewerten.
+ Führen Sie Workload-intensive Vorgänge aus, z. B. das Exportieren von Daten oder das Ausführen analytischer Abfragen auf dem Klon.
+ Erstellen Sie eine Kopie Ihres Produktions-DB-Clusters zu Entwicklungs-, Test- oder anderen Zwecken.
Sie können mehr als einen Klon aus demselben Amazon DocumentDB-Cluster erstellen. Sie können auch mehrere Klone aus einem anderen Klon erstellen.
Nachdem Sie einen Amazon DocumentDB-Klon erstellt haben, können Sie die Amazon DocumentDB DocumentDB-Instances anders konfigurieren als der Amazon DocumentDB DocumentDB-Quellcluster. Beispielsweise benötigen Sie möglicherweise keinen Klon für Entwicklungszwecke, um dieselben Hochverfügbarkeitsanforderungen wie der Amazon DocumentDB DocumentDB-Quellproduktionscluster zu erfüllen. In diesem Fall können Sie den Clone mit einer einzigen Amazon DocumentDB-Instance statt mit mehreren DB-Instances konfigurieren, die vom Amazon DocumentDB-Cluster verwendet werden.
Wenn Sie den Klon für Test-, Entwicklungs- oder andere Zwecke nicht mehr verwenden, können Sie ihn löschen.
## Einschränkungen beim Klonen von Amazon DocumentDB
Amazon DocumentDB; für das Klonen gelten derzeit die folgenden Einschränkungen:
+ Sie können so viele Klone erstellen, wie Sie möchten, bis zur maximalen Anzahl von DB-Clustern, die in der AWS-Region zulässig sind. Nachdem Sie jedoch 15 Klone erstellt haben, ist der nächste Klon eine vollständige Kopie. Der Klonvorgang funktioniert wie eine Wiederherstellung. point-in-time
+ Sie können keinen Clone in einer anderen AWS Region als dem Amazon DocumentDB DocumentDB-Quellcluster erstellen.
+ Sie können keinen Clone aus einem Amazon DocumentDB-Cluster erstellen, der keine DB-Instances hat. Sie können nur Amazon DocumentDB-Cluster klonen, die über mindestens eine DB-Instance verfügen.
+ Sie können einen Clone in einer anderen Virtual Private Cloud (VPC) als der des Amazon DocumentDB-Clusters erstellen. Wenn Sie dies tun, VPCs müssen die Subnetze von denselben Availability Zones zugeordnet werden.
## So funktioniert das Klonen von Amazon DocumentDB
Das Klonen von Amazon DocumentDB funktioniert auf der Speicherebene eines Amazon DocumentDB-Clusters. Es verwendet ein *copy-on-write*Protokoll, das sowohl schnell als auch platzsparend ist, was die zugrunde liegenden dauerhaften Medien angeht, die das Amazon DocumentDB DocumentDB-Speichervolumen unterstützen. Weitere Informationen zu Amazon DocumentDB-Cluster-Volumes finden Sie unter[Verwaltung von Amazon DocumentDB-Clustern](db-clusters.md).
**Topics**
+ [Das Protokoll verstehen copy-on-write](#db-copy-on-write-protocol)
+ [Löschen eines Quell-Cluster-Volumes](#db-deleting-source-cluster-volume)
### Das Protokoll verstehen copy-on-write
Ein Amazon DocumentDB-Cluster speichert Daten in Seiten auf dem zugrunde liegenden Amazon DocumentDB DocumentDB-Speichervolume.
Im folgenden Diagramm finden Sie beispielsweise einen Amazon DocumentDB-Cluster (A) mit vier Datenseiten, 1, 2, 3 und 4. Stellen Sie sich vor, dass ein Klon, B, aus dem Amazon DocumentDB-Cluster erstellt wird. Wenn der Klon erstellt wird, werden keine Daten kopiert. Vielmehr verweist der Klon auf denselben Seitensatz wie der Amazon DocumentDB DocumentDB-Quellcluster.
![\[Amazon DocumentDB-Cluster-Volume mit 4 Seiten für Quell-Cluster A und Clone B\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Wenn der Klon erstellt wird, ist normalerweise kein zusätzlicher Speicher erforderlich. Das copy-on-write Protokoll verwendet dasselbe Segment auf dem physischen Speichermedium wie das Quellsegment. Zusätzlicher Speicher ist nur erforderlich, wenn die Kapazität des Quellsegments für das gesamte Klonsegment nicht ausreicht. Wenn dies der Fall ist, wird das Quellsegment auf ein anderes physisches Gerät kopiert.
In den folgenden Diagrammen finden Sie ein Beispiel für das copy-on-write Protokoll in Aktion, das denselben Cluster A und seinen Klon B verwendet, wie oben gezeigt. Nehmen wir an, Sie nehmen eine Änderung an Ihrem Amazon DocumentDB-Cluster (A) vor, die zu einer Änderung der auf Seite 1 gespeicherten Daten führt. Anstatt auf die ursprüngliche Seite 1 zu schreiben, erstellt Amazon DocumentDB eine neue Seite 1 [A]. Das Amazon DocumentDB-Cluster-Volume für Cluster (A) verweist jetzt auf die Seiten 1 [A], 2, 3 und 4, während der Klon (B) immer noch auf die Originalseiten verweist.
![\[Amazon DocumentDB DocumentDB-Quell-DB-Cluster-Volume und sein Klon, beide mit Änderungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
Auf dem Klon wird eine Änderung an Seite 4 auf dem Speichervolume vorgenommen. Anstatt auf die ursprüngliche Seite 4 zu schreiben, erstellt Amazon DocumentDB eine neue Seite, 4 [B]. Der Klon verweist nun auf die Seiten 1, 2, 3 und auf Seite 4[B], während der Cluster (A) weiterhin auf 1[A], 2, 3 und 4 verweist.
![\[Amazon DocumentDB DocumentDB-Quell-DB-Cluster-Volume und sein Klon, beide mit Änderungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
Da im Laufe der Zeit immer mehr Änderungen sowohl im Amazon DocumentDB DocumentDB-Quell-Cluster-Volume als auch im Clone vorgenommen werden, wird mehr Speicherplatz benötigt, um die Änderungen zu erfassen und zu speichern.
### Löschen eines Quell-Cluster-Volumes
Wenn Sie ein Quell-Cluster-Volume löschen, dem ein oder mehrere Klone zugeordnet sind, sind die Klone nicht betroffen. Die Klone verweisen weiter auf die Seiten, die zuvor im Besitz des Quell-Cluster-Volumes waren.
## Einen Amazon DocumentDB-Klon erstellen
Sie können einen Clone in demselben AWS Konto wie der Amazon DocumentDB DocumentDB-Quellcluster erstellen. Dazu können Sie das AWS-Managementkonsole oder das AWS CLI und die folgenden Verfahren verwenden.
Mithilfe von Amazon DocumentDB-Cloning können Sie einen bereitgestellten Amazon DocumentDB-Cluster-Klon aus einem bereitgestellten Amazon DocumentDB-Cluster erstellen.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren beschreibt, wie Sie einen Amazon DocumentDB-Cluster mit dem AWS-Managementkonsole klonen.
Erstellen eines Klons anhand der AWS-Managementkonsole Ergebnisse in einem Amazon DocumentDB-Cluster mit einer Amazon DocumentDB DocumentDB-Instance.
Diese Anweisungen gelten für DB-Cluster, die demselben AWS Konto gehören, das den Klon erstellt. Der DB-Cluster muss demselben AWS Konto gehören, da kontoübergreifendes Klonen in Amazon DocumentDB nicht unterstützt wird.
**Um einen Klon eines DB-Clusters zu erstellen, der Ihrem AWS Konto gehört, verwenden Sie AWS-Managementkonsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Wählen Sie Ihren Amazon DocumentDB-Cluster aus der Liste aus und wählen Sie für **Aktionen** die Option **Create clone** aus.
![\[Die Erstellung eines Klons beginnt mit der Auswahl Ihres Amazon DocumentDB-Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Die Seite „Clone erstellen“ wird geöffnet, auf der Sie eine **Cluster-ID** und eine **Instance-Klasse** sowie andere Optionen für den Amazon DocumentDB-Cluster-Klon konfigurieren können.
1. Gehen Sie im Abschnitt **Settings** (Einstellungen) wie folgt vor:
1. Geben Sie **unter Cluster-ID** den Namen ein, den Sie Ihrem geklonten Amazon DocumentDB-Cluster geben möchten.
1. Wählen Sie für die **Instance-Konfiguration** eine geeignete **Instance-Klasse** für Ihren geklonten Amazon DocumentDB-Cluster aus.
![\[Die Erstellung eines Klons beginnt mit der Auswahl Ihres Amazon DocumentDB-Clusters und der Angabe einer DB-Instance-Größe.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Wählen Sie für **Netzwerkeinstellungen** eine **Subnetzgruppe** für Ihren Anwendungsfall und die zugehörigen VPC-Sicherheitsgruppen aus.
1. Wenn für **E ncryption-at-rest** die Verschlüsselung für den Quellcluster (der Cluster, der geklont wird) aktiviert ist, muss auch für den geklonten Cluster die Verschlüsselung aktiviert sein. Wenn dieses Szenario zutrifft, sind die Optionen **Verschlüsselung aktivieren** ausgegraut (deaktiviert), aber die Option **Verschlüsselung aktivieren** ist ausgewählt. Umgekehrt, wenn für den Quellcluster keine Verschlüsselung aktiviert ist, sind die Optionen **Verschlüsselung aktivieren** verfügbar und Sie können wählen, ob die Verschlüsselung aktiviert oder deaktiviert werden soll.
![\[Geben Sie die Netzwerk- und Verschlüsselungseinstellungen für Ihren Amazon DocumentDB-Cluster-Klon an.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Vervollständigen Sie die neue Cluster-Clone-Konfiguration, indem Sie den Typ der zu exportierenden Protokolle auswählen (optional), einen bestimmten Port eingeben, der für die Verbindung mit dem Cluster verwendet wird, und den Schutz vor versehentlichem Löschen des Clusters aktivieren (standardmäßig aktiviert).
![\[Vervollständigen Sie die neue Clone-Konfiguration, indem Sie optional den Typ der zu exportierenden Protokolle, einen bestimmten Port für die Verbindung mit dem Cluster und den Schutz vor versehentlichem Löschen des Clusters auswählen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Beenden Sie die Eingabe aller Einstellungen für Ihren Amazon DocumentDB-Cluster-Klon. Weitere Informationen zu den Cluster- und Instance-Einstellungen von Amazon DocumentDB finden Sie unter[Verwaltung von Amazon DocumentDB-Clustern](db-clusters.md).
1. Wählen Sie **Create clone**, um den Amazon DocumentDB-Klon Ihres ausgewählten Amazon DocumentDB-Clusters zu starten.
Wenn der Klon erstellt wurde, wird er zusammen mit Ihren anderen Amazon DocumentDB-Clustern im Bereich **Datenbanken** der Konsole aufgeführt und zeigt seinen aktuellen Status an. Ihr Klon ist einsatzbereit, wenn sein Status **Verfügbar** ist.
------
#### [ Using the AWS CLI ]
Die Verwendung des AWS CLI zum Klonen Ihres Amazon DocumentDB-Clusters umfasst einige Schritte.
Der `restore-db-cluster-to-point-in-time` AWS CLI Befehl, den Sie verwenden, führt zu einem leeren Amazon DocumentDB-Cluster mit 0 Amazon DocumentDB DocumentDB-Instances. Das heißt, der Befehl stellt nur den Amazon DocumentDB-Cluster wieder her, nicht die DB-Instances für diesen Cluster. Sie tun dies separat, nachdem der Klon verfügbar ist. Die zwei Schritte im Prozess sind wie folgt:
1. Erstellen Sie den Klon mit dem Befehl [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. Die Parameter, die Sie mit diesem Befehl verwenden, steuern den Kapazitätstyp und andere Details des leeren Amazon DocumentDB-Clusters (Klons), der erstellt wird.
1. Erstellen Sie die Amazon DocumentDB-Instance für den Clone, indem Sie den [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI-Befehl verwenden, um die Amazon DocumentDB DocumentDB-Instance im wiederhergestellten Amazon DocumentDB-Cluster neu zu erstellen.
Bei den folgenden Befehlen AWS CLI wird davon ausgegangen, dass Ihre AWS Region standardmäßig eingerichtet ist. Dieser Ansatz erspart Ihnen die Übergabe des `--region`-Namens in jedem der Befehle. Weitere Informationen finden Sie unter [Konfigurieren der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Sie können die `--region` auch in jedem der folgenden CLI-Befehle angeben.
**Topics**
**Der Klon wird erstellt**
Die spezifischen Parameter, die Sie an den `[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-Befehl übergeben, variieren. Was Sie übergeben, hängt von der Art des Klons ab, den Sie erstellen möchten.
Gehen Sie wie folgt vor, um einen bereitgestellten Amazon DocumentDB-Klon aus einem bereitgestellten Amazon DocumentDB-Cluster zu erstellen.
**Um einen Klon desselben Engine-Modus wie der Amazon DocumentDB DocumentDB-Quellcluster zu erstellen**
+ Verwenden Sie den `[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-Befehl und geben Sie Werte für die folgenden Parameter an:
+ `--db-cluster-identifier` – Wählen Sie einen aussagekräftigen Namen für Ihren Klon. Sie geben dem Klon einen Namen, wenn Sie den Befehl [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 verwenden.
+ `--restore-type` – Verwenden Sie `copy-on-write`, um einen Klon des Quell-DB-Clusters zu erstellen. Ohne diesen Parameter `restore-db-cluster-to-point-in-time` stellt der den Amazon DocumentDB-Cluster wieder her, anstatt einen Klon zu erstellen. Die Standardeinstellung für `restore-type` ist`full-copy`.
+ `--source-db-cluster-identifier`— Verwenden Sie den Namen des Amazon DocumentDB DocumentDB-Quellclusters, den Sie klonen möchten.
+ `--use-latest-restorable-time` – Dieser Wert verweist auf die neuesten wiederherstellbaren Volume-Daten für den Klon. Dieser Parameter ist erforderlich für`restore-type copy-on-write`, Sie können den jedoch nicht `restore-to-time parameter` zusammen verwenden.
Im folgenden Beispiel wird ein Klon namens `my-clone` aus einem Cluster namens `my-source-cluster` erstellt.
Für Linux, macOS oder 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
```
Für 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
```
Der Befehl gibt das JSON-Objekt zurück, das Details des Klons enthält. Stellen Sie sicher, dass Ihr geklonter DB-Cluster verfügbar ist, bevor Sie versuchen, die DB-Instance für Ihren Klon zu erstellen. Weitere Informationen finden Sie weiter unten unter Status überprüfen und Details zum Klonen abrufen:
**Status überprüfen und Details zum Klonen abrufen**
Mit dem folgenden Befehl können Sie den Status Ihres neu erstellten leeren DB-Clusters überprüfen.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Oder Sie können den Status und die anderen Werte, die Sie zum Erstellen der DB-Instance für Ihren Clone benötigen, mithilfe der folgenden AWS CLI Abfrage abrufen:
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Für Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Diese Abfrage gibt eine Ausgabe ähnlich der folgenden zurück.
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Erstellen der Amazon DocumentDB DocumentDB-Instance für Ihren Clone**
Verwenden Sie den [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI-Befehl, um die DB-Instance für Ihren Clone zu erstellen.
Der `--db-instance-class` Parameter wird nur für bereitgestellte Amazon DocumentDB-Cluster verwendet.
Für Linux, macOS oder 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
```
Für 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
```
**Parameter, die für das Klonen verwendet werden sollen**
In der folgenden Tabelle sind die verschiedenen Parameter zusammengefasst, die zum Klonen von Amazon DocumentDB-Clustern verwendet werden. `restore-db-cluster-to-point-in-time`
| Parameter | Description |
| --- | --- |
| --source-db-cluster-identifier | Verwenden Sie den Namen des Amazon DocumentDB DocumentDB-Quellclusters, den Sie klonen möchten. |
| --db-cluster-identifier | Wählen Sie einen aussagekräftigen Namen für Ihren Klon. Sie benennen Ihren Klon mit dem ` restore-db-cluster-to-point-in-time`-Befehl. Dann übergeben Sie diesen Namen an den `create-db-instance`-Befehl. |
| --restore-type | Geben Sie `copy-on-write` als an`--restore-type`, um einen Klon des Quell-DB-Clusters zu erstellen, anstatt den Amazon DocumentDB DocumentDB-Quellcluster wiederherzustellen. |
| --use-latest-restorable-time | ieser Wert verweist auf die neuesten wiederherstellbaren Volume-Daten für den Klon. |
------