Az Azure Cosmos DB for MongoDB-fiók API-verziójának frissítése

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: MongoDB

Ez a cikk azt ismerteti, hogyan frissítheti az Azure Cosmos DB Api for MongoDB-fiókjának API-verzióját. A frissítés után az Azure Cosmos DB MongoDB-hez készült API-jának legújabb funkcióit használhatja. A frissítési folyamat nem szakítja meg a fiók rendelkezésre állását, és nem használ ru/s-t, és nem csökkenti az adatbázis kapacitását. Ez a folyamat nem érinti a meglévő adatokat vagy indexeket.

Amikor új API-verzióra frissít, az éles számítási feladatok frissítése előtt kezdje a fejlesztési/tesztelési számítási feladatokkal. Az Azure Cosmos DB for MongoDB-fiók frissítése előtt fontos, hogy az ügyfeleket a frissítendő API-verzióval kompatibilis verzióra frissítse.

Megjegyzés

Jelenleg csak a kiszolgáló 3.2-es verzióját használó jogosult fiókok frissíthetők a 3.6-os vagy újabb verzióra. Ha a fiókja nem jeleníti meg a frissítési lehetőséget, küldjön egy támogatási jegyet.

Frissítés 4.2-re, 4.0-ra vagy 3.6-ra

A 4.2-es verzióra való frissítés előnyei:

  • Az aggregációs folyamat számos jelentős fejlesztése, például a $mergetrigonometria, az aritmetikai kifejezések stb. támogatása.
  • Az ügyféloldali mező-encikció támogatása, amely tovább védi az adatbázist azáltal, hogy lehetővé teszi az egyes mezők szelektív titkosítását, valamint a titkosított adatok adatvédelmének fenntartását az adatbázis-felhasználóktól és a szolgáltatótól.

A 4.0-s verzióra való frissítés előnyei

A 4.0-s verzió új funkciói a következők:

  • Többdokumentumos tranzakciók támogatása a nem horizontális gyűjteményeken belül.
  • Új aggregációs operátorok
  • Jobb vizsgálati teljesítmény
  • Gyorsabb, hatékonyabb tárolás

A 3.6-os verzióra való frissítés előnyei

A 3.6-os verzió új funkciói a következők:

  • Jobb teljesítmény és stabilitás
  • Új adatbázisparancsok támogatása
  • Összesítési folyamat támogatása alapértelmezés szerint és új összesítési szakaszok
  • Streamek módosításának támogatása
  • Összetett indexek támogatása
  • Több partícióra kiterjedő támogatás a következő műveletekhez: frissítés, törlés, darabszám és rendezés
  • Jobb teljesítmény a következő összesítési műveletek esetében: $count, $skip, $limit és $group
  • Mostantól támogatott a helyettesítő karakterek indexelése

Változások a 3.2-es verzióhoz képest

  • A kiszolgálóoldali újrapróbálkozás (SSR) funkció alapértelmezés szerint engedélyezve van, így az ügyfélalkalmazásból érkező kérések nem adnak vissza 16500-as hibát. Ehelyett a kérelmek addig folytatódnak, amíg befejeződnek vagy túllépik a 60 másodperces időkorlátot.
  • Az egyes kérések időkorlátja 60 másodperc.
  • Az új vonalprotokoll-verzióval létrehozott MongoDB-gyűjteményekhez alapértelmezés szerint csak az _id tulajdonság lesz indexelve.

Beavatkozás szükséges a 3.2-es verzióról való frissítéskor

A 3.2-es verzióról való frissítéskor az adatbázisfiók-végpont utótagja a következő formátumra lesz frissítve:

<your_database_account_name>.mongo.cosmos.azure.com

Ha a 3.2-es verzióról frissít, le kell cserélnie az adatbázisfiókhoz csatlakozó alkalmazások és illesztőprogramok meglévő végpontját. Csak az új végpontot használó kapcsolatoknak lesz hozzáférésük az API új verziójának funkcióihoz. A korábbi, 3.2-es verziójú végpontnak a következő utótaggal kell rendelkeznie: .documents.azure.com.

A 3.2-ről újabb verziókra való frissítéskor összetett indexekre van szükség a rendezési műveletek több mezőn való végrehajtásához, hogy ezek a lekérdezések stabil és magas teljesítményt biztosítsanak. Győződjön meg arról, hogy ezek az összetett indexek létre lettek hozva, hogy a többmezős rendezés sikeres legyen.

Megjegyzés

Ennek a végpontnak kisebb eltérései lehetnek, ha a fiókja szuverén, kormányzati vagy korlátozott Azure-felhőben lett létrehozva.

A frissítés lépései

  1. Jelentkezzen be a Azure Portal.

  2. Lépjen a MongoDB-hez készült Azure Cosmos DB-fiókjához. Nyissa meg az Áttekintés panelt, és ellenőrizze, hogy a kiszolgáló jelenlegi verziója 3.2-es vagy 3.6-os-e.

    Ellenőrizze a MongoDB-fiók aktuális verzióját a Azure Portal.

  3. A bal oldali menüben nyissa meg a panelt Features . Ez az ablaktábla az adatbázisfiókhoz elérhető fiókszintű funkciókat jeleníti meg.

  4. Válassza ki a következő sort: Upgrade MongoDB server version. Ha nem jelenik meg ez a lehetőség, előfordulhat, hogy a fiók nem jogosult erre a frissítésre. Ha ez a helyzet, küldjön támogatási jegyet .

    Nyissa meg a Szolgáltatások panelt, és frissítse a fiókját.

  5. Tekintse át a frissítéssel kapcsolatban megjelenő információkat. Válassza a Set server version to 4.2 (vagy a 4.0-s vagy a 3.6-os verziót az aktuális verziótól függően).

    Tekintse át a frissítési útmutatót, és válassza a frissítés lehetőséget.

  6. A frissítés elindítása után a Funkció menü szürkével, az állapot pedig Függőben értékre van állítva. A frissítés körülbelül 15 percet vesz igénybe. Ez a folyamat nem befolyásolja az adatbázisfiók meglévő funkcióit vagy műveleteit. A művelet befejezése után a MongoDB-kiszolgáló verziófrissítési állapota megjeleníti a frissített verziót. Ha probléma merült fel a kérés feldolgozása során, forduljon az ügyfélszolgálathoz .

  7. A fiók frissítése után az alábbi szempontokat érdemes figyelembe venni:

    1. Ha a 3.2-ről frissített, lépjen vissza az Áttekintés panelre, és másolja az új kapcsolati sztring az alkalmazásban való használathoz. A korábbi, 3.2-es verziójú kapcsolati sztring nem szakad meg. A konzisztens felhasználói élmény érdekében az összes alkalmazásnak az új végpontot kell használnia.

    2. Ha a 3.6-os verzióról frissített, a meglévő kapcsolati sztring a megadott verzióra lesz frissítve, és továbbra is ezt kell használni.

Váltás korábbi verzióra

A "Hogyan frissíthető" szakaszban ismertetett lépésekkel a fiókját a 4.0-s vagy a 3.6-os verzióra is visszaminősítheti.

Ha a 3.2-es verzióról frissített, és vissza szeretne térni a 3.2-es verzióra, egyszerűen visszaválthat az előző (3.2) kapcsolati sztring használatára a 3.2-es verziót futtató gazdagépenaccountname.documents.azure.com.

Következő lépések