Delen via

De API-versie van uw Azure Cosmos DB voor MongoDB-account upgraden

  • Artikel

VAN TOEPASSING OP: MongoDB

In dit artikel wordt beschreven hoe u de API-versie van de API van uw Azure Cosmos DB voor MongoDB-account kunt upgraden. Na uw upgrade kunt u de nieuwste functionaliteit gebruiken in de API van Azure Cosmos DB voor MongoDB. Het upgradeproces onderbreekt de beschikbaarheid van uw account niet en verbruikt geen RU/s of verlaagt de capaciteit van de database op enig moment. Dit proces heeft geen invloed op bestaande gegevens of indexen.

Wanneer u een upgrade uitvoert naar een nieuwe API-versie, begint u met ontwikkel-/testworkloads voordat u productieworkloads bijwerkt. Het is belangrijk om uw clients te upgraden naar een versie die compatibel is met de API-versie waarnaar u een upgrade uitvoert voordat u uw Azure Cosmos DB voor MongoDB-account bijwerken.

Waarschuwing

Op dit moment kunnen alleen in aanmerking komende accounts met serverversie 3.2 worden geüpgraded naar versie 3.6 en hoger. Als uw account de upgradeoptie niet weergeeft, dient u een ondersteuningsticket in.

Uw versie upgraden

  1. Meld u aan bij de Azure Portal.

  2. Navigeer naar uw Azure Cosmos DB voor MongoDB-account. Open het deelvenster Overzicht en controleer of uw huidige serverversie 3.2 of 3.6 is.

    Schermopname van het controleren van de huidige versie van uw MongoDB-account vanuit Azure Portal.

  3. Open het deelvenster in het Features linkermenu. In dit deelvenster ziet u de functies op accountniveau die beschikbaar zijn voor uw databaseaccount.

  4. Selecteer rij Upgrade MongoDB server version. Als u deze optie niet ziet, komt uw account mogelijk niet in aanmerking voor deze upgrade. Dien een ondersteuningsticket in als dat het geval is.

    Schermopname van de pagina met functies om uw account bij te werken.

  5. Bekijk de informatie die over de upgrade wordt weergegeven. Selecteer Set server version to 4.2 (of 4.0 of 3.6, afhankelijk van uw huidige versie).

    Schermopname van de upgraderichtlijnen en de optie upgrade selecteren.

  6. Nadat u de upgrade hebt gestart, wordt het menu Functie grijs weergegeven en wordt de status ingesteld op In behandeling. Het uitvoeren van de upgrade duurt ongeveer 15 minuten. Dit proces heeft geen invloed op de bestaande functionaliteit of bewerkingen van uw databaseaccount. Nadat deze is voltooid, wordt de bijgewerkte versie weergegeven in de status van de mongoDB-serverversie bijwerken. Neem contact op met de ondersteuning als er een probleem is opgetreden bij het verwerken van uw aanvraag.

  7. Hieronder volgen enkele overwegingen na het upgraden van uw account:

    1. Als u een upgrade hebt uitgevoerd van versie 32, gaat u terug naar de paneel Overzicht en kopieert u de nieuwe verbindingsreeks voor gebruik in uw toepassing. De oude verbindingsreeks waarop 3.2 wordt uitgevoerd, wordt niet onderbroken. Voor een consistente ervaring moeten al uw toepassingen gebruikmaken van het nieuwe eindpunt.

    2. Als u een upgrade hebt uitgevoerd van 3.6, wordt uw bestaande verbindingsreeks bijgewerkt naar de opgegeven versie en moet deze blijven worden gebruikt.

Belangrijk

Wanneer u een upgrade uitvoert van 3.2, wordt het achtervoegsel van het eindpunt van het databaseaccount bijgewerkt naar de volgende indeling: <your_database_account_name>.mongo.cosmos.azure.com. Dit eindpunt kan kleine verschillen hebben als uw account is gemaakt in een onafhankelijke, overheids- of beperkte Azure-cloud.

Als u een upgrade uitvoert van versie 3.2, moet u het bestaande eindpunt in uw toepassingen en stuurprogramma's vervangen die verbinding maken met dit databaseaccount. Alleen verbindingen die het nieuwe eindpunt gebruiken, hebben toegang tot de functies in de nieuwe API-versie. Het vorige 3.2-eindpunt moet het achtervoegsel .documents.azure.com bevatten. Wanneer u een upgrade uitvoert van 3.2 naar nieuwere versies, moeten samengestelde indexen nu sorteerbewerkingen uitvoeren op meerdere velden om stabiele, hoge prestaties voor deze query's te garanderen. Zorg ervoor dat deze samengestelde indexen worden gemaakt, zodat de sorteringen voor meerdere velden slagen.

Uw versie downgraden

U kunt uw account ook downgraden naar 4.0 of 3.6 via dezelfde stappen in de upgrade van uw versiesectie .

  1. Als u een upgrade hebt uitgevoerd van 3.2 naar en u wilt downgraden naar 3.2, gaat u terug naar het gebruik van uw vorige (3.2) verbindingsreeks met de hostaccountname.documents.azure.com, die actief blijft na de upgrade met versie 3.2.

  2. Wijzig de verbindingsreeks in uw toepassing.

Gerelateerde inhoud