Spring Data Azure Cosmos DB v2 for API for NoSQL (örökölt): Kibocsátási megjegyzések és erőforrások

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

A Spring Data Azure Cosmos DB 2-es verziója a NoSQL-hez lehetővé teszi a fejlesztők számára az Azure Cosmos DB használatát Spring-alkalmazásokban. A Spring Data Azure Cosmos DB elérhetővé teszi a Spring Data felületet adatbázisok és gyűjtemények manipulálására, dokumentumok kezelésére és lekérdezések kiállítására. A Sync és az Async (Reaktív) API-k is támogatottak ugyanabban a Maven-összetevőben.

Figyelmeztetés

A Spring Data Azure Cosmos DB SDK ezen verziója az Azure Cosmos DB Java SDK kivezetett verziójától függ. A Spring Data Azure Cosmos DB SDK a közeljövőben megszűnik! Ez nem a legújabb Azure Spring Data Azure Cosmos DB SDK az Azure Cosmos DB-hez, és elavult. Az Azure Spring Data Azure Cosmos DB SDK V2 teljesítményproblémái és instabilitása miatt javasoljuk, hogy az Azure Spring Data Azure Cosmos DB v3-at használja a projekthez. A frissítéshez kövesse a Migrálás az Azure Cosmos DB Java SDK v4-be című útmutató utasításait a mögöttes Java SDK V4 különbségének megértéséhez.

A Spring Framework egy programozási és konfigurációs modell, amely leegyszerűsíti a Java-alkalmazások fejlesztését. A Spring függőségi injektálással egyszerűsíti az alkalmazások "vízvezeték-szerelését". Sok fejlesztő szereti a Springt, mert egyszerűbbé teszi az alkalmazások létrehozását és tesztelését. A Spring Boot a vízvezetékek kezelését a webalkalmazások és a mikroszolgáltatások fejlesztésének szemével bővíti. A Spring Data egy olyan programozási modell, amely egy Spring- vagy Spring Boot-alkalmazás környezetéből hozzáfér az olyan adattárakhoz, mint az Azure Cosmos DB.

Az Azure Spring Appsben üzemeltetett alkalmazásokban használhatja a Spring Data Azure Cosmos DB-t.

Fontos

Ezek a kibocsátási megjegyzések a Spring Data Azure Cosmos DB 2. verziójához tartoznak. A 3. verzió kibocsátási megjegyzéseit itt találja.

A Spring Data Azure Cosmos DB csak a NoSQL API-t támogatja.

A Spring Data más Azure Cosmos DB API-kkal kapcsolatos információit a következő cikkekben talál:

Szeretne gyorsan menni?

  1. Telepítse a minimálisan támogatott Java-futtatókörnyezetet (JDK 8), hogy az SDK-t használhassa.
  2. Hozzon létre egy Spring Data Azure Cosmos DB-alkalmazást a starter használatával. Könnyű!
  3. A Spring Data Azure Cosmos DB fejlesztői útmutatójában megismerheti az Azure Cosmos DB alapszintű kéréseit.

A Spring Boot Starter-alkalmazásokat gyorsan elindíthatja a Spring Initializr használatával!

Források

Erőforrás Hivatkozás
SDK letöltése Maven
API-dokumentáció A Spring Data Azure Cosmos DB referenciadokumentációja
Közreműködés az SDK-hoz Spring Data Azure Cosmos DB-adattár a GitHubon
Spring Boot Starter Azure Cosmos DB Spring Boot Starter ügyfélkódtár Java-hoz
Fejlesztői útmutató A Spring Data Azure Cosmos DB fejlesztői útmutatója
A Starter használata A Spring Boot Starter használata a NoSQL-hez készült Azure Cosmos DB-vel
GitHub-adattár az Azure Cosmos DB Spring Boot Starterhez
Minta Azure-alkalmazás szolgáltatással A Spring és az Azure Cosmos DB használata az App Service-vel Linuxon

Kiadási előzmény

2.3.0 (2020. május 21.)

Új funkciók

  • Frissítések Spring Boot-verziót a 2.3.0-ra.

2.2.5 (2020. május 19.)

Új funkciók

  • Frissítések Azure Cosmos DB-verziót a 3.7.3-ra.

Főbb hibajavítások

  • Memóriaszivárgási javításokat és Netty-verziófrissítéseket tartalmaz az Azure Cosmos DB SDK 3.7.3-ról.

2.2.4 (2020. április 6.)

Főbb hibajavítások

  • Kijavítja a jelölőtallowTelemetry, amely figyelembe veszi a jelölőt.CosmosDbConfig
  • Kijavítja a TTL tároló tulajdonságát.

2.2.3 (2020. február 25.)

Új funkciók

  • Új findAll partíciókulcs API-t ad hozzá.
  • Frissítések Azure Cosmos DB-verziót a 3.7.0-ra.

Főbb hibajavítások

  • Javítások collectionName –>containerName.
  • Javítások entityClass és domainClass ->domainType.
  • Kijavítja az "Adattár által mentett entitásgyűjtemény visszaadása bemeneti entitás helyett".

2.1.10 (2020. február 25.)

Főbb hibajavítások

  • Backports fix for "Return entity collection saved by repository instead input entity".

2.2.2 (2020. január 15.)

Új funkciók

  • Frissítések Azure Cosmos DB 3.6.0-s verzióra.

Főbb hibajavítások

2.2.1 (2019. december 31.)

Új funkciók

  • Frissítések Azure Cosmos DB SDK 3.5.0-s verzióra.
  • Széljegyzetmezőt ad hozzá az automatikus gyűjteménylétrehozás engedélyezéséhez vagy letiltásához.
  • Javítja a kivételkezelést. A következőn keresztül CosmosDBAccessExceptionteszi elérhetővé: CosmosClientException .
  • Elérhetővé teszi requestCharge és activityId keresztül ResponseDiagnostics.

Főbb hibajavítások

  • Az SDK 3.5.0 frissítés kijavítja a "Kivétel, ha az Azure Cosmos DB HTTP-válaszfejléce nagyobb, mint 8192 bájt", "ConsistencyPolicy.defaultConsistencyLevel() meghiúsul a határolt elavultság és a konzisztens előtag esetében."
  • Kijavítja a findById metódus viselkedését. Korábban ez a metódus üresen lett visszaadva, ha az entitás nem található ahelyett, hogy kivételt eredményezett volna.
  • Kijavít egy hibát, amely miatt a rendszer nem alkalmazta a rendezést a következő oldalon a használat során CosmosPageRequest .

2.1.9 (2019. december 26.)

Új funkciók

  • Széljegyzetmezőt ad hozzá az automatikus gyűjteménylétrehozás engedélyezéséhez vagy letiltásához.

Főbb hibajavítások

  • Kijavítja a findById metódus viselkedését. Korábban ez a metódus üresen lett visszaadva, ha az entitás nem található ahelyett, hogy kivételt eredményezett volna.

2.2.0 (2019. október 21.)

Új funkciók

  • Teljes körű Reaktív Azure Cosmos DB-adattár támogatása.
  • Az Azure Cosmos DB kérésdiagnosztikai sztringje és a lekérdezési metrikák támogatottak.
  • Az Azure Cosmos DB SDK verziófrissítése a 3.3.1-es verzióra.
  • Spring Framework-verziófrissítés 5.2.0.RELEA Standard kiadás.
  • A Spring Data Commons verziófrissítése a 2.2.0.RELEA Standard kiadás verzióra.
  • Hozzáadások findByIdAndPartitionKey és deleteByIdAndPartitionKey API-k.
  • Eltávolítja a függőségeket az azure-documentdb-ből.
  • A DocumentDB újrabrandálása az Azure Cosmos DB-be.

Főbb hibajavítások

  • A "Rendezés kivételt eredményez, ha a pageSize kisebb, mint az adattár összes eleme".

2.1.8 (2019. október 18.)

Új funkciók

  • A DocumentDB API-k elavultak.
  • Hozzáadások findByIdAndPartitionKey és deleteByIdAndPartitionKey API-k.
  • Optimista zárolást ad hozzá a ._etag
  • Engedélyezi az SpEL-kifejezést a dokumentumgyűjtemény nevének megadásakor.
  • Újításokat ad ObjectMapper hozzá.

2.1.7 (2019. október 18.)

Új funkciók

  • Hozzáadja az Azure Cosmos DB SDK 3- es verziójától való függőséget.
  • Reaktív Azure Cosmos DB-adattár hozzáadása.
  • Frissítések Az Azure Cosmos DB SDK 3-ás verziójának implementálásaDocumentDbTemplate.
  • További konfigurációs módosításokat ad hozzá a Reaktív Azure Cosmos DB-adattár támogatásához.

2.1.2 (2019. március 19.)

Főbb hibajavítások

  • Eltávolítja a applicationInsights következő függőségeket:
    • A környezetszennyező függőségek lehetséges kockázata.
    • Java 11 inkompatibilitás.
    • A processzorra és/vagy a memóriára gyakorolt lehetséges teljesítményhatékonyság elkerülése.

2.0.7 (2019. március 20.)

Főbb hibajavítások

  • A Backport eltávolítja a következő függőségeket applicationInsights :
    • A környezetszennyező függőségek lehetséges kockázata.
    • Java 11 inkompatibilitás.
    • A processzorra és/vagy a memóriára gyakorolt lehetséges teljesítményhatékonyság elkerülése.

2.1.1 (2019. március 7.)

Új funkciók

  • Frissítések főverziót a 2.1.1-es verzióra.

2.0.6 (2019. március 7.)

Új funkciók

  • A telemetriai kivételek figyelmen kívül hagyása.

2.1.0 (2018. december 17.)

Új funkciók

  • Frissítések 2.1.0-s verzióra a probléma megoldásához.

2.0.5 (2018. szeptember 13.)

Új funkciók

  • Kulcsszavakat exists és startsWith.
  • Frissítések Readme.

Főbb hibajavítások

  • Kijavítja a "Nem hívható meg az önálló href közvetlenül az entitáshoz".
  • A "findAll sikertelen lesz, ha a gyűjtemény nem jön létre".

2.0.4 (előzetes verzió) (2018. augusztus 23.)

Új funkciók

  • Átnevezi a csomagot a documentdb-ről a cosmosdb-ra.
  • Hozzáadja a lekérdezési módszer kulcsszójának új funkcióját. A NoSQL-hez készült API 16 kulcsszója mostantól támogatott.
  • A lekérdezés új funkcióját adja hozzá lapozással és rendezéssel.
  • Leegyszerűsíti a spring-data-cosmosdb konfigurációját.
  • Hozzáadások deleteCollection és deleteAll API-k.

Főbb hibajavítások

  • Hibajavítás és hibaelhárítás.

GYIK

Hogyan fogok értesülni az SDK kivezetéséről?

A Microsoft értesítést küld 12 hónappal a kivezetett SDK támogatásának vége előtt, megkönnyítve a zökkenőmentes áttérést egy támogatott SDK-ra. Az értesítéseket különböző kommunikációs csatornákon továbbítjuk: az Azure Portalon, Azure-frissítés útján, valamint a hozzárendelt szolgáltatásadminisztrátorok közvetlen értesítésével.

Létrehozhatok alkalmazásokat egy hamarosan kivezetendő Azure Cosmos DB SDK-val ebben a 12 hónapos időszakban?

Igen, a 12 hónapos értesítési időszakban is lehet alkalmazásokat létrehozni, üzembe helyezni és módosítani a hamarosan kivezetendő Azure Cosmos DB SDK-val. Javasoljuk, hogy a 12 hónap folyamán lehetőleg mielőbb térjen át az Azure Cosmos DB SDK újabb, támogatott verziójára.

A kivezetési dátum után mi lesz a már nem támogatott Azure Cosmos DB SDK-t használó alkalmazásokkal?

A kivezetési dátum után az Azure Cosmos DB nem biztosít több hibajavítást, új funkciót és támogatást a kivezetett SDK-verziókhoz. Ha nem frissíti az SDK-t, az Azure Cosmos DB szolgáltatás továbbra is kiszolgálja az SDK kivezetett verziói által küldött kéréseket.

Melyik SDK-verziók kapják meg a legújabb funkciókat és frissítéseket?

Az új funkciók és frissítések csak a legújabb támogatott fő SDK-verzió legújabb alverziójában lesznek hozzáadva. Javasoljuk, hogy mindig használja a legújabb verziót, hogy hozzájusson az új funkciókhoz, teljesítménybeli fejlesztésekhez és hibajavításokhoz. Ha egy régebbi, még nem kivezetett SDK-verziót használ, akkor az Azure Cosmos DB felé küldött kérései továbbra is működni fognak, de nem lesz hozzáférése az új lehetőségekhez.

Mit tegyek, ha nem tudom frissíteni az alkalmazásomat egy megszűnési dátum előtt?

Javasoljuk, hogy mindig a lehető leghamarabb frissítsen a legújabb SDK-verzióra. Miután egy SDK kivezetendő megjelölést kap, 12 hónap áll rendelkezésre az alkalmazás frissítésére. Ha nem tudja elvégezni a frissítést a kivezetési dátumig, az Azure Cosmos DB szolgáltatás továbbra is kiszolgálja az SDK kivezetett verziói által küldött kéréseket, így a futó alkalmazások továbbra is működni fognak. Azonban az Azure Cosmos DB nem biztosít több hibajavítást, új funkciót és támogatást a kivezetett SDK-verziókhoz.

Ha rendelkezik támogatási csomaggal és műszaki támogatásra van szüksége, lépjen kapcsolatba velünk egy támogatási jegy beküldésével.

Hogyan kérhetem, hogy funkciók legyenek hozzáadva egy SDK-hoz vagy összekötőhöz?

Az új funkciók nem mindig jelennek meg azonnal minden SDK-hoz vagy összekötőhöz. Ha egy olyan funkció nem támogatott, amelyet hozzá szeretne adni, küldjön visszajelzést a közösségi fórumunkra.

Következő lépések

További információ az Azure Cosmos DB-ről.

További információ a Spring Frameworkről.

További információ a Spring Bootról.

További információ a Spring Data szolgáltatásról.