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

A KÖVETKEZŐKRE VONATKOZIK: SQL API

A Spring Data Azure Cosmos DB Core 2-es verziója (SQL) 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 Cosmos SDK ezen verziója a Cosmos DB Java SDK kivezetett verziójától függ. A Spring Data Cosmos SDK-t a közeljövőben kivezetjük! Ez nem a legújabb Azure Cosmos DB-hez készült Azure Spring Data Cosmos SDK, és elavult. Az Azure Spring Data Cosmos SDK V2 teljesítményproblémái és instabilitása miatt erősen ajánlott az Azure Spring Data Cosmos v3 használata a projekthez. A frissítéshez kövesse a Migrálás az Azure Cosmos DB Java SDK v4-re 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 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 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.

A Spring Data Azure Cosmos DB-t az Azure Spring Cloud-alkalmazásokban is használhatja.

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 SQL API-t támogatja.

A Spring Data más Azure Cosmos DB API-kkal való alkalmazásával kapcsolatos információkért tekintse meg a következő cikkeket:

Szeretne gyorsan menni?

  1. Telepítse a minimálisan támogatott Java-futtatókörnyezetet (JDK 8), hogy használhassa 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éréseken.

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 GitHub
Spring Boot Starter Java-hoz készült Azure Cosmos DB Spring Boot Starter ügyfélkódtár
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 SQL API-val
az Azure Cosmos DB Spring Boot Starter adattárának GitHub
Minta a Azure App Service A Spring és a Cosmos DB használata a Linuxos App Service-szel
TODO alkalmazásminta

Kiadási előzmények

2.3.0 (2020. május 21.)

Új funkciók

  • Frissíti a Spring Boot 2.3.0-s verzióját.

2.2.5 (2020. május 19.)

Új funkciók

  • Frissíti az Azure Cosmos DB-t a 3.7.3-ra.

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

Legfontosabb hibajavítások

  • A jelölő javítása allowTelemetry , amelyből figyelembe kell venni 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 hozzáadása partíciókulcs API-val.
  • Frissíti az Azure Cosmos DB 3.7.0-s verzióját.

Legfontosabb hibajavítások

  • Javítások collectionName –>containerName.
  • Javítások entityClass és domainClass ->domainType.
  • Ki lett javítva az "Adattár által mentett visszatérési entitásgyűjtemény bemeneti entitás helyett".

2.1.10 (2020. február 25.)

Legfontosabb hibajavítások

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

2.2.2 (2020. január 15.)

Új funkciók

  • Frissíti az Azure Cosmos DB 3.6.0-s verzióját.

Legfontosabb hibajavítások

2.2.1 (2019. december 31.)

Új funkciók

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

Legfontosabb hibajavítások

  • Az SDK 3.5.0-s frissítés "Kivétel, ha a Cosmos DB HTTP-válaszfejléce nagyobb, mint 8192 bájt", a "ConsistencyPolicy.defaultConsistencyLevel() meghiúsul a korlátozott frissesség és a konzisztens előtag esetében."
  • 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ítottunk 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

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

Legfontosabb 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

  • A Reaktív Cosmos-adattár teljes körű támogatása.
  • Az Azure Cosmos DB kérésdiagnosztikai sztring és 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 fájlból.
  • Átnevezi a DocumentDB-t az Azure Cosmos DB-be.

Legfontosabb hibajavítások

  • 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 ._etag
  • Engedélyezi az SpEL-kifejezést a dokumentumgyűjtemény nevéhez.
  • Fejlesztéseket ad ObjectMapper hozzá.

2.1.7 (2019. október 18.)

Új funkciók

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

2.1.2 (2019. március 19.)

Legfontosabb hibajavítások

  • Eltávolítja a applicationInsights következő függőségeit:
    • A környezetszennyező függőségek lehetséges kockázata.
    • A Java 11 inkompatibilitása.
    • 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.)

Legfontosabb hibajavítások

  • A Backport eltávolítja a következő függőségeit applicationInsights :
    • A környezetszennyező függőségek lehetséges kockázata.
    • A Java 11 inkompatibilitása.
    • 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íti a 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 telemetria kivételeit.

2.1.0 (2018. december 17.)

Új funkciók

  • A probléma megoldásához frissítse a 2.1.0-s verziót.

2.0.5 (2018. szeptember 13.)

Új funkciók

  • exists Kulcsszavak és startsWith.
  • Frissítések olvasása.

Legfontosabb hibajavítások

  • Ki lett javítva a "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-re.
  • A lekérdezési módszer kulcsszójának új funkcióját adja hozzá. Mostantól SQL API 16 kulcsszója támogatott.
  • A lekérdezés új funkciójának hozzáadása lapozással és rendezéssel.
  • Leegyszerűsíti a spring-data-cosmosdb konfigurációját.
  • Hozzáadások deleteCollection és deleteAll API-k.

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

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.