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. # Migration zu Amazon DocumentDB serverlos **Topics** + [Migration vorhandener DocumentDB-Cluster auf Serverless](#w2aac41c19b5) + [Migration von MongoDB zu DocumentDB serverlos](#w2aac41c19b7) ## Migration vorhandener DocumentDB-Cluster auf Serverless ### Aktualisierung der Engine-Version eines Clusters Wenn auf Ihrem bereitgestellten Cluster eine niedrigere Engine-Version ausgeführt wird, die DocumentDB serverless nicht unterstützt, müssen Sie den Cluster zunächst auf eine unterstützte Engine-Version aktualisieren. Weitere Informationen finden Sie unter [Direktes Upgrade der Hauptversion von Amazon DocumentDB](docdb-mvu.md). ### Migration eines bereitgestellten Clusters zu DocumentDB serverless Gehen Sie wie folgt vor, um einen bereitgestellten Cluster auf die serverlose Verwendung von DocumentDB umzustellen: 1. Prüfen Sie, ob die Engine-Version des bereitgestellten Clusters aktualisiert werden muss, damit sie mit DocumentDB serverless verwendet werden kann. Siehe [Anforderungen und Einschränkungen für DocumentDB serverless](docdb-serverless-limitations.md). **Anmerkung** Wenn auf dem bereitgestellten Cluster eine Engine-Version ausgeführt wird, die für DocumentDB serverless nicht verfügbar ist, aktualisieren Sie die Engine-Version des Clusters. Siehe [Direktes Upgrade der Hauptversion von Amazon DocumentDB](docdb-mvu.md). 1. Konfigurieren Sie die Skalierungskonfiguration für den Cluster. Einzelheiten zur Auswahl der Skalierungskonfiguration finden Sie unter. [Auswahl des Skalierungskapazitätsbereichs für einen serverlosen DocumentDB-Cluster](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing) Informationen zum Ändern der Skalierungskonfiguration für einen Cluster finden Sie unter[Die Konfiguration des Skalierungskapazitätsbereichs eines Clusters anzeigen und ändern](docdb-serverless-managing.md#docdb-serverless-range-config). 1. Konfigurieren Sie alle anderen Clustereigenschaften, um die serverlosen Anforderungen und Einschränkungen von DocumentDB zu berücksichtigen. [Anforderungen und Einschränkungen für DocumentDB serverless](docdb-serverless-limitations.md) 1. Fügen Sie dem Cluster eine oder mehrere serverlose DocumentDB-Instanzen hinzu. Folgen Sie dem Verfahren unter [Hinzufügen einer serverlosen Amazon DocumentDB DocumentDB-Instance](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance). **Anmerkung** In einigen Fällen verfügen Sie möglicherweise bereits über eine oder mehrere bereitgestellte Reader-Instanzen im Cluster. In diesem Fall können Sie einen der Reader in eine serverlose DocumentDB-Instanz konvertieren, anstatt eine neue Instanz zu erstellen. Eine Schritt-für-Schritt-Anleitung hierzu finden Sie unter [Die Klasse einer Instance ändern](db-instance-classes.md#db-instance-class-changing). 1. (Optional) Führen Sie einen Failover-Vorgang durch, um eine serverlose DocumentDB-Instance zum Cluster-Writer zu machen. Siehe [Amazon DocumentDB-Failover](failover.md). 1. (Optional) Konvertieren Sie alle verbleibenden bereitgestellten Amazon DocumentDB DocumentDB-Instances in serverlose DocumentDB-Instances (siehe[Die Klasse einer Instance ändern](db-instance-classes.md#db-instance-class-changing)) oder entfernen Sie sie aus dem Cluster (siehe). [Löschen einer Amazon DocumentDB DocumentDB-Instance](db-instance-delete.md) ------ #### [ Using the AWS-Managementkonsole ] Das folgende AWS-Managementkonsole Konfigurationsbeispiel zeigt den Migrationsprozess mithilfe eines von Amazon DocumentDB bereitgestellten Clusters, auf dem Amazon DocumentDB 5.0.0 ausgeführt wird. Für den Start der serverlosen Nutzung von DocumentDB ist kein Upgrade der Engine-Version erforderlich. Der Cluster hat einen Namen und beginnt mit drei bereitgestellten Instances namens`sample`, und. `sample` `sample2` `sample3` In diesem Beispiel werden diese drei Instanzen durch drei serverlose Instanzen ersetzt. 1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie. 1. Klicken Sie im Navigationsbereich auf **Cluster**. **Tipp** Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus. Die **Cluster-Tabelle** wird angezeigt. 1. Aktivieren Sie in der **Cluster-Tabelle** das Kontrollkästchen des Clusters, dem Sie eine serverlose Instance hinzufügen möchten. 1. Wählen Sie **Actions (Aktionen)** und dann **Add instances (Instances hinzufügen)** aus. 1. Wählen **Sie im Dialogfeld „Instanzen hinzufügen**“ im Abschnitt **DB-Instance-Klasse für jede neue **serverlose** Instance**, die Sie erstellen möchten, die Option Serverless aus. 1. Für **Einstellungen zur serverlosen Kapazität** legen Sie die Skalierungskonfiguration auf der Grundlage der Kapazitätsbeschreibung im Dialogfeld fest. 1. (Optional) Um eine weitere Instanz hinzuzufügen, wählen Sie **Instanz hinzufügen**. Fügen Sie weitere Instanzen hinzu, bis Sie die gewünschte Anzahl neuer Instanzen erreicht haben. In diesem Beispiel werden drei neue serverlose Instanzen erstellt. 1. Wählen Sie **Erstellen** aus. Es dauert einige Minuten, bis eine Instance erstellt ist. Sie können die Konsole oder die verwenden AWS CLI , um den Status der Instanz einzusehen. Weitere Informationen finden Sie unter [Überwachen des Status eines Amazon DocumentDB-Clusters](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html). 1. Kehren Sie zur **Cluster-Tabelle** zurück und aktivieren Sie die Kontrollkästchen aller drei ursprünglich bereitgestellten Instances. 1. Wählen Sie **Aktionen** und anschließend **Löschen** aus. Während des Löschvorgangs wird automatisch ein Failover durchgeführt, um eine der verbleibenden Instances zum Writer hochzustufen. Nach einigen Minuten ist der Löschvorgang abgeschlossen. Der bestehende Cluster enthält jetzt drei serverlose DocumentDB-Instanzen (wie in der Spalte **Größe** definiert). ------ #### [ Using the AWS CLI ] Das folgende AWS CLI Konfigurationsbeispiel zeigt den Migrationsprozess mithilfe eines von Amazon DocumentDB bereitgestellten Clusters, auf dem Amazon DocumentDB 5.0.0 ausgeführt wird. Für den Start der serverlosen Nutzung von DocumentDB ist kein Upgrade der Engine-Version erforderlich. Der Cluster hat einen Namen und beginnt mit drei bereitgestellten Instances namens`sample`, und. `sample` `sample2` `sample3` In diesem Beispiel werden diese drei Instanzen durch drei serverlose Instanzen ersetzt. Der Cluster hat einen Namen `sample-cluster` und beginnt mit zwei bereitgestellten Instanzen namens `sample-provisioned-instance-1` und`sample-provisioned-instance-2`, einer Writer-Instanz und einer Reader-Instanz. Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen oder Konfigurationsparameter. Verwenden Sie den `aws docdb describe-db-clusters` Vorgang, um den Status eines Clusters zu ermitteln. Der folgende Code ermittelt den Status des Clusters `sample-cluster` und gibt die Ergebnisse in einer Tabelle aus: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers' \ --output table ``` ``` -------------------------------------------------------------------------------------------------------- | DescribeDBClusters | +--------------------------------+---------------------------------+------------------+----------------+ | DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier | +--------------------------------+---------------------------------+------------------+----------------+ | in-sync | sample-provisioned-instance-2 | False | 1 | | in-sync | sample-provisioned-instance-1 | True | 1 | +--------------------------------+---------------------------------+------------------+----------------+ ``` Fügen Sie die Skalierungskonfiguration für den Cluster hinzu: ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16 ``` Fügen Sie die serverlosen Instanzen hinzu. In diesem Beispiel werden neue serverlose Instanzen benannt `sample-serverless-instance-1` und hinzugefügt`sample-serverless-instance-2`: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-serverless-instance-1 \ --db-instance-class db.serverless \ --engine docdb aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-serverless-instance-2 \ --db-instance-class db.serverless \ --engine docdb ``` Geben Sie Folgendes ein, um zu warten, bis die serverlosen Instanzen verfügbar sind, bevor Sie fortfahren: ``` aws docdb wait db-instance-available \ --db-instance-identifier sample-serverless-instance-1 aws docdb wait db-instance-available \ --db-instance-identifier sample-serverless-instance-2 ``` Führen Sie einen Failover durch, um die neue `sample-serverless-instance-1` Instanz zum Cluster-Writer zu machen: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster \ --target-db-instance-identifier sample-serverless-instance-1 ``` Es dauert einige Sekunden, bis der Failover abgeschlossen ist. Danach wird sample-serverless-instance -1 zum Cluster-Writer. Überprüfen Sie dies mit der folgenden Eingabe: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers' \ --output table ``` ``` -------------------------------------------------------------------------------------------------------- | DescribeDBClusters | +--------------------------------+---------------------------------+------------------+----------------+ | DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier | +--------------------------------+---------------------------------+------------------+----------------+ | in-sync | sample-provisioned-instance-2 | False | 1 | | in-sync | sample-provisioned-instance-1 | False | 1 | | in-sync | sample-serverless-instance-2 | False | 1 | | in-sync | sample-serverless-instance-1 | True | 1 | +--------------------------------+---------------------------------+------------------+----------------+ ``` Löschen Sie abschließend die ursprünglich bereitgestellten Instanzen: ``` aws docdb delete-db-instance \ --db-instance-identifier sample-provisioned-instance-1 aws docdb delete-db-instance \ --db-instance-identifier sample-provisioned-instance-2 ``` ------ ## Migration von MongoDB zu DocumentDB serverlos Sie können Ihre MongoDB-Datenbanken zu DocumentDB serverless migrieren, genau wie bei der bereitgestellten Amazon DocumentDB. Weitere Informationen finden Sie unter [Migration zu Amazon DocumentDB](docdb-migration.md).