View a markdown version of this page

Direktes Upgrade der Hauptversion von Amazon DocumentDB - Amazon DocumentDB
Unterstützte Upgrade-PfadeVoraussetzungenBest PracticesWas ändert sich nach dem Upgrade von Amazon DocumentDB 5.0 auf 8.0Post-upgrade Überlegungen zu Clustern, die von 3.6 oder 4.0 aktualisiert wurdenDas Upgrade wird durchgeführtFehlerbehebung

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.

Direktes Upgrade der Hauptversion von Amazon DocumentDB

Sie können ein direktes Major Version Upgrade (MVU) Ihres Amazon DocumentDB-Clusters durchführen und dabei dieselben Endpunkte, Speicher und Tags beibehalten. Ihre Anwendungen funktionieren weiterhin ohne Änderungen. Diese Funktion ist in allen Regionen, in denen Amazon DocumentDB verfügbar ist, ohne zusätzliche Kosten verfügbar.

Wichtig

Ihr Cluster ist während des Upgrades nicht verfügbar und wird mehrfach neu gestartet. Stellen Sie nach dem Start des Upgrades keine Verbindung zum Cluster her, lesen Sie nicht aus dem Cluster und schreiben Sie nicht in ihn. Die Ausfallzeit hängt von der Anzahl der Sammlungen, Indizes, Datenbanken und Instanzen ab. Wir empfehlen, das Upgrade während Ihres Wartungsfensters oder zu Zeiten mit geringer Auslastung durchzuführen.

Nach dem Upgrade können Sie kein Downgrade auf eine frühere Version durchführen. Sie können Ihren Snapshot vor dem Upgrade bei Bedarf auf einem neuen Cluster wiederherstellen.

Unterstützte Upgrade-Pfade

Quellversion Zielversion

Amazon DocumentDB 3.6

Amazon DocumentDB 5.0

Amazon DocumentDB 4.0

Amazon DocumentDB 5.0

Amazon DocumentDB 5.0

Amazon DocumentDB 8.0
Anmerkung

In-place MVU wird für globale Cluster oder elastische Cluster nicht unterstützt. Um einen globalen Cluster zu aktualisieren, entfernen Sie die sekundären Cluster, konvertieren Sie den primären in einen regionalen Cluster, führen Sie die MVU durch und erstellen Sie dann den globalen Cluster neu, indem Sie sekundäre Cluster mit denselben Namen hinzufügen, um Ihre Endpunkte beizubehalten. Es fallen I/O Gebühren an, während der aktualisierte Primärserver Daten auf die neuen Sekundärsysteme repliziert. Die detaillierten Schritte finden Sie unter Entfernen eines Clusters aus einem globalen Amazon DocumentDB-Cluster.

Voraussetzungen

  • Instance-Typ — Amazon DocumentDB 4.0+ unterstützt keine db.r4-Instances. Ändern Sie vor dem Upgrade alle db.r4.* Instances in Instances oder eine neuere db.r5.* Version. Siehe Ändern einer Amazon DocumentDB DocumentDB-Instance und Unterstützte Instance-Klassen nach Region.

  • Betriebssystem-Patches — Wenden Sie vor dem Upgrade alle ausstehenden Betriebssystem-Wartungsaktionen auf alle Instanzen an. Siehe Betriebssystem-Updates für Amazon DocumentDB.

    Anmerkung

    Ausstehende Engine-Patches auf Clusterebene können Instanz-Betriebssystem-Patches verbergen. Wenden Sie bei Bedarf zuerst Engine-Patches an. Siehe Durchführen eines Patch-Updates für die Engine-Version eines Clusters.

  • Indexgrenzwerte für Burstable-Instances (Instances der T-Familie) — Wenn Sie über mehr als 3.000 Indizes für Burstable-Instances verfügen, skalieren Sie vor dem Upgrade die Primär-Instances auf mindestens db.r5.large. Sie können nach Abschluss des Upgrades wieder herunterskalieren.

    Instance Maximale Anzahl an Indizes für MVU

    db.t4g.medium

    3.000

    db.t3.medium

    10 K

  • Parametergruppe — Wir empfehlen, vor dem Upgrade eine benutzerdefinierte Cluster-Parametergruppe für die Zielversion bereit zu haben. Wenn keine angegeben ist, wird die Standardparametergruppe für die Zielversion verwendet (z. B. default.docdb5.0 oderdefault.docdb8.0).

  • Manueller Snapshot — Erstellen Sie vor dem Upgrade einen manuellen Snapshot. Der Upgrade-Prozess erstellt einen automatischen Snapshot mit dem Namenpreupgrade-<name>-<version>-<timestamp>, aber wir empfehlen dringend, ein eigenes Backup zu erstellen. Siehe Einen manuellen Cluster-Snapshot erstellen.

    Anmerkung

    Der durch den Upgrade-Prozess erstellte auto Snapshot wird nicht automatisch gelöscht, nachdem das direkte Upgrade der Hauptversion abgeschlossen ist. Für diesen Snapshot fallen keine Gebühren an, solange er sich innerhalb der Aufbewahrungsfrist befindet. Sie können sich dafür entscheiden, diesen Snapshot zu löschen, sobald Sie bestätigt haben, dass Ihr Cluster erfolgreich aktualisiert wurde.

    Bild: Das Snapshots-Navigationsfeld mit einer Tabelle mit zuvor erstellten Snapshots.

Best Practices

Vor dem Upgrade — Testen mit einem Klon

  1. Wird verwendetKlonen eines Volumes für einen Amazon DocumentDB-Cluster, um einen Klon Ihres Clusters zu erstellen. Es fallen keine Speicherkosten an, es sei denn, Sie ändern die Daten auf dem Klon.

  2. Ordnen Sie die Anzahl der Instanzen des Klons dem Zielcluster zu, um eine realistische Zeitschätzung zu erhalten.

  3. Führen Sie die MVU auf dem Klon durch und testen Sie ihn vollständig auf funktionale Unterschiede.

  4. Prüfen Sie anhand von running describe-db-clustersand looking forPendingModifiedValues.EngineVersion, ob bereits ein Upgrade geplant ist. Wenn Sie den Cluster geändert und ausgewählt haben, ihn im nächsten Wartungsfenster anzuwenden, ist der Zeitplan nicht in der Konsole sichtbar, Sie können ihn jedoch in der folgenden Datei einsehen AWS CLI:

    aws docdb describe-db-clusters \
  --region us-east-1 \
  --db-cluster-identifier mydocdbcluster
    "PendingModifiedValues": {
    "EngineVersion": "5.0.0"
},

  5. Wenn der Test erfolgreich ist, fahren Sie mit dem Upgrade auf Ihrem Produktionscluster fort.

Während des Upgrades

Sie können den Fortschritt Ihres direkten Hauptversions-Upgrades überwachen, indem Sie Cluster-Wartungsereignisse abonnieren. Wenn das Upgrade abgeschlossen ist, erhalten Sie die Meldung „Die Datenbankcluster-Hauptversion wurde aktualisiert“. Dieses und andere Ereignisse, die während des Upgrades auftreten, werden im Abschnitt Ereignisse und Tags der Cluster-Detailseite in der Amazon DocumentDB DocumentDB-Konsole angezeigt. Der Cluster-Status ändert sich dann von upgrading zuavailable.

Die folgenden Ereignisse werden während des Upgrades generiert:

  1. Das Upgrade der Hauptversion der Datenbank-Cluster-Engine wurde gestartet. Der Cluster bleibt online.

  2. Upgrade-Vorbereitung im Gange: Die Online-Upgrade-Vorabprüfungen werden gestartet.

  3. Upgrade-Vorbereitung im Gange: Die Online-Upgrade-Vorabprüfungen wurden abgeschlossen.

  4. Der Datenbankcluster wird offline geschaltet, während die primäre Instanz den patch/upgrade Vorgang abschließt.

  5. Upgrade-Vorbereitung läuft: Die Offline-Upgrade-Vorabprüfungen werden gestartet.

  6. Upgrade-Vorbereitung läuft: Die Offline-Upgrade-Vorprüfungen wurden abgeschlossen.

  7. <version-to><timestamp>Aktualisierung läuft: Der Snapshot vor dem Upgrade wird erstellt [preupgrade- <cluster-name>- <version-from>-to- -].

  8. Aktualisierung läuft: Volume wird geklont.

  9. Aktualisierung läuft: Writer wird aktualisiert.

  10. Aktualisierung läuft: Lesegeräte werden aktualisiert.

  11. Die Hauptversion der Datenbank-Cluster-Engine wurde aktualisiert.

Ereignisse werden in der Konsole auf der Seite Ereignisse angezeigt:

Bild: Das Navigationsfeld „Ereignisse“ mit einer Tabelle mit Upgrade-Ereignissen.

Von der aus können Sie ausführen AWS CLI, aws docdb describe-eventsum den Upgrade-Fortschritt zu überwachen. Um Benachrichtigungen automatisch zu erhalten, abonnieren Sie Ereignisse und leiten Sie sie für E-Mails, Push-Nachrichten oder andere Versandmethoden an Amazon SNS weiter. aws docdb create-event-subscription Weitere Informationen finden Sie unter Amazon DocumentDB DocumentDB-Veranstaltungen abonnieren.

aws docdb describe-events 
  --source-identifier mydocdbcluster 
  --source-type db-cluster

Daraufhin erhalten Sie ein Ergebnis, das dem hier dargestellten entspricht:

{
    "Events": [
        {
            "SourceIdentifier": "mydocdbcluster",
            "SourceType": "db-cluster",
            "Message": "Database cluster engine version upgrade started.",
            "EventCategories": [
                "maintenance"
            ],
            "Date": "2023-07-11T23:20:32.444000+00:00",
            "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster"
        }
    ]
}

Nach dem Upgrade

Warnung

Unmittelbar nach dem direkten Upgrade der Hauptversion füllt Ihr Amazon DocumentDB-Cluster die Index-Metadaten erneut auf, die die Datenbank-Engine zur Optimierung von Abfrageausführungsplänen verwendet. Sobald dieser Vorgang abgeschlossen ist, kehrt die Abfrageleistung auf das erwartete Niveau zurück. Der Vorgang ist in der Regel in wenigen Minuten abgeschlossen, kann jedoch je nach Anzahl der Indizes in Ihrem Cluster bis zu zwei Stunden dauern.

Starten Sie up/down Ihre Writer-Instanz während dieser Zeit nicht neu, führen Sie kein Failover durch oder skalieren Sie sie nicht, da dies die Neuberechnung der Index-Metadaten stören kann. Wir empfehlen, zu warten, bis Sie die erwartete Abfrageleistung erreicht haben, bevor Sie solche Änderungen vornehmen.

Verfolgen Sie den Fortschritt anhand der folgenden Cluster-Ereignisse:

  • Post-upgrade Clusterstatus: Die Aktualisierung der Index-Metadaten wurde gestartet

  • Post-upgrade Clusterstatus: Die Aktualisierung der Index-Metadaten wurde in X Sekunden abgeschlossen

Wenden Sie sich an den AWS Support, wenn die Aktualisierung der Index-Metadaten nicht innerhalb von drei Stunden abgeschlossen wurde oder wenn nach Abschluss des Vorgangs weiterhin Leistungsprobleme auftreten.

  1. Erstellen Sie manuell einen Snapshot des aktualisierten Clusters für den Fall, dass Sie den Status nach dem Upgrade wiederherstellen müssen. Der automatische Snapshot-Vorgang wird fortgesetzt, sobald das direkte Upgrade der Hauptversion abgeschlossen ist.

  2. Tag-Cluster wurden von 3.6 aktualisiert. Fügen Sie ein Tag hinzu, um Cluster zu unterscheiden, für die Version 3.6 aktualisiert wurde. (siehePost-upgrade Überlegungen zu Clustern, die von 3.6 oder 4.0 aktualisiert wurden).

  3. Aktualisiere deinen Treiber. Um neue Funktionen zu verwenden (z. B. Sortierung, Ansichten oder Zstd-Komprimierung in 8.0), führen Sie ein Upgrade auf die entsprechende MongoDB-API-Version durch. Weitere Informationen finden Sie unter Was ist neu in Amazon DocumentDB 8.0.

  4. Testen Sie gründlich. Überprüfen Sie Ihre Anwendung anhand des aktualisierten Clusters.

Was ändert sich nach dem Upgrade von Amazon DocumentDB 5.0 auf 8.0

Nach einem Upgrade der Hauptversion von Amazon DocumentDB 5.0 auf 8.0 werden die folgenden Funktionen aktiviert oder geändert:

  • Sortierung. Amazon DocumentDB 8.0 unterstützt die Sortierung. Nach dem Upgrade ist die Sortierung für neue Sammlungen und deren Indizes sowie für neue Indizes vorhandener Sammlungen standardmäßig aktiviert.

  • Textindex. Neue Textindizes werden mit Text Index V2 erstellt, der einen aktualisierten Textsuchparser für eine verbesserte MongoDB-Kompatibilität verwendet. Bestehende Textindizes sind nicht betroffen.

  • Version des Abfrageplaners. Wenn Sie keine benutzerdefinierte Parametergruppe hatten, wird eine neue Standardparametergruppe für Amazon DocumentDB 8.0 erstellt, wobei Planner Version 3 automatisch ausgewählt ist. Mit Query Planner Version 3 sind auch Ansichten verfügbar.

  • Komprimierung. Amazon DocumentDB 8.0 unterstützt die wörterbuchbasierte Dokumentenkomprimierung mithilfe des Zstd-Algorithmus. Nach dem Upgrade werden neue Sammlungen mit standardmäßig aktivierter Zstd-Komprimierung erstellt. Bestehende Sammlungen aus Version 5.0 behalten ihre Komprimierungseinstellungen bei. Um die Vorteile der Zstd-Komprimierung für bestehende Sammlungen zu nutzen, können Sie deren Komprimierungseinstellungen ändern. Weitere Informationen finden Sie unter Dictionary-based Komprimierung.

  • Neuerstellung des Index. Wenn Sie ein Upgrade von Amazon DocumentDB 5.0 auf Amazon DocumentDB 8.0 durchführen, ist keine Indexneuerstellung erforderlich.

Anmerkung

Eine vollständige Liste der funktionalen Unterschiede finden Sie unter. Amazon DocumentDB DocumentDB-Kompatibilität mit MongoDB

Post-upgrade Überlegungen zu Clustern, die von 3.6 oder 4.0 aktualisiert wurden

  • Neuerstellung des Index. Eine MVU behält die ursprünglichen Indizes bei. Amazon DocumentDB 5.0 hat die Indexverwaltung und die Garbage-Collection verbessert, insbesondere für Indizes mit niedriger Kardinalität. Nach dem Upgrade von 3.6 oder 4.0 empfehlen wir, Ihre Indizes neu zu erstellen, um eine optimale Abfrageleistung zu gewährleisten (optional, erfordert zusätzliche Gebühren). I/O Siehe Indexverwaltung mit reIndex.

  • Numerischer Vergleich von Unterdokumenten (nur 3.6). Cluster, die von 3.6 aktualisiert wurden, übernehmen das Verhalten von 3.6, bei dem numerische Typen in Unterdokumenten nicht typübergreifend verglichen werden. {a: {b: NumberLong(1)}}Entspricht beispielsweise {a: {b: 1}} in 3.6 nicht, aber sie sind in 4.0 und höher gleich. Dieses Verhalten wirkt sich auf alle Cluster aus, die von 3.6 aktualisiert wurden.

Das Upgrade wird durchgeführt

Using the AWS-Managementkonsole

  1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an AWS-Managementkonsoleund öffnen Sie sie.

  2. Wählen Sie in der Cluster-Tabelle den Quell-Cluster aus, klicken Sie auf Aktionen und dann auf Ändern.

    Bild: Das Cluster-Navigationsfeld mit einer Liste vorhandener Cluster-Links und der entsprechenden Instance-Links.

  3. Wählen Sie in den Clusterspezifikationen die Zielversion (z. B. 5.0.0 oder 8.0.0) aus der Dropdownliste Engine-Version aus.

    Bild: Der Abschnitt Clusterspezifikationen im Dialogfeld „Cluster ändern“, in dem die Felder Cluster-ID und Engine-Version angezeigt werden.

  4. Wählen Sie unter Clusteroptionen Ihre Cluster-Parametergruppe für die Ziel-Engine-Version aus. Sie können den Standard (z. B. default.docdb5.0 oder default.docdb8.0) oder eine benutzerdefinierte Parametergruppe verwenden, die Sie erstellt haben.

    Bild: Der Abschnitt Cluster-Optionen im Dialogfeld Cluster ändern zeigt das Feld Cluster-Parametergruppe.

  5. Wählen Sie Weiter, wählen Sie Ihre bevorzugte Zeitplanung (sofort anwenden oder nächstes Wartungsfenster) und wählen Sie dann Cluster modifizieren.

    Bild: Das Dialogfeld „Cluster ändern“ mit einer Zusammenfassung und dem Zeitplan der Änderungen für den ausgewählten Cluster.

  6. Überwachen Sie den Clusterstatus in der Cluster-Tabelle, wenn er sich beim Upgrade ändert:

    Bild: Das Cluster-Navigationsfeld hebt die Statusspalte für den Cluster hervor, der gerade aktualisiert wird.
Using the AWS CLI

modify-db-clusterMit der --allow-major-version-upgrade Flagge verwenden:

aws docdb modify-db-cluster \
  ‐‐db-cluster-identifier mydocdbcluster \
  ‐‐allow-major-version-upgrade \
  ‐‐engine-version 8.0.0 \
  ‐‐apply-immediately \
  ‐‐cluster-parameter-group mydocdbparametergroup \
  ‐‐region us-east-1

Ersetzen Sie jedes placeholder durch die Informationen Ihres Clusters.

Fehlerbehebung

  • Upgrade-Fehler und Rollback. Wenn das Upgrade fehlschlägt, wird automatisch versucht, ein Rollback durchzuführen. Ein erfolgreicher Rollback generiert das Ereignis: „Der Datenbank-Cluster befindet sich in einem Zustand, der nicht aktualisiert werden kann.“ Ihr Cluster kehrt in den Zustand vor dem Upgrade zurück und Sie können ihn weiter verwenden. Wenden Sie sich zur Problembehebung an den AWS Support, bevor Sie es erneut versuchen.

  • Post-upgrade Leistung. Während der Aktualisierung der Index-Metadaten können vorübergehende Leistungseinbußen und eine hohe CPU-Auslastung auftreten. Wenn die Leistungsminderung länger als 3 Stunden anhält, wenden Sie sich an den AWS Support.

Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an den AWS Support.