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

  • A következőre érvényes:: ✅ 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.

Important

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.

Warning

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.

Links
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
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 IOExceptions kapott kezelés ServiceUnavailable 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 kapcsolatké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 ConnectionPolicy.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 ConnectionPolicy.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

Microsoft legalább 12 hónap értesítést küld az SDK kivonása előtt, 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.

Warning

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.

Version 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?

Microsoft 12 hónapos előzetes értesítést küld a nyugdíjba vonuló SDK támogatásának vége előtt, hogy megkönnyítse a támogatott SDK-ra való zökkenőmentes áttérést. Különböző kommunikációs csatornákon keresztül értesítjük Önt: a Azure portálon, Azure frissítésekről, valamint a hozzárendelt szolgáltatásgazdák felé történő közvetlen kommunikációról.

A 12 hónapos időszakban kivont Azure Cosmos DB SDK-val to-be-kivont SDK-val szerzek alkalmazásokat?

Igen, a 12 hónapos értesítési időszak alatt a to-be-retired Azure Cosmos DB SDK használatával hozhat létre, helyezhet üzembe és módosíthat alkalmazásokat. Javasoljuk, hogy a 12 hónapos értesítési időszak alatt a Azure Cosmos DB SDK egy újabb támogatott verziójára migráljon, ha szükséges.

A nyugdíjazási dátum után mi történik a nem támogatott Azure Cosmos DB SDK-t használó alkalmazásokkal

A kivonás dátuma után a Azure Cosmos DB már nem fog hibajavításokat végezni, új funkciókat hozzáadni, vagy támogatást nyújtani a kivont SDK-verziókhoz. Ha nem szeretne frissíteni, az SDK kivezetett verzióiból küldött kérelmeket továbbra is a Azure Cosmos DB szolgáltatás fogja kiszolgálni.

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 az SDK egy régi, nem kivezetett verzióját használja, a Azure Cosmos DB kérései továbbra is működni fognak, de nem lesz hozzáférése új képessé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 tud frissíteni a kivonási dátumig, az SDK kivezetett verzióiból küldött kérelmeket továbbra is a Azure Cosmos DB fogja kiszolgálni, így a futó alkalmazások továbbra is működni fognak. De Azure Cosmos DB már nem fog hibajavításokat végezni, új funkciókat hozzáadni, vagy támogatást nyújtani 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.

  • Last updated on