View a markdown version of this page

Verwaltung eines globalen Amazon DocumentDB-Clusters - Amazon DocumentDB

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.

Verwaltung eines globalen Amazon DocumentDB-Clusters

Sie führen die meisten Verwaltungsvorgänge auf den einzelnen Clustern durch, aus denen sich ein globaler Cluster zusammensetzt. Wenn Sie in der Konsole auf der Seite Cluster die Option Verwandte Ressourcen gruppieren auswählen, werden der primäre Cluster und die sekundären Cluster unter dem zugehörigen globalen Cluster gruppiert angezeigt.

Auf der Registerkarte „Konfiguration“ für einen globalen Cluster werden der AWS-Regionen Ort, an dem die Cluster ausgeführt werden, die Version und die globale Cluster-ID angezeigt.

Ändern eines globalen Amazon DocumentDB-Clusters

Auf der Seite „Cluster“ AWS-Managementkonsole werden alle Ihre globalen Cluster aufgeführt, wobei jeweils der primäre Cluster und der sekundäre Cluster angezeigt werden. Der globale Cluster hat seine eigenen Konfigurationseinstellungen. Insbesondere hat er Regionen, die seinen primären und sekundären Clustern zugeordnet sind.

Wenn Sie Änderungen am globalen Cluster vornehmen, haben Sie die Möglichkeit, die Änderungen rückgängig zu machen.

Wenn Sie Weiter wählen, bestätigen Sie die Änderungen.

Ändern von Parametern in einem globalen Amazon DocumentDB-Cluster

Sie können die Cluster-Parametergruppen unabhängig für jeden Cluster innerhalb des globalen Clusters konfigurieren. Die meisten Parameter funktionieren genauso wie für andere Arten von Amazon DocumentDB-Clustern. Sorgen Sie dafür, dass die Einstellungen aller Cluster in einer globalen Datenbank konsistent sind, um unerwartete Verhaltensänderungen zu vermeiden, wenn Sie einen sekundären Cluster zum primären Cluster heraufstufen.

Sie sollten z. B. die gleichen Einstellungen für Zeitzonen und Zeichensätze verwenden, um inkonsistentes Verhalten zu vermeiden, wenn ein anderer Cluster die Rolle des primären Clusters übernimmt.

Einen Cluster aus einem globalen Amazon DocumentDB-Cluster entfernen

Es gibt verschiedene Situationen, in denen Sie Cluster aus Ihrem globalen Cluster entfernen möchten. Beispielsweise möchten Sie möglicherweise einen Cluster aus einem globalen Cluster entfernen, wenn der primäre Cluster heruntergestuft oder isoliert wird. Es wird dann zu einem eigenständigen bereitgestellten Cluster, der zum Erstellen eines neuen globalen Clusters verwendet werden kann. Weitere Informationen hierzu finden Sie unter Durchführung eines manuellen Failovers für einen globalen Amazon DocumentDB-Cluster.

Möglicherweise möchten Sie auch Cluster entfernen, weil Sie einen globalen Cluster löschen möchten, den Sie nicht mehr benötigen. Sie können den globalen Cluster erst löschen, nachdem Sie alle zugehörigen Cluster getrennt haben und der primäre Cluster als letzter übrig bleibt. Weitere Informationen finden Sie unter Löschen eines Clusters aus einem globalen Amazon DocumentDB-Cluster.

Anmerkung

Wenn ein Cluster vom globalen Cluster getrennt wird, wird er nicht mehr mit dem primären Cluster synchronisiert. Es wird zu einem eigenständigen bereitgestellten Cluster mit vollem read/write Funktionsumfang. Außerdem ist es in der Amazon DocumentDB-Konsole nicht mehr sichtbar. Es ist nur sichtbar, wenn Sie in der Konsole die Region auswählen, in der sich der Cluster befand.

Sie können Cluster mithilfe der AWS-Managementkonsole, der oder der RDS-API aus Ihrem globalen Cluster entfernen. AWS CLI

Using the AWS-Managementkonsole
  1. Melden Sie sich bei der an AWS-Managementkonsole und navigieren Sie zur Amazon DocumentDB-Konsole.

  2. Wählen Sie in der linken Navigationsleiste Clusters aus.

    Bild: Das Cluster-Navigationsfeld mit einer Liste der vorhandenen Cluster-Links und der entsprechenden Instanz-Links.
  3. Erweitern Sie den globalen Cluster, sodass Sie alle sekundären Cluster sehen können. Wählen Sie die sekundären Cluster aus, die Sie entfernen möchten. Wählen Sie Aktionen und wählen Sie im Dropdownmenü die Option Aus der globalen Liste entfernen aus.

    Bild: Das Navigationsfeld „Cluster“ zeigt die Auswahl eines vorhandenen sekundären Clusters und hebt die Aktion „Aus der globalen Liste entfernen“ hervor.
  4. Es wird eine Aufforderung angezeigt, in der Sie aufgefordert werden, zu bestätigen, dass Sie den sekundären Cluster vom globalen Cluster trennen möchten. Wählen Sie Entfernen und heraufstufen, um den Cluster aus dem globalen Cluster zu entfernen.

    Bild: Die Aufforderung zum Entfernen und Heraufstufen.

Jetzt dient dieser Cluster nicht mehr als sekundärer Cluster und ist nicht mehr mit dem primären Cluster synchronisiert. Es handelt sich um einen eigenständigen Cluster mit vollem read/write Funktionsumfang.

Nachdem Sie alle sekundären Cluster entfernt oder gelöscht haben, können Sie den primären Cluster auf die gleiche Weise entfernen. Sie können den primären Cluster erst trennen oder vom globalen Cluster entfernen, nachdem Sie alle sekundären Cluster entfernt haben. Der globale Cluster verbleibt möglicherweise in der Cluster-Liste und enthält keine Regionen und AZs. Sie können ihn löschen, wenn Sie diesen globalen Cluster nicht mehr verwenden möchten.

Using the AWS CLI

Um einen Cluster aus einem globalen Cluster zu entfernen, führen Sie den remove-from-global-cluster CLI-Befehl mit den folgenden Parametern aus:

  • --global-cluster-identifier— Der Name (Identifier) Ihres globalen Clusters.

  • --db-cluster-identifier— Der Name jedes Clusters, das aus dem globalen Cluster entfernt werden soll.

In den folgenden Beispielen wird zuerst ein sekundärer Cluster und dann der primäre Cluster aus einem globalen Cluster entfernt.

Für Linux, macOS oder 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

Wiederholen Sie den remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN Befehl für jede sekundäre Region in Ihrem globalen Cluster.

Für 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

Wiederholen Sie den remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN Befehl für jede sekundäre Region in Ihrem globalen Cluster.

Löschen eines Clusters aus einem globalen Amazon DocumentDB-Cluster

Gehen Sie wie folgt vor, um einen globalen Cluster zu löschen:

  • Entfernen Sie alle sekundären Cluster aus dem globalen Cluster. Jeder Cluster wird zu einem eigenständigen Cluster. Weitere Informationen finden Sie im vorherigen Abschnitt,Einen Cluster aus einem globalen Amazon DocumentDB-Cluster entfernen.

  • Löschen Sie aus jedem Standalone-Cluster alle Replikate.

  • Entfernen Sie den primären Cluster aus dem globalen Cluster. Dies wird zu einem eigenständigen Cluster.

  • Löschen Sie aus dem primären Cluster zuerst alle Replikate und dann die primäre Instance. Durch das Löschen der primären Instance aus dem neuen Standalone-Cluster werden in der Regel auch der Cluster und der globale Cluster entfernt.

Using the AWS-Managementkonsole
  1. Melden Sie sich bei der an AWS-Managementkonsole und navigieren Sie zur Amazon DocumentDB-Konsole.

  2. Wählen Sie Clusters und suchen Sie den globalen Cluster, den Sie löschen möchten.

    Bild: Das Cluster-Navigationsfeld mit einer Liste der vorhandenen Cluster-Links und der entsprechenden Instanz-Links.
  3. Wählen Sie bei ausgewähltem globalen Cluster im Menü „Aktionen“ die Option Löschen aus.

    Bild: Das Cluster-Navigationsfeld zeigt die Auswahl eines globalen Clusters und hebt die Aktion „Löschen“ hervor.

Vergewissern Sie sich, dass alle Cluster aus dem globalen Cluster entfernt wurden. Der globale Cluster sollte keine Regionen und AZs und eine Clustergröße von Null aufweisen. Wenn der globale Cluster Cluster enthält, können Sie ihn noch nicht löschen. Sie müssen zuerst die Anweisungen im vorherigen Schritt befolgen Einen Cluster aus einem globalen Amazon DocumentDB-Cluster entfernen.

Using the AWS CLI

Um einen globalen Cluster zu löschen, führen Sie den delete-global-cluster CLI-Befehl mit dem Namen AWS-Region und der globalen Cluster-ID aus, wie im folgenden Beispiel gezeigt.

Für Linux, macOS oder Unix:

aws docdb --region primary_region delete-global-cluster \ --global-cluster-identifier global_cluster_id

Für Windows:

aws docdb --region primary_region delete-global-cluster ^ --global-cluster-identifier global_cluster_id

Erstellen eines Headless-Amazon DocumentDB-Clusters in einer sekundären Region

Obwohl ein globaler Amazon DocumentDB-Cluster mindestens einen sekundären Cluster in einem anderen AWS-Region als dem primären Cluster benötigt, können Sie eine Headless-Konfiguration für den sekundären Cluster verwenden. Ein sekundärer Amazon DocumentDB-Cluster ohne Headless ist ein Cluster ohne Instance. Diese Art der Konfiguration kann die Kosten für einen globalen Cluster senken. In einem Amazon DocumentDB-Cluster sind Rechenleistung und Speicher entkoppelt. Ohne die Instance wird Ihnen keine Rechenleistung berechnet, sondern nur die Speicherung. Wenn es richtig eingerichtet ist, wird das Speicher-Volume eines sekundären Headless-Clusters mit dem primären Cluster synchronisiert.

Sie fügen den sekundären Cluster wie gewohnt hinzu, wenn Sie einen globalen Amazon DocumentDB-Cluster erstellen. Nachdem der primäre Cluster jedoch mit der Replikation auf den sekundären Cluster begonnen hat, löschen Sie die schreibgeschützte Instance aus dem sekundären Cluster. Dieser sekundäre Cluster gilt jetzt als „headless“, da er keine Instanz mehr hat. Das Speichervolume wird jedoch mit dem primären Amazon DocumentDB-Cluster synchronisiert.

Wichtig

Verwenden Sie Headless-Cluster nur, wenn Sie Region-wide Ausfälle für 15 Minuten oder länger tolerieren können. Für die Wiederherstellung nach einem Region-wide Ausfall mit einem sekundären Headless-Cluster müssen Sie nach einem Failover eine neue Instance erstellen. Es kann 10—15 Minuten dauern, bis eine neue Instanz verfügbar ist.

So fügen Sie Ihrem globalen Cluster einen sekundären Headless-Cluster hinzu

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie in der linken Navigationsleiste Clusters aus.

  3. Wählen Sie den globalen Cluster aus, der einen sekundären Cluster benötigt. Stellen Sie sicher, dass der primäre Available Cluster

  4. Wählen Sie für Aktionen die Option Region hinzufügen aus.

  5. Wählen Sie auf der Seite „Region hinzufügen“ die sekundäre Region aus.

    Anmerkung

    Sie können keine Region auswählen, die bereits über einen sekundären Cluster für denselben globalen Cluster verfügt. Außerdem kann es sich nicht um dieselbe Region wie der primäre Cluster handeln.

  6. Füllen Sie die restlichen Felder für den sekundären -Cluster in der neuen -Region aus. Dies sind dieselben Konfigurationsoptionen wie für jede Clusterinstanz.

  7. Fügen Sie eine Region hinzu. Nachdem Sie das Hinzufügen der Region zu Ihrem globalen Cluster abgeschlossen haben, erscheint sie Clusters in der Liste der AWS-Managementkonsole.

  8. Überprüfen Sie den Status des sekundären Clusters und seiner Reader-Instance, bevor Sie fortfahren. Verwenden Sie AWS-Managementkonsole dazu die oder AWS CLI. Hier ist ein Beispielbefehl, wenn Sie den verwenden AWS CLI:

    $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text

    Es kann mehrere Minuten dauern, bis der Status eines neu hinzugefügten sekundären Clusters von „Erstellt“ zu „Verfügbar“ wechselt. Wenn der Cluster verfügbar ist, können Sie die Reader-Instanz löschen.

  9. Wählen Sie die Reader-Instance im sekundären Cluster aus und klicken Sie dann auf Löschen.

  10. Nach dem Löschen der Reader-Instance bleibt der sekundäre Cluster Teil des globalen Clusters. Ihm sollte keine Instanz zugeordnet sein.

Anmerkung

Sie können diesen kopflosen sekundären Amazon DocumentDB-Cluster verwenden, um Ihren globalen Amazon DocumentDB-Cluster nach einem ungeplanten Ausfall in der primären Region manuell wiederherzustellen, falls ein solcher Ausfall auftritt.