Upgrade der API-Version Ihres Azure Cosmos DB for MongoDB-Kontos

GILT FÜR: MongoDB

In diesem Artikel wird beschrieben, wie Sie ein Upgrade der API-Version Ihrer Azure Cosmos DB-API für das MongoDB-Konto durchführen. Nach dem Upgrade können Sie die neuesten Funktionen in der Azure Cosmos DB-API für MongoDB verwenden. Der Upgradeprozess unterbricht die Verfügbarkeit Ihres Kontos nicht und verbraucht zu keinem Zeitpunkt RU/s oder verringert die Kapazität der Datenbank. Dieser Prozess wirkt sich nicht auf vorhandene Daten oder Indizes aus.

Beim Upgrade auf eine neue API-Version beginnen Sie mit den Entwicklungs-/Testworkloads, bevor Sie ein Upgrade der Produktionsworkloads durchführen. Es ist wichtig, ein Upgrade Ihrer Clients auf eine Version durchzuführen, die mit der für das Upgrade angestrebten API-Version kompatibel ist, bevor Sie das Upgrade Ihres Azure Cosmos DB for MongoDB-Kontos ausführen.

Hinweis

Derzeit kann nur für qualifizierende Konten mit Verwendung von Serverversion 3.2 ein Upgrade auf Version 3.6 oder höher durchgeführt werden. Wenn Ihr Konto die Upgradeoption nicht anzeigt, erstellen Sie ein Supportticket.

Upgrade auf Version 4.2, 4.0 oder 3.6

Vorteile des Upgrades auf Version 4.2:

  • Verschiedene wichtige Verbesserungen an der Aggregationspipeline wie beispielsweise die Unterstützung für $merge, Trigonometrie, arithmetische Ausdrücke und mehr.
  • Unterstützung für die clientseitige Feldverschlüsselung zur weiteren Absicherung Ihrer Datenbank. Dies ermöglicht es, einzelne Felder selektiv zu verschlüsseln und die verschlüsselten Daten vor dem Zugriff durch Datenbanknutzer und Hostinganbieter zu schützen.

Vorteile des Upgrades auf Version 4.0

Die folgenden neuen Features sind in Version 4.0 enthalten:

  • Unterstützung für Transaktionen mit mehreren Dokumenten in Sammlungen ohne Shards
  • Neue Aggregationsoperatoren
  • Verbesserte Leistung bei Überprüfungen
  • Schnellerer, effizienterer Speicher

Vorteile des Upgrades auf Version 3.6

Die folgenden neuen Features sind in Version 3.6 enthalten:

  • Verbesserte Leistung und Stabilität
  • Unterstützung für neue Datenbankbefehle
  • Standardunterstützung für Aggregationspipeline und neue Aggregationsphasen
  • Unterstützung für das Ändern von Datenströmen
  • Unterstützung für zusammengesetzte Indizes
  • Partitionsübergreifende Unterstützung für die folgenden Vorgänge: Aktualisieren, Löschen, Zählen und Sortieren
  • Verbesserte Leistung für die folgenden zusammengesetzten Operationen: „$count“, „$skip“, „$limit“ und „$group“
  • Platzhalterindizierung wird jetzt unterstützt

Änderungen gegenüber Version 3.2

  • Das Feature für die serverseitige Wiederholung (Server-Side Retry, SSR) ist standardmäßig aktiviert, sodass Anforderungen von der Clientanwendung keine 16500-Fehler zurückgeben. Stattdessen werden Anforderungen so lange fortgesetzt, bis sie abgeschlossen sind oder das Zeitlimit von 60 Sekunden erreicht wird.
  • Das Pro-Anforderungstimeout ist auf 60 Sekunden festgelegt.
  • Bei MongoDB-Sammlungen, die in der neuen Wire Protocol-Version erstellt wurden, wird nur die Eigenschaft _id standardmäßig indiziert.

Erforderliche Aktion beim Upgrade von 3.2

Beim Upgrade von 3.2 wird das Endpunktsuffix des Datenbankkontos auf das folgende Format aktualisiert:

<your_database_account_name>.mongo.cosmos.azure.com

Beim Upgrade von Version 3.2 müssen Sie den vorhandenen Endpunkt in Ihren Anwendungen und Treibern ersetzen, die eine Verbindung mit diesem Datenbankkonto herstellen. Nur Verbindungen, die den neuen Endpunkt verwenden, können auf die Features in der neuen API-Version zugreifen. Der vorherige 3.2-Endpunkt sollte das Suffix .documents.azure.com haben.

Beim Upgrade von 3.2 auf neuere Versionen sind jetzt zusammengesetzte Indizes erforderlich, um Sortiervorgänge für mehrere Felder durchzuführen, um eine stabile, hohe Leistung für diese Abfragen sicherzustellen. Stellen Sie sicher, dass diese zusammengesetzten Indizes erstellt werden, damit die Sortierungen für mehrere Felde erfolgreich sind.

Hinweis

Dieser Endpunkt weist möglicherweise geringfügige Unterschiede auf, wenn Ihr Konto in einer unabhängigen, behördlichen oder eingeschränkten Azure-Cloud erstellt wurde.

Ausführen eines Upgrades

  1. Melden Sie sich beim Azure-Portal an.

  2. Navigieren Sie zu Ihrem Azure Cosmos DB for MongoDB-Konto. Öffnen Sie den Bereich Übersicht und überprüfen Sie, ob die aktuelle Serverversion 3.2 or 3.6 ist.

    Überprüfen Sie die aktuelle Version Ihres MongoDB-Kontos im Azure-Portal.

  3. Öffnen Sie im Menü auf der linken Seite den Bereich Features. Dieser Bereich zeigt die Features auf Kontoebene an, die für Ihr Datenbankkonto zur Verfügung stehen.

  4. Wählen Sie die Zeile Upgrade MongoDB server version aus. Wenn diese Option nicht angezeigt wird, ist Ihr Konto für dieses Upgrade möglicherweise nicht qualifiziert. Wenn das zutrifft, erstellen Sie ein Supportticket.

    Öffnen Sie das Blatt „Features“, und aktualisieren Sie Ihr Konto.

  5. Überprüfen Sie die für das Upgrade angezeigten Informationen. Wählen Sie Set server version to 4.2 (oder je nach aktueller Version 4.0 oder 3.6) aus.

    Befolgen Sie den Upgradeleitfaden, und wählen Sie „Upgrade“ aus.

  6. Nachdem Sie das Upgrade gestartet haben, ist das Feature-Menü abgeblendet, und der Status wird auf Ausstehend gesetzt. Für das Upgrade werden etwa 15 Minuten benötigt. Dieser Prozess wirkt sich nicht auf die vorhandenen Funktionen oder Vorgänge Ihres Datenbankkontos aus. Nach Abschluss des Vorgangs wird im Status Aktualisieren der MongoDB-Serverversion die aktualisierte Version angezeigt. Wenn beim Verarbeiten Ihrer Anforderung ein Problem aufgetreten ist, wenden Sie sich an den Support.

  7. Nach dem Upgrade Ihres Kontos sind einige Überlegungen zu beachten:

    1. Wenn Sie ein Upgrade von 3.2 durchgeführt haben, kehren Sie zum Bereich Übersicht zurück, und kopieren Sie die neue Verbindungszeichenfolge für die Verwendung in Ihrer Anwendung. Die alte Verbindungszeichenfolge, mit der 3.2 ausgeführt wird, wird nicht unterbrochen. Zur Gewährleistung eines konsistenten Verhaltens müssen alle Ihre Anwendungen den neuen Endpunkt verwenden.

    2. Wenn Sie ein Upgrade von 3.6 durchgeführt haben, wird die vorhandene Verbindungszeichenfolge auf die angegebene Version aktualisiert und sollte weiterhin verwendet werden.

Ausführen eines Downgrades

Sie können Ihr Konto auch auf Version 4.0 oder 3.6 herabstufen, indem Sie die gleichen Schritte wie im Abschnitt „Ausführen eines Upgrades“ ausführen.

Wenn Sie ein Upgrade von Version 3.2 durchgeführt haben und nun ein Downgrade zurück auf Version 3.2 vornehmen möchten, können Sie einfach mit dem Host accountname.documents.azure.com, auf dem Version 3.2 auch nach dem Upgrade aktiv bleibt, zurück zur vorherigen Verbindungszeichenfolge (3.2) wechseln.

Nächste Schritte