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ŐKRE VONATKOZIK: NoSQL

A Spring Data A NoSQL-hez készült Azure Cosmos DB 2-es verziója 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 kezeléséhez, dokumentumok kezeléséhez és lekérdezések kiadásához. 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 hamarosan 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 határozottan 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éginjektálással leegyszerű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 webalkalmazások és mikroszolgáltatások fejlesztésének szemével bővíti a vízvezetékek kezelését. A Spring Data egy programozási modell az olyan adattárak eléréséhez, mint az Azure Cosmos DB egy Spring- vagy Spring Boot-alkalmazás környezetéből.

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 való használatával kapcsolatos információkért tekintse meg az alábbi cikkeket:

Szeretne gyorsan menni?

  1. Telepítse a minimálisan támogatott Java-futtatókörnyezetet(JDK 8), hogy használni tudja az SDK-t.
  2. Hozzon létre egy Spring Data Azure Cosmos DB-alkalmazást a starter használatával. Egyszerű!
  3. Tekintse át a Spring Data Azure Cosmos DB fejlesztői útmutatóját, amely végigvezeti az alapszintű Azure Cosmos DB-kérelmeken.

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

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 Javához
Spring TODO-alkalmazásminta az Azure Cosmos DB-vel Végpontok közötti Java-élmény App Service Linuxon (2. rész)
Fejlesztői útmutató Spring Data Azure Cosmos DB – fejlesztői útmutató
A Starter használata A Spring Boot Starter használata az Azure Cosmos DB for NoSQL-lel
GitHub-adattár az Azure Cosmos DB Spring Boot Starterhez
Minta Azure App Service A Spring és az Azure Cosmos DB használata App Service on Linux
TODO-alkalmazásminta

Kiadási előzmények

2.3.0 (2020. május 21.)

Új funkciók

  • Frissítések Spring Boot 2.3.0-s verzió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óriaveszté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 allowTelemetry a jelölőt, amely figyelembe veszi a elemet.CosmosDbConfig
  • TTL A tároló tulajdonságának javítása.

2.2.3 (2020. február 25.)

Új funkciók

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

Főbb hibajavítások

  • Javítások collectionName ->containerName .
  • Javítások entityClass és domainClass ->domainType.
  • A "Bemeneti entitás helyett adattár által mentett visszatérési entitásgyűjtemény" javítása.

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-verziót a 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-verziót a 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. CosmosClientException A segítségével teszi elérhetővé a parancsotCosmosDBAccessException.
  • Elérhetővé teszi requestCharge és activityId keresztül ResponseDiagnostics.

Főbb hibajavítások

  • Az SDK 3.5.0-s 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 kötött elavultság és a konzisztens előtag esetén."
  • Kijavítja a findById metódus viselkedését. Korábban ez a metódus üres értéket adott vissza, 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 üres értéket adott vissza, 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ámogatása.
  • Az Azure Cosmos DB SDK 3.3.1-es verzióra frissült.
  • A Spring Framework verziófrissítése az 5.2.0.RELEASE verzióra.
  • A Spring Data Commons verziófrissítése a 2.2.0.RELEASE verzióra.
  • Hozzáadások findByIdAndPartitionKey és deleteByIdAndPartitionKey API-k.
  • Eltávolítja a függőséget az azure-documentdb-ból.
  • A DocumentDB újbóli létrehozása az Azure Cosmos DB-be.

Főbb hibajavítások

  • Kijavítja a "Rendezés kivételt jelez, 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 alapján _etag.
  • Engedélyezi az SpEL-kifejezést a dokumentumgyűjtemény nevének beállításához.
  • Fejlesztéseket ad ObjectMapper hozzá.

2.1.7 (2019. október 18.)

Új funkciók

  • Hozzáadja az Azure Cosmos DB SDK 3- es verziójának függőségét.
  • Reaktív Azure Cosmos DB-adattár hozzáadása.
  • Frissítések Az Azure Cosmos DB SDK 3-es verziójának használata.DocumentDbTemplate
  • 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 függőségek potenciális kockázata szennyeződik.
    • Java 11-kompatibilitás.
    • A processzorra és/vagy a memóriára gyakorolt lehetséges teljesítményhatás elkerülése.

2.0.7 (2019. március 20.)

Főbb hibajavítások

  • A Backport eltávolítja a függőséget applicationInsights a következőhöz:
    • A függőségek potenciális kockázata szennyeződik.
    • Java 11-kompatibilitás.
    • A processzorra és/vagy a memóriára gyakorolt lehetséges teljesítményhatás 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

  • Hagyja figyelmen kívül a telemetriai adatok kivételeit.

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

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

Főbb hibajavítások

  • Kijavítja a következőt: "Nem hívható meg a self 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.
  • Új lekérdezési funkciót ad 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 hibamegoldá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érhetek szolgáltatásokat egy SDK-hoz vagy összekötőhöz?

Az új funkciók nem minden SDK-hoz vagy összekötőhöz kerülnek azonnal. Ha van olyan funkció, amelyet nem szeretne hozzáadni, kérjük, adjon visszajelzést a közösségi fórumunkhoz.

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.