Megosztás:

Az alkalmazás migrálása az Azure Cosmos DB .NET SDK v2 használatára

  • Alkalmazandó: ✅ NoSQL

Fontos

Fontos megjegyezni, hogy a .NET SDK v3-a jelenleg elérhető, és itt érhető el egy migrálási terv a v2-ről a v3-ra. Az Azure Cosmos DB .NET SDK 2-es verziójának megismeréséhez tekintse meg a kibocsátási megjegyzéseket, a .NET GitHub-adattárat, a .NET SDK v2 teljesítménytippeket és a hibaelhárítási útmutatót.

Ez a cikk néhány szempontot emel ki a meglévő v1 .NET-alkalmazás Azure Cosmos DB .NET SDK v2 for API for NoSQL-re való frissítéséhez. Az Azure Cosmos DB .NET SDK v2 a Microsoft.Azure.DocumentDB névtérnek felel meg. A dokumentumban megadott információk akkor használhatók, ha az alkalmazást az alábbi Azure Cosmos DB .NET-platformok bármelyikéről migrálja a v2 SDK Microsoft.Azure.Cosmoshasználatára:

  • Azure Cosmos DB .NET-keretrendszer v1 SDK NoSQL API-hoz
  • Azure Cosmos DB .NET Core SDK v1 NoSQL API-hoz

A .NET v2 SDK-ban elérhető lehetőségek

A v2 SDK számos használhatósági és teljesítménybeli fejlesztést tartalmaz, többek között a következőket:

  • Közvetlen TCP-mód támogatása nem Windows rendszerű ügyfelek esetén
  • Többrégiós írás támogatása
  • Fejlesztések a lekérdezési teljesítmény terén
  • Térinformatikai/geometriai gyűjtemények és indexelés támogatása
  • A közvetlen/TCP-átvitel diagnosztikáinak továbbfejlesztése
  • A közvetlen TCP-átviteli verem frissítései a létrehozott kapcsolatok számának csökkentése érdekében
  • Fejlesztések a késés csökkentésében a RequestTimeout-ban

Az újrapróbálkozás logikájának és az SDK alacsonyabb szintjeinek többsége nagyrészt változatlan marad.

Miért migrálható a .NET v2 SDK-ra?

A számos teljesítménybeli fejlesztés mellett a legújabb SDK-ban végrehajtott új funkcióberuházások nem lesznek visszahordva a régebbi verziókra.

Emellett a régebbi SDK-k lecserélődnek az újabb verziókra, és a v1 SDK karbantartási módba kerül. A legjobb fejlesztési élmény érdekében javasoljuk, hogy migrálja az alkalmazást az SDK egy későbbi verziójára.

A v1 SDK-ról a v2 SDK-ra történő főbb változások

Közvetlen mód + TCP

A .NET v2 SDK mostantól a közvetlen és az átjáró módot is támogatja. A közvetlen mód támogatja a TCP protokollon keresztüli kapcsolatot, és jobb teljesítményt nyújt, mivel kevesebb hálózati ugrással közvetlenül csatlakozik a háttérreplikákhoz.

További részletekért olvassa el az Azure Cosmos DB SQL SDK csatlakozási módokkal kapcsolatos útmutatóját.

Munkamenet token formázása

A v2 SDK már nem a v1-ben használt egyszerű munkamenet-jogkivonat-formátumot használja, hanem az SDK vektoros formázást használ. A formátumot konvertálni kell, amikor különböző verziókkal továbbítja az ügyfélalkalmazásnak, mivel a formátumok nem cserélhetők fel.

További információ: munkamenet-jogkivonat-formátumok konvertálása a .NET SDK-ban.

A .NET változáscsatorna-feldolgozó SDK használata

A .NET változáscsatorna processzortár 2.1.x-hez 2.0-s vagy újabb verzióra van szükség Microsoft.Azure.DocumentDB .

A 2.1.x kódtár a következő főbb módosításokat tartalmazza:

  • Stabilitási és diagnosztabilitási fejlesztések
  • A hibák és kivételek hatékonyabb kezelése
  • Particionált bérletgyűjtemények további támogatása
  • Speciális bővítmények az interfész és az ChangeFeedDocument osztály implementálásához további hibakezeléshez és nyomkövetéshez
  • Támogatott az egyéni tároló használata a folytatási jogkivonatok partíciónkénti megőrzéséhez

További információkért tekintse meg a változásfigyelő futtatókörnyezet kiadási megjegyzéseit.

Nagy mennyiségű végrehajtó könyvtár használata

A v2-beli tömeges végrehajtói kódtár jelenleg az Azure Cosmos DB .NET SDK 2.5.1-s vagy újabb verziójától függ.

További információkért tekintse meg az Azure Cosmos DB tömeges végrehajtói kódtárának áttekintését és a .NET tömeges végrehajtói kódtár kibocsátási megjegyzéseit.

Következő lépések

  • További teljesítmény-javítási tippek az Azure Cosmos DB for API for NoSQL v2 használatával az alkalmazás maximális teljesítményének elérése érdekében történt optimalizálásához
  • Kapacitástervezést szeretne végezni az Azure Cosmos DB-be való migráláshoz?
  • Last updated on