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.

Ü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

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. In diesem Fall müssen die Subnetze der VPCs denselben Availability Zones zugeordnet sein.

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-writeProtokoll, 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 unterVerwaltung von Amazon DocumentDB-Clustern.

Themen

• Das Protokoll verstehen copy-on-write
• Löschen eines Quell-Cluster-Volumes

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.

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.

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.

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 Management Console 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 Management Console

Das folgende Verfahren beschreibt, wie Sie einen Amazon DocumentDB-Cluster mit dem AWS Management Console klonen.

Erstellen eines Klons anhand der AWS Management Console 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 Management Console

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

2. Klicken Sie im Navigationsbereich auf Cluster.

3. Wählen Sie Ihren Amazon DocumentDB-Cluster aus der Liste aus und wählen Sie für Aktionen die Option Create clone aus.

   

   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.

4. 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.

   2. Wählen Sie für die Instance-Konfiguration eine geeignete Instance-Klasse für Ihren geklonten Amazon DocumentDB-Cluster aus.

      

   3. Wählen Sie für Netzwerkeinstellungen eine Subnetzgruppe für Ihren Anwendungsfall und die zugehörigen VPC-Sicherheitsgruppen aus.

   4. 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.

      

   5. 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).

      

   6. 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 unterVerwaltung von Amazon DocumentDB-Clustern.

5. 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 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.

2. Erstellen Sie die Amazon DocumentDB-Instance für den Clone, indem Sie den create-db-instanceCLI-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. Sie können die --region auch in jedem der folgenden CLI-Befehle angeben.

Themen

Der Klon wird erstellt

Die spezifischen Parameter, die Sie an den restore-db-cluster-to-point-in-time-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-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 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 istfull-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ürrestore-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-instanceCLI-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	Beschreibung
--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.