Upgrade verze rozhraní API účtu služby Azure Cosmos DB pro MongoDB

PLATÍ PRO: MongoDB

Tento článek popisuje, jak upgradovat verzi rozhraní API účtu rozhraní API služby Azure Cosmos DB pro MongoDB. Po upgradu můžete použít nejnovější funkce v rozhraní API služby Azure Cosmos DB pro MongoDB. Proces upgradu nepřeruší dostupnost vašeho účtu a nebude spotřebovávat RU/s ani snižovat kapacitu databáze v jakémkoli okamžiku. Tento proces nemá vliv na existující data ani indexy.

Při upgradu na novou verzi rozhraní API začněte s úlohami vývoje a testování před upgradem produkčních úloh. Před upgradem účtu Azure Cosmos DB pro MongoDB je důležité upgradovat klienty na verzi kompatibilní s verzí rozhraní API, na kterou upgradujete.

Upozorňující

V tuto chvíli je možné upgradovat pouze opravňující účty používající server verze 3.2 na verzi 3.6 a vyšší. Pokud váš účet možnost upgradu nezobrazuje, vytvořte lístek podpory.

Upgrade verze

1. Přihlaste se k webu Azure Portal.

2. Přejděte ke svému účtu Služby Azure Cosmos DB pro MongoDB. Otevřete podokno Přehled a ověřte, že aktuální verze serveru je 3.2 nebo 3.6.

   

3. V nabídce vlevo otevřete Features podokno. Toto podokno zobrazuje funkce na úrovni účtu, které jsou dostupné pro váš databázový účet.

4. Vyberte řádek Upgrade MongoDB server version. Pokud tuto možnost nevidíte, váš účet pravděpodobně nemá na tento upgrade nárok. Pokud tomu tak je, vytvořte lístek podpory.

   

5. Projděte si zobrazené informace o upgradu. Vyberte Set server version to 4.2 (nebo 4.0 nebo 3.6 v závislosti na vaší aktuální verzi).

   

6. Po spuštění upgradu se nabídka Funkce zobrazí šedě a stav je nastavený na Čeká na vyřízení. Dokončení upgradu trvá přibližně 15 minut. Tento proces nemá vliv na stávající funkce ani operace vašeho databázového účtu. Po dokončení se ve stavu aktualizace verze serveru MongoDB zobrazí upgradovaná verze. Pokud došlo k problému se zpracováním vaší žádosti, obraťte se na podporu .

7. Po upgradu účtu je potřeba vzít v úvahu následující skutečnosti:

   1. Pokud jste upgradovali z verze 3.2, vraťte se do podokna Přehled a zkopírujte nový připojovací řetězec, který použijete ve své aplikaci. Stará připojovací řetězec spuštěná verze 3.2 se nepřeruší. Pokud chcete zajistit konzistentní prostředí, musí všechny vaše aplikace používat nový koncový bod.

   2. Pokud jste upgradovali z verze 3.6, stávající připojovací řetězec se upgraduje na zadanou verzi a měla by se dál používat.

Důležité

Při upgradu z verze 3.2 se přípona koncového bodu databázového účtu aktualizuje na následující formát: <your_database_account_name>.mongo.cosmos.azure.com. Tento koncový bod může mít mírné rozdíly v případě, že byl váš účet vytvořen v suverénním cloudu, cloudu pro státní správu nebo v omezeném cloudu Azure.

Pokud upgradujete z verze 3.2, budete muset nahradit existující koncový bod ve vašich aplikacích a ovladačích, které se připojují k tomuto databázovému účtu. K funkcím v nové verzi rozhraní API budou mít přístup pouze připojení, která používají nový koncový bod. Předchozí koncový bod verze 3.2 by měl mít příponu .documents.azure.com. Při upgradu z verze 3.2 na novější verze jsou teď složené indexy nutné k provádění operací řazení na více polích, aby se zajistil stabilní a vysoký výkon těchto dotazů. Ujistěte se, že jsou tyto složené indexy vytvořeny tak, aby řazení s více poli proběhlo úspěšně.

Downgrade verze

Svůj účet můžete také downgradovat na verzi 4.0 nebo 3.6 stejným postupem v části upgrade verze .

1. Pokud jste upgradovali z verze 3.2 na verzi 3.2 a chcete downgradovat zpět na verzi 3.2, přepněte zpět na předchozí připojovací řetězec (3.2) s hostitelemaccountname.documents.azure.com, který zůstává aktivní po upgradu verze 3.2.

2. Změňte připojovací řetězec v aplikaci.

Související obsah

• Funkce MongoDB verze 6.0
• Funkce MongoDB verze 5.0
• Funkce MongoDB verze 4.2
• Funkce MongoDB verze 4.0
• Funkce MongoDB verze 3.6
• Historie verzí MongoDB