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

  • Článek

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žívat nejnovější funkce v rozhraní API služby Azure Cosmos DB pro MongoDB. Proces upgradu nenaruší dostupnost vašeho účtu a v žádném okamžiku nespotřebovávají RU/s ani nesníží kapacitu databáze. Tento proces nebude mít vliv na žádná existující data ani indexy.

Při upgradu na novou verzi rozhraní API začněte s vývojovými/testovacími úlohami a teprve potom upgradujte produkční úlohy. Před upgradem účtu Služby Azure Cosmos DB pro MongoDB je důležité upgradovat klienty na verzi kompatibilní s verzí rozhraní API, na kterou upgradujete.

Poznámka

V tuto chvíli je možné upgradovat na verzi 3.6 a vyšší jenom oprávněné účty, které používají server verze 3.2. Pokud se u vašeho účtu možnost upgradu nezobrazuje, vytvořte lístek podpory.

Upgrade na verzi 4.2, 4.0 nebo 3.6

Výhody upgradu na verzi 4.2:

  • Několik důležitých vylepšení kanálu agregace, jako je podpora , $mergeTrigonometrie, aritmetických výrazů a další.
  • Podpora encypce polí na straně klienta, která dále zabezpečuje databázi povolením selektivního šifrování jednotlivých polí a zachováním ochrany osobních údajů šifrovaných dat od uživatelů databáze a poskytovatelů hostingu.

Výhody upgradu na verzi 4.0

Následující nové funkce jsou součástí verze 4.0:

  • Podpora transakcí s více dokumenty v rámci nehardovaných kolekcí
  • Nové operátory agregace
  • Vylepšený výkon prohledávání
  • Rychlejší a efektivnější úložiště

Výhody upgradu na verzi 3.6

Následující nové funkce jsou součástí verze 3.6:

  • Vyšší výkon a stabilita
  • Podpora nových databázových příkazů
  • Výchozí podpora kanálu agregace a nové fáze agregace
  • Podpora streamů změn
  • Podpora složených indexů
  • Podpora následujících operací napříč oddíly: UPDATE, DELETE, COUNT a SORT
  • Vyšší výkon následujících agregačních operací: $count, $skip, $limit a $group
  • Nově se podporuje indexování se zástupnými znaky.

Změny od verze 3.2

  • Ve výchozím nastavení je povolená funkce opakování na straně serveru (SSR), požadavky z klientské aplikace tedy nebudou vracet chyby 16500. Místo toho budou požadavky pokračovat, dokud se nedokončí nebo dokud nedosáhnou časového limitu 60 sekund.
  • Časový limit jednotlivých požadavků je nastavený na 60 sekund.
  • U kolekcí MongoDB vytvořených pro novou verzi přenosového protokolu se bude ve výchozím nastavení indexovat pouze vlastnost _id.

Akce vyžadovaná při upgradu z verze 3.2

Při upgradu z verze 3.2 se přípona koncového bodu účtu databáze aktualizuje na následující formát:

<your_database_account_name>.mongo.cosmos.azure.com

Pokud upgradujete z verze 3.2, budete muset nahradit stávající koncový bod v 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 se teď k provádění operací řazení u více polí vyžadují složené indexy , aby se zajistil stabilní a vysoký výkon těchto dotazů. Ujistěte se, že jsou tyto složené indexy vytvořené tak, aby řazení s více poli bylo úspěšné.

Poznámka

Tento koncový bod se může mírně lišit, pokud byl váš účet vytvořen v suverénním cloudu, cloudu pro státní správu nebo v omezeném cloudu Azure.

Postup upgradu

  1. Přihlaste se k Azure Portal.

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

    Na Azure Portal zkontrolujte aktuální verzi účtu MongoDB.

  3. V nabídce vlevo otevřete Features podokno. V tomto podokně se zobrazují 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 je to tento případ, vytvořte lístek podpory .

    Otevřete okno Funkce a upgradujte svůj účet.

  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).

    Projděte si pokyny k upgradu a vyberte upgrade.

  6. Po spuštění upgradu se nabídka Funkce zobrazí šedě a stav se nastaví na Čeká na vyřízení. Dokončení upgradu trvá přibližně 15 minut. Tento proces neovlivní 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. Tady je několik aspektů, které je potřeba vzít v úvahu po upgradu účtu:

    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. Původní připojovací řetězec používaný ve verzi 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ěli byste ho dál používat.

Postup downgradu

Můžete také downgradovat svůj účet na verzi 4.0 nebo 3.6 stejným postupem v části Postup upgradu.

Pokud jste upgradovali z verze 3.2 na verzi a chcete downgradovat zpět na verzi 3.2, můžete jednoduše přepnout zpět na použití předchozího připojovacího řetězce (3.2) s hostitelem accountname.documents.azure.com , který po upgradu zůstane aktivní s verzí 3.2.

Další kroky