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

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Ez a cikk a NoSQL API-hoz készült Azure Cosmos DB Sync Java SDK v2-t ismerteti. Ez az API csak a szinkron műveleteket támogatja.

Fontos

Nem ez a legújabb Java SDK az Azure Cosmos DB-hez! Határozottan javasoljuk, hogy az Azure Cosmos DB Java SDK v4-et használja a projektjéhez. A frissítéshez kövesse a Migrate to Azure Cosmos DB Java SDK v4 útmutatójában és a Reactor vs RxJava útmutatóban található utasításokat.

Figyelmeztetés

2024. február 29-én az Azure Cosmos DB Sync Java SDK v2.x kivezetése megtörtént. Az Azure Cosmos DB már nem biztosít karbantartást vagy támogatást ehhez az SDK-hoz a kivonás után. Kövesse az itt leírt utasításokat az Azure Cosmos DB Java SDK v4-be való migráláshoz.

Hivatkozások
SDK letöltése Maven
API-dokumentáció Java API-referenciadokumentáció
Közreműködés az SDK-hoz GitHub
Első lépések A Java SDK használatának első lépései
Webalkalmazás-oktatóanyag Webalkalmazás-fejlesztés az Azure Cosmos DB-vel
Minimálisan támogatott futtatókörnyezet Java Fejlesztői készlet (JDK) 7+

Kibocsátási megjegyzések

Itt találja az SDK egyes verzióinak kibocsátási megjegyzéseit.

2.6.5

  • Biztonsági rések miatt eltávolított tesztfüggőség com.google.guava/guava
  • Frissített függőség com.fasterxml.jackson.core/jackson-databind a 2.14.0-ra
  • Frissített függőség commons-codec/commons-codec 1.15-re
  • Frissített függőség org.json/json a 20180130

2.6.4

  • Kijavítottuk az olvasási időtúllépések újrapróbálkozési szabályzatát

2.6.3

  • Kijavítottunk egy újrapróbálkozási szabályzatot, amikor GoneException be van burkolva IllegalStateException – ez a módosítás szükséges ahhoz, hogy az átjáró gyorsítótára frissüljön a 410-es verzióban, hogy a Spark-összekötő (a Spark 2.4-hez) egyéni újrapróbálkozási szabályzattal engedélyezze a lekérdezések sikerességét a partíciófelosztások során

2.6.2

  • Új újrapróbálkozési szabályzat hozzáadva az olvasási időtúllépések újrapróbálkozásához
  • Frissített függőség com.fasterxml.jackson.core/jackson-databind a 2.9.10.8-ra
  • Frissített függőség org.apache.httpcomponents/httpclient a 4.5.13-ra

2.6.1

  • Kijavítottunk egy hibát a lekérdezés szolgáltatásközi kezelése során.

2.6.0

  • Mostantól támogatott a változáscsatorna lekérdezése.

2.5.1

  • Kijavítja az elsődleges partíciógyorsítótár-problémát a documentCollection lekérdezésben.

2.5.0

  • A 449-hez hozzáadva az egyéni konfiguráció újrapróbálkozásának támogatása.

2.4.7

  • Kijavítottuk a kapcsolatkészlet időtúllépési problémáját.
  • Kijavítja a hitelesítési jogkivonat frissítését a belső újrapróbálkozásokon.

2.4.6

  • Frissítette a megfelelő ügyféloldali replikaházirend-címkét a databaseAccount-on, és a databaseAccount konfigurációja beolvasva lett a gyorsítótárból.

2.4.5

  • Ha a felhasználó pkRangeId azonosítót ad meg, ez a verzió nem próbálkozik újra az érvénytelen partíciókulcs-tartományhiba esetén

2.4.4

  • Az optimalizált partíciókulcs-tartomány gyorsítótára frissül.
  • Kijavítja azt a forgatókönyvet, amelyben az SDK nem támogatja a partíciófelosztási tippet a kiszolgálóról, és helytelen ügyféloldali útválasztási gyorsítótárak frissítését eredményezi.

2.4.2

  • Optimalizált gyűjteménygyorsítótár frissítései.

2.4.1

  • Támogatást kapott a kérés diagnosztikai sztringből származó belső kivételüzenet lekéréséhez.

2.4.0

  • A PartitionKeyDefinition-en bevezetett verzió API.

2.3.0

  • A közvetlen módhoz külön időtúllépési támogatást adtunk hozzá.

2.2.3

  • Null értékű hibaüzenet használata a szolgáltatásból, és dokumentumügyfél-kivétel létrehozása.

2.2.2

  • Szoftvercsatorna-kapcsolat fejlesztése, soKeepAlive alapértelmezett igaz hozzáadása.

2.2.0

  • A kérésdiagnosztikai sztring támogatása hozzáadva.

2.1.3

  • Kijavítottuk a PartitionKey for Hash V2 hibát.

2.1.2

  • Az összetett indexek támogatása hozzáadva.
  • Kijavítottuk a globális végpontkezelőben a frissítés kényszerítéséhez tartozó hibát.
  • Kijavítottuk a közvetlen módban lévő előfeltételekkel rendelkező upsert műveletek hibáját.

2.1.1

  • Kijavítottuk az átjáró címgyorsítótárában található hibát.

2.1.0

  • Többrégiós írási támogatás hozzáadva a közvetlen módhoz.
  • A proxyból kivételként ServiceUnavailable kapott kezelés IOExceptions támogatása hozzáadva.
  • Kijavítottunk egy hibát a végpontfelderítés újrapróbálkozásának szabályzatában.
  • Kijavítottunk egy hibát, amely biztosítja, hogy a nullmutató-kivételek ne legyenek a BaseDatabaseAccountConfigurationProviderben.
  • Kijavítottunk egy hibát, hogy a QueryIterator ne adjon vissza null értéket.
  • Kijavítottunk egy hibát, hogy a nagyméretű PartitionKey engedélyezve legyen.

2.0.0

  • Többrégiós írási támogatás hozzáadva az átjáró módhoz.

1.16.4

  • Kijavítottunk egy hibát egy lekérdezés olvasási partíciókulcs-tartományaiban.

1.16.3

  • Kijavítottunk egy hibát a folytatási jogkivonat fejlécméretének DirectHttps módban való beállításában.

1.16.2

  • A streamelési feladatátvétel támogatása hozzáadva.
  • Az egyéni metaadatok támogatása hozzáadva.
  • Továbbfejlesztett munkamenet-kezelési logika.
  • Kijavítottunk egy hibát a partíciókulcs-tartomány gyorsítótárában.
  • Kijavítottunk egy NullPointerException (NPE) hibát közvetlen módban.

1.16.1

  • Az egyedi index támogatása hozzáadva.
  • További támogatás a folytatási jogkivonat méretének korlátozásához a hírcsatorna-beállításokban.
  • Kijavítottunk egy hibát a JSON szerializálásában (időbélyeg).
  • Kijavítottunk egy hibát a Json szerializálásban (enum).
  • A com.fasterxml.jackson.core:jackson-databind függősége 2.9.5-re frissült.

1.16.0

  • Továbbfejlesztett Csatlakozás ion-készletezés a közvetlen módhoz.
  • Továbbfejlesztett prefetch-fejlesztés a nem rendezett keresztpartíciós lekérdezésekhez.
  • Továbbfejlesztett UUID-generáció.
  • Továbbfejlesztett munkamenetkonzisztencia-logika.
  • A többpógonyos támogatás hozzáadva.
  • A partíciókulcs-tartomány statisztikáinak támogatása a gyűjteményhez hozzáadva.
  • Kijavítottunk egy hibát a többrégiós támogatásban.

1.15.0

  • Jobb Json szerializálási teljesítmény.
  • Ehhez az SDK-verzióhoz az Azure Cosmos DB Emulator legújabb verziója szükséges.

1.14.0

  • Belső változások a Microsoft-barátkódtárakban.

1.13.0

  • Kijavítottunk egy hibát az egypartíciós kulcstartományok olvasása során.
  • Kijavítottunk egy hibát a ResourceID-elemzés során, amely a rövid névvel rendelkező adatbázist érinti.
  • Kijavítottunk egy partíciókulcs kódolásával kapcsolatos problémát.

1.12.0

  • Kritikus hibajavítások a partíciófelosztások során történő feldolgozás kéréséhez.
  • Kijavítottunk egy hibát az Erős és a BoundedStaleness konzisztenciaszinttel kapcsolatban.

1.11.0

  • A KonzisztensPrefix nevű új konzisztenciaszint támogatása hozzáadva.
  • Kijavítottunk egy hibát az olvasási gyűjteményben munkamenet módban.

1.10.0

  • A particionált gyűjtemény támogatása 2500 RU/s-val és 100 RU/s-os növekményes méretezéssel.
  • Kijavít egy hibát a natív szerelvényben, amely nullref kivételt okozhat bizonyos lekérdezésekben.

1.9.6

  • Kijavítottunk egy hibát a lekérdezési motor konfigurációjában, amely kivételeket okozhat a lekérdezések esetében átjáró módban.
  • Kijavítottunk néhány hibát a munkamenet-tárolóban, amely "Tulajdonosi erőforrás nem található" kivételt okozhat a kérések esetében közvetlenül a gyűjtemény létrehozása után.

1.9.5

  • Az összesítő lekérdezések (DARAB, MIN, MAX, SZUM és AVG) támogatása hozzáadva.
  • A változáscsatorna támogatása hozzáadva.
  • A RequestOptions.setPopulateQuotaInfo szolgáltatással bővült a gyűjteménykvóta adatainak támogatása.
  • A RequestOptions.setScriptLoggingEnabled szolgáltatáson keresztüli tárolt eljárásszkript-naplózás támogatása hozzáadva.
  • Kijavítottunk egy hibát, amely miatt a DirectHttps módban lévő lekérdezések nem válaszolhattak a szabályozás hibáinak észlelésekor.
  • Kijavítottunk egy hibát a munkamenet-konzisztencia módban.
  • Kijavítottunk egy hibát, amely a HttpContextben NullReferenceException hibát okozhat, ha a kérések száma magas.
  • A DirectHttps mód jobb teljesítménye.

1.9.4

  • Egyszerű ügyfélpéldány-alapú proxytámogatást adott hozzá a Csatlakozás ionPolicy.setProxy() API-val.
  • A DocumentClient.close() API hozzáadva a DocumentClient-példányok megfelelő bezárásához.
  • Jobb lekérdezési teljesítmény közvetlen kapcsolati módban, ha a lekérdezési tervet az átjáró helyett a natív szerelvényből származtatja.
  • Állítsa be a FAIL_ON_UNKNOWN_PROPERTIES = hamis értéket, hogy a felhasználóknak ne kelljen JsonIgnoreProperties értékeket definiálniuk az egyszerű régi Java-objektumban (POJO).
  • Újrabontásos naplózás az SLF4J használatához.
  • Kijavítottunk néhány egyéb hibát a konzisztenciaolvasóban.

1.9.3

  • Kijavítottunk egy hibát a kapcsolatkezelésben, hogy megakadályozza a közvetlen kapcsolati módban jelentkező kapcsolatszivárgást.
  • Kijavítottunk egy hibát a TOP lekérdezésben, amely nullreferencia-kivételt eredményezhet.
  • Jobb teljesítmény a belső gyorsítótárak hálózati hívásainak számának csökkentésével.
  • A jobb hibaelhárítás érdekében hozzáadott állapotkód, ActivityID és Request URI a DocumentClientExceptionben.

1.9.2

  • Kijavítottunk egy hibát a stabilitás érdekében a kapcsolatkezelésben.

1.9.1

  • A BoundedStaleness konzisztenciaszint támogatása hozzáadva.
  • A particionált gyűjteményekhez tartozó CRUD-műveletek közvetlen kapcsolatának támogatása hozzáadva.
  • Kijavítottunk egy hibát az adatbázis SQL-lel való lekérdezése során.
  • Kijavítottunk egy hibát a munkamenet-gyorsítótárban, amely miatt a munkamenet-jogkivonat helytelenül lett beállítva.

1.9.0

  • A többpartíciós párhuzamos lekérdezések támogatása hozzáadva.
  • A particionált gyűjtemények TOP/ORDER BY lekérdezéseinek támogatása hozzáadva.
  • Az erős konzisztencia támogatása hozzáadva.
  • A névalapú kérések támogatása a közvetlen kapcsolat használatakor.
  • Ki lett javítva, hogy az ActivityId konzisztens maradjon az összes kérelem újrapróbálkozása esetén.
  • Kijavítottunk egy, a munkamenet-gyorsítótárral kapcsolatos hibát egy azonos nevű gyűjtemény újra létrehozásakor.
  • Sokszög- és LineString DataTypes értéket adott hozzá, miközben gyűjteményindexelési szabályzatot adott meg a térbeli lekérdezések geoelektálásához.
  • Kijavítottuk a Java 1.8-hoz készült Java-dokumentummal kapcsolatos problémákat.

1.8.1

  • Kijavítottunk egy hibát a PartitionKeyDefinitionMap-ban az egypartíciós gyűjtemények gyorsítótárazásához, és nem igényelnek extra partíciókulcs-kéréseket.
  • Kijavítottunk egy hibát, amely miatt a rendszer nem próbálkozott újra, ha helytelen partíciókulcs-érték van megadva.

1.8.0

  • Hozzáadta a többrégiós adatbázisfiókok támogatását.
  • A szabályozott kérelmek automatikus újrapróbálkozási támogatása a maximális újrapróbálkozási kísérletek és a maximális újrapróbálkozási várakozási idő testreszabására szolgáló beállításokkal. További információ: RetryOptions és Csatlakozás ionPolicy.getRetryOptions().
  • Elavult IPartitionResolver-alapú egyéni particionálási kód. Használjon particionált gyűjteményeket a nagyobb tárterülethez és átviteli sebességhez.

1.7.1

  • Újrapróbálkozási szabályzat támogatása a sebességkorlátozáshoz.

1.7.0

  • A dokumentumok élettartamának (TTL) támogatása.

1.6.0

1.5.1

  • Kijavítottunk egy hibát a HashPartitionResolverben, hogy kivonatértékeket generáljunk a kis endianben, hogy összhangban legyenek más szoftverfejlesztői készletekkel (SDK-kkal).

1.5.0

  • Hash > Tartomány partíciófeloldóinak hozzáadása az alkalmazások több partíció közötti skálázásához.

1.4.0

  • Implementálja az Upsertet. Új upsertXXX metódusok hozzáadva az Upsert funkció támogatásához.
  • Id-alapú útválasztás implementálása. Nincs nyilvános API-módosítás, minden belső módosítás.

1.3.0

  • A kiadás kihagyva, hogy a verziószám igazodjon a többi SDK-hoz

1.2.0

  • Támogatja a térinformatikai indexet.
  • Az összes erőforrás azonosítótulajdonságának ellenőrzése. Az erőforrások azonosítói nem tartalmazhatnak ?, , /, #\, karaktereket vagy végződéseket szóközzel.
  • Új fejlécet ad hozzá az "indexátalakítás folyamatához" a ResourceResponse-hoz.

1.1.0

  • V2 indexelési szabályzat implementálása

1.0.0

  • GA SDK

Kiadási és kivonási dátumok

A Microsoft legalább 12 hónappal az SDK kivonása előtt értesítést küld, hogy zökkenőmentes legyen az áttérés egy újabb/támogatott verzióra. Az új funkciók, funkciók és optimalizálások csak az aktuális SDK-hoz lesznek hozzáadva. Javasoljuk, hogy a lehető leghamarabb frissítsen a legújabb SDK-verzióra.

Figyelmeztetés

2020. 03. 30. után az Azure Cosmos DB már nem fog hibajavításokat végezni, új funkciókat ad hozzá, és támogatást nyújt a NoSQL-hez készült Azure Cosmos DB Java SDK 1.x verziójához. Ha nem szeretné frissíteni, az SDK 1.x-es verziójából küldött kéréseket továbbra is kiszolgálja az Azure Cosmos DB szolgáltatás.

2016. február 29-e után az Azure Cosmos DB már nem fog hibajavításokat végezni, új funkciókat ad hozzá, és támogatást nyújt a NoSQL-hez készült Azure Cosmos DB Java SDK 0.x verziójához. Ha nem szeretne frissíteni, az SDK 0.x verziójából küldött kéréseket továbbra is az Azure Cosmos DB szolgáltatás fogja kiszolgálni.

Verzió Kiadás dátuma Kivonás dátuma
2.6.1 2020. dec. 17. 2024. február 29.
2.6.0 2020. július 16. 2024. február 29.
2.5.1 2020. június 03. 2024. február 29.
2.5.0 2020. május 12. 2024. február 29.
2.4.7 2020. február 20. 2024. február 29.
2.4.6 2020. január 24. 2024. február 29.
2.4.5 2019. nov. 10. 2024. február 29.
2.4.4 2019. október 24. 2024. február 29.
2.4.2 2019. szeptember 26. 2024. február 29.
2.4.1 2019. július 18. 2024. február 29.
2.4.0 2019. május 04. 2024. február 29.
2.3.0 2019. ápr. 24. 2024. február 29.
2.2.3 2019. ápr. 16. 2024. február 29.
2.2.2 2019. ápr. 05. 2024. február 29.
2.2.0 2019. márc. 27. 2024. február 29.
2.1.3 2019. márc. 13. 2024. február 29.
2.1.2 2019. márc. 09. 2024. február 29.
2.1.1 2018. dec. 13. 2024. február 29.
2.1.0 2018. nov. 20. 2024. február 29.
2.0.0 2018. szeptember 21. 2024. február 29.
1.16.4 2018. szeptember 10. 2020. május 30.
1.16.3 2018. szeptember 09. 2020. május 30.
1.16.2 2018. június 29. 2020. május 30.
1.16.1 2018. május 16. 2020. május 30.
1.16.0 2018. március 15. 2020. május 30.
1.15.0 2017. nov. 14. 2020. május 30.
1.14.0 2017. október 28. 2020. május 30.
1.13.0 2017. augusztus 25. 2020. május 30.
1.12.0 2017. július 11., kedd 2020. május 30.
1.11.0 2017. május 10. 2020. május 30.
1.10.0 2017. március 11., szombat 2020. május 30.
1.9.6 2017. február 21. 2020. május 30.
1.9.5 2017. január 31. 2020. május 30.
1.9.4 2016. november 24. 2020. május 30.
1.9.3 2016. október 30. 2020. május 30.
1.9.2 2016. október 28. 2020. május 30.
1.9.1 2016. október 26. 2020. május 30.
1.9.0 2016. október 03. 2020. május 30.
1.8.1 2016. június 30. 2020. május 30.
1.8.0 2016. június 14. 2020. május 30.
1.7.1 2016. április 30. 2020. május 30.
1.7.0 2016. április 27. 2020. május 30.
1.6.0 2016. március 29. 2020. május 30.
1.5.1 2015. december 31., csütörtök 2020. május 30.
1.5.0 2015. december 04. 2020. május 30.
1.4.0 2015. október 05. 2020. május 30.
1.3.0 2015. október 05. 2020. május 30.
1.2.0 2015. augusztus 05. 2020. május 30.
1.1.0 2015. július 09. 2020. május 30.
1.0.1 2015. május 12. 2020. május 30.
1.0.0 2015. április 07. 2020. május 30.
0.9.5-előzetes verzió 2015. márc. 09. 2016. február 29.
0.9.4-előzetes verzió 2015. február 17. 2016. február 29.
0.9.3-előzetes verzió 2015. január 13., kedd 2016. február 29.
0.9.2-előzetes verzió 2014. december 19. 2016. február 29.
0.9.1-előlejárat 2014. december 19. 2016. február 29.
0.9.0-előzetes verzió 2014. december 10. 2016. február 29.

Gyakori kérdések

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.