Sql API-hoz készült Azure Cosmos DB Java SDK (örökölt): Kibocsátási megjegyzések és erőforrások

A KÖVETKEZŐKRE VONATKOZIK: SQL API

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

Fontos

Ez nem a legújabb Java SDK az Azure Cosmos DB-hez! Fontolja meg az Azure Cosmos DB Java SDK v4 használatát 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 SDK és az SDK-t használó összes alkalmazás továbbra is működni fog; Az Azure Cosmos DB egyszerűen megszünteti az SDK további karbantartását és támogatását. Javasoljuk, hogy kövesse a fenti 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

2.6.3

  • Kijavítottunk egy újrapróbálkozási szabályzatot, amikor GoneException be van csomagolva IllegalStateException – ez a módosítás azért szükséges, hogy az átjáró gyorsítótára frissüljön a 410-en, 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ók felosztása 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 az időponttól kezdve.

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 újrapróbálkozás egyéni konfigurációjának támogatása hozzáadva.

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 helyes ügyféloldali replikaházirend-címkét a databaseAccount-on, és a databaseAccount konfigurációja olvasást végzett 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ó pkRangeId azonosítót ad meg.

2.4.4

  • Frissül az optimalizált partíciókulcs-tartomány gyorsítótára.
  • Kijavítja azt a forgatókönyvet, amelyben az SDK nem támogatja a partíció felosztási tippjét 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

  • A PartitionKeyDefinition által bevezetett verzió api.

2.3.0

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

2.2.3

  • Null értékű hibaüzenet használata a szolgáltatásból és a dokumentumügyfél kivételének előállítása.

2.2.2

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

2.2.0

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

2.1.3

  • Kijavítottuk a PartitionKey for Hash V2 hibaé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 hibaét.

2.1.1

  • Kijavítottuk az átjárócím-gyorsítótárban lévő hibát.

2.1.0

  • Többrégiós írási támogatás hozzáadva a közvetlen módhoz.
  • Mostantól támogatott a ServiceUnavailable kivételként kapott IOExceptions kezelése proxyból.
  • Kijavítottunk egy hibát a végpontészlelés újrapróbálkozásának szabályzatában.
  • Kijavítottunk egy hibát, amely azt eredményezte, hogy a nullmutatók kivételei nem jelennek meg a BaseDatabaseAccountConfigurationProviderben.
  • Kijavítottunk egy hibát, amely miatt a QueryIterator nem ad vissza null értéket.
  • Kijavítottunk egy hibát a nagyméretű PartitionKey engedélyezése érdekében

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 a 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 történő beállításában.

1.16.2

  • A streamelési feladatátvétel támogatása hozzáadva.
  • Mostantól támogatottak az egyéni metaadatok.
  • 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 folytatási jogkivonat méretének korlátozása mostantól támogatott a hírcsatorna-beállításokban.
  • Kijavítottunk egy hibát a JSON-szerializálás (timestamp) során.
  • Kijavítottunk egy hibát a JSON-szerializálás (enumerálás) során.
  • A com.fasterxml.jackson.core:jackson-databind függősége a 2.9.5-ös verzióra frissült.

1.16.0

  • Továbbfejlesztett kapcsolatkészletezés a közvetlen módhoz.
  • Továbbfejlesztett előzetes lépések a nem orderby keresztpartíciós lekérdezésekhez.
  • Továbbfejlesztett UUID-létrehozás.
  • Továbbfejlesztett munkamenet-konzisztencialogika.
  • 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ítottunk egy partíciókulcs-kódolással kapcsolatos hibá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

  • Mostantól támogatott a KonzisztensPrefix nevű új konzisztenciaszint.
  • Kijavítottunk egy hibát az olvasási gyűjtemény munkamenet módban történő olvasása során.

1.10.0

  • A particionált gyűjtemény támogatása 2500 RU/s-val, é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ó" kivételt okozhatnak 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 (COUNT, MIN, MAX, SUM és AVG) támogatása hozzáadva. Lásd : Aggregáció támogatása.
  • A változáscsatorna támogatása hozzáadva.
  • A RequestOptions.setPopulateQuotaInfo segítségével mostantól támogatottak a gyűjteménykvótaadatok.
  • A RequestOptions.setScriptLoggingEnabled parancsprogramon 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 szabályozási hibák esetén.
  • Kijavítottunk egy hibát a munkamenet-konzisztencia módban.
  • Kijavítottunk egy hibát, amely NullReferenceException kivételt 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ás hozzáadva a ConnectionPolicy.setProxy() API-val.
  • A DocumentClient.close() API hozzáadva a DocumentClient-példány megfelelő leállításához.
  • Jobb lekérdezési teljesítmény közvetlen kapcsolati módban, ha a lekérdezéstervet az átjáró helyett a natív szerelvényből származtatja.
  • Állítsa be FAIL_ON_UNKNOWN_PROPERTIES = hamis értéket, hogy a felhasználóknak ne kelljen JsonIgnoreProperties-t definiálniuk a POJO-ban.
  • Ú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 a közvetlen kapcsolati módban jelentkező csatlakozási szivárgások megelőzése érdekében.
  • 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 DocumentClientException kivételben.

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ények CRUD-műveleteihez mostantól támogatott a közvetlen kapcsolat.
  • Kijavítottunk egy hibát egy adatbázis SQL-lel való lekérdezésekor.
  • 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.
  • Mostantól támogatottak a TOP/ORDER BY lekérdezések particionált gyűjteményekhez.
  • Az erős konzisztencia támogatása hozzáadva.
  • A névalapú kérések mostantól támogatottak a közvetlen kapcsolat használatakor.
  • Ki lett javítva, hogy az ActivityId konzisztens maradjon az összes kérelem-újrapróbálkozási műveletben.
  • Kijavítottunk egy, a munkamenet-gyorsítótárral kapcsolatos hibát egy azonos nevű gyűjtemény létrehozásakor.
  • Sokszög- és LineString-adattípusok hozzáadva a gyűjteményindexelési szabályzat megadásakor a térbeli lekérdezések geokerítéséhez.
  • 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 a partíciókulcs-kérések további lehívásához.
  • 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

  • A többrégiós adatbázisfiókok támogatása hozzáadva.
  • Mostantól támogatott a szabályozott kérések automatikus újrapróbálkozá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. 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.

1.6.0

1.5.1

  • Kijavítottunk egy hibát a HashPartitionResolverben, amely kivonatértékeket hozott létre kis endian nyelven, hogy konzisztens legyen a többi SDK-val.

1.5.0

  • & Kivonattartomány partíciófeloldóinak hozzáadása az alkalmazások több partícióra történő horizontális 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.
  • Azonosítóalapú útválasztás implementálása. Nincsenek nyilvános API-módosítások, az összes belső módosítás.

1.3.0

  • A kiadás kihagyva a verziószám más SDK-khoz való igazításához

1.2.0

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

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, funkciók és optimalizálások csak az aktuális SDK-hoz lesznek hozzáadva, ezért javasoljuk, hogy mindig a lehető leghamarabb frissítsen a legújabb SDK-verzióra.

Figyelmeztetés

2020. május 30-tól az Azure Cosmos DB nem fog hibajavításokat végezni, új funkciókat ad hozzá, és nem nyújt támogatást az SQL API-hoz 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 ad hozzá, és nem nyújt támogatást az SQL API-hoz készült Azure Cosmos DB Java SDK 0.x verzióihoz. 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. 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. április 24. 2024. február 29.
2.2.3 2019. április 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. 2020. május 30.
1.11.0 2017. május 10. 2020. május 30.
1.10.0 2017. március 11. 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. 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. 2016. február 29.
0.9.2-előzetes verzió 2014. december 19. 2016. február 29.
0.9.1-előzetes verzió 2014. december 19. 2016. február 29.
0.9.0-előzetes verzió 2014. december 10. 2016. február 29.

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 az SDK-hoz vagy összekötőhöz való hozzáadáshoz?

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, küldjön visszajelzést a közösségi fórumunkra.

Lásd még

A Cosmos DB-ről a Microsoft Azure Cosmos DB szolgáltatás oldalán tekinthet meg további információt.