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

  • Cikk
  • 11 perc alatt elolvasható

A KÖVETKEZŐKRE VONATKOZIK: NoSQL

Ez az eredeti Azure Cosmos DB Sync Java SDK v2 for API for NoSQL, amely támogatja a szinkron műveleteket.

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 projekthez. A frissítéshez kövesse a Migrate to Azure Cosmos DB Java SDK v4 útmutatóban és a Reactor vs RxJava útmutatóban található utasításokat.

Fontos

2024. február 29-én megszűnik az Azure Cosmos DB Sync Java SDK v2.x. Az Azure Cosmos DB a kivezetés után nem nyújt további karbantartást és támogatást ehhez az SDK-hoz. Az Azure Cosmos DB Java SDK v4-be való migráláshoz kövesse a fenti utasításokat.

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

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-s verzióra
  • Frissített függőség commons-codec/commons-codec az 1.15-ös verzióra
  • Frissített függőség org.json/json 20180130

2.6.4

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

2.6.3

  • Kijavítottunk egy újrapróbálkozási szabályzatot, amikor GoneException be van csomagolva 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, így a Spark-összekötő (a Spark 2.4-hez) egyéni újrapróbálkozási szabályzattal engedélyezheti 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 időponttól való lekérdezése.

2.5.1

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

2.5.0

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

2.4.7

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

2.4.6

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

2.4.5

  • Ne próbálkozzon újra érvénytelen partíciókulcs-tartományhiba esetén, ha a felhasználó megadja a pkRangeId azonosítót.

2.4.4

  • Az optimalizált partíciókulcs-tartomány gyorsítótára frissül.
  • Kijavítottuk 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

  • Az optimalizált gyűjteménygyorsítótár frissül.

2.4.1

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

2.4.0

  • Bevezettük a PartitionKeyDefinition verzió api-jait.

2.3.0

  • Külön időtúllépési támogatás hozzáadva a közvetlen módhoz.

2.2.3

  • Null hibaüzenetet használ a szolgáltatásból, és dokumentumügyfél-kivételt hoz létre.

2.2.2

  • Szoftvercsatorna-kapcsolat fejlesztése, a 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áját.

2.1.2

  • Mostantól támogatottak az összetett indexek.
  • 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 előfeltételekkel rendelkező upserts hibahibát.

2.1.1

  • Kijavítottuk az átjárócím-gyorsítótárban található hibát.

2.1.0

  • Többrégiós írási támogatás hozzáadva a közvetlen módhoz.
  • A SzolgáltatásUnavailable kivételekként kapott IOExceptions kezelésének támogatása hozzáadva egy proxyból.
  • Kijavítottunk egy hibát a végpontfelderítés újrapróbálkozásának szabályzatában.
  • Kijavítottunk egy hibát annak biztosítására, 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 annak biztosítása érdekében, hogy a nagy partíciókulcs 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 NPE-hibát közvetlen módban.

1.16.1

  • Az egyedi index támogatása hozzáadva.
  • A hírcsatorna-beállításokban a folytatási jogkivonat méretének korlátozására szolgáló támogatás hozzáadva.
  • Kijavítottunk egy hibát a Json-szerializálásban (időbélyeg).
  • Kijavítottunk egy hibát a Json-szerializálásban (enumerálás).
  • 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 előzetes fejlesztés a nem orderby keresztpartíciós lekérdezésekhez.
  • Továbbfejlesztett UUID-generáció.
  • Továbbfejlesztett munkamenetkonzisztencia-logika.
  • Többpógonyos támogatás hozzáadva.
  • A partíciókulcs-tartomány statisztikáinak támogatása hozzáadva a gyűjteményhez.
  • 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ítottuk a partíciókulcs kódolásával kapcsolatos probléma okát.

1.12.0

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

1.11.0

  • A KonzisztensElőtag 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 sebességgel és 100 RU/s-os növekményekben skálázható.
  • Kijavítottunk 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 okozhatott a lekérdezések esetében átjáró módban.
  • Kijavítottunk néhány hibát a munkamenet-tárolóban, amelyek a "Tulajdonosi erőforrás nem találhatók" kivételt okozhattak 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. Lásd: Az összesítés támogatása.
  • 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álaszoltak, amikor szabályozási hibákba ütköznek.
  • Kijavítottunk egy hibát a munkamenetkonzisztencia módban.
  • Kijavítottunk egy hibát, amely NullReferenceException hibát okozhat a HttpContextben, 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ány megfelelő leállításához.
  • Javítottuk a lekérdezési teljesítményt a közvetlen kapcsolati módban úgy, hogy a lekérdezési tervet az átjáró helyett a natív szerelvényből származtatjuk.
  • Állítsa be a FAIL_ON_UNKNOWN_PROPERTIES = hamis értéket, hogy a felhasználóknak ne kelljen JsonIgnoreProperties értéket definiálniuk a POJO-ban.
  • A naplózás újrabontása 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 a közvetlen kapcsolati módban ne szivárogjon ki a kapcsolat.
  • Kijavítottunk egy hibát a TOP lekérdezésben, amely NullReference kivételt okozhatott.
  • 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áadta az állapotkódot, az ActivityID-t és a kérés URI-ját a DocumentClientExceptionben.

1.9.2

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

1.9.1

  • A BoundedStaleness konzisztenciaszint támogatása hozzáadva.
  • A particionált gyűjtemények CRUD-műveleteinek 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 párhuzamos keresztpartíciós 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 hozzáadva a közvetlen kapcsolat használatakor.
  • Ki lett javítva, hogy az ActivityId konzisztens maradjon az összes kérelem-újrapróbálkozásban.
  • Kijavítottunk egy, a munkamenet-gyorsítótárral kapcsolatos hibát egy azonos nevű gyűjtemény újra létrehozásakor.
  • A térbeli lekérdezések gyűjteményindexelési szabályzatának megadásakor sokszög- és vonallánc-adattípusokat adott hozzá.
  • Kijavítottuk a Java 1.8 Java-dokumentumával kapcsolatos problémákat.

1.8.1

  • Kijavítottunk egy hibát a PartitionKeyDefinitionMap szolgáltatásban az egypartíciós gyűjtemények gyorsítótárazásához, és nem igényelt extra lekéréses 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éket adott meg.

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 bővült. Lásd: 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 hozzáadva.

1.6.0

1.5.1

  • Kijavítottunk egy hibát a HashPartitionResolverben a kivonatértékek little-endianben történő létrehozásához, hogy konzisztensek legyenek más SDK-kkal.

1.5.0

  • Adjon hozzá kivonattartomány & partíciófeloldókat 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 a Upsert funkció támogatásához.
  • Implementálja az azonosítóalapú útválasztást. Nincs nyilvános API-módosítás, minden belső változá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
  • Ellenőrzi az összes erőforrás AZONOSÍTÓ tulajdonságát. Az erőforrások azonosítói nem tartalmazhatnak ?, /, #, , karaktereket vagy szóközzel végződő karaktereket.
  • Ú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 előre biztosít értesítést az SDK-k kivonásáról az újabb vagy támogatott verzióra való zökkenőmentes váltás érdekében. Az új funkciók és funkciók és optimalizálások csak az aktuális SDK-hoz lesznek hozzáadva, ezért javasoljuk, hogy a lehető leghamarabb frissítsen a legújabb SDK-verzióra.

Figyelmeztetés

2020. május 30-a után az Azure Cosmos DB nem fog hibajavításokat végezni, új funkciókat hozzáadni, és támogatást nyújtani 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 nem fog hibajavításokat végezni, új funkciókat hozzáadni, és támogatást nyújtani 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. december 17. 2024. február 29.
2.6.0 2020. július 16. Feb 29, 2024
2.5.1 2020. június 03. Feb 29, 2024
2.5.0 2020. május 12. Feb 29, 2024
2.4.7 2020. február 20. Feb 29, 2024
2.4.6 2020. január 24. Feb 29, 2024
2.4.5 2019. nov. 10. Feb 29, 2024
2.4.4 2019. október 24. Feb 29, 2024
2.4.2 2019. szeptember 26. Feb 29, 2024
2.4.1 2019. júl. 18. Feb 29, 2024
2.4.0 2019. május 04. Feb 29, 2024
2.3.0 2019. ápr. 24. Feb 29, 2024
2.2.3 2019. ápr. 16. Feb 29, 2024
2.2.2 2019. ápr. 05. Feb 29, 2024
2.2.0 2019. márc. 27. Feb 29, 2024
2.1.3 2019. márc. 13. Feb 29, 2024
2.1.2 2019. márc. 09. Feb 29, 2024
2.1.1 2018. december 13. Feb 29, 2024
2.1.0 2018. nov. 20. Feb 29, 2024
2.0.0 2018. szeptember 21. Feb 29, 2024
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. May 30, 2020
1.16.1 2018. május 16. May 30, 2020
1.16.0 2018. március 15. May 30, 2020
1.15.0 2017. nov. 14. May 30, 2020
1.14.0 2017. október 28. May 30, 2020
1.13.0 2017. augusztus 25. May 30, 2020
1.12.0 2017. július 11. May 30, 2020
1.11.0 2017. május 10. May 30, 2020
1.10.0 2017. március 11. May 30, 2020
1.9.6 2017. február 21. May 30, 2020
1.9.5 2017. január 31. May 30, 2020
1.9.4 2016. november 24. May 30, 2020
1.9.3 2016. október 30. May 30, 2020
1.9.2 2016. október 28. May 30, 2020
1.9.1 2016. október 26. May 30, 2020
1.9.0 2016. október 03. May 30, 2020
1.8.1 2016. június 30. May 30, 2020
1.8.0 2016. június 14. May 30, 2020
1.7.1 2016. április 30. May 30, 2020
1.7.0 2016. április 27. May 30, 2020
1.6.0 2016. március 29. May 30, 2020
1.5.1 2015. december 31. May 30, 2020
1.5.0 2015. december 04. May 30, 2020
1.4.0 2015. október 05. May 30, 2020
1.3.0 October 05, 2015 May 30, 2020
1.2.0 2015. augusztus 05. May 30, 2020
1.1.0 2015. július 09. May 30, 2020
1.0.1 2015. május 12. May 30, 2020
1.0.0 2015. április 07. May 30, 2020
0.9.5-prelease 2015. márc. 09. 2016. február 29.
0.9.4-prelease 2015. február 17. February 29, 2016
0.9.3-prelease 2015. január 13. February 29, 2016
0.9.2-prelease 2014. december 19. 2016. február 29.
0.9.1-előlejárat December 19, 2014 February 29, 2016
0.9.0-prelease 2014. december 10. February 29, 2016

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 szolgáltatásokat lehessen hozzáadni 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 van olyan funkció, amelyet nem szeretne hozzáadni, kérjük, adjon visszajelzést a közösségi fórumunkhoz.

Lásd még

Az Azure Cosmos DB-vel kapcsolatos további információkért lásd a Microsoft Azure Cosmos DB szolgáltatásoldalát.