Azure Cosmos DB API-hoz készült Java SDK SQL: 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 for SQL API, amely támogatja a szinkron műveleteket.

Fontos

Ez nem a legújabb Java SDK for Azure Cosmos DB! Fontolja meg Azure Cosmos DB Java SDK v4-es verzióját a projektjéhez. A frissítéshez kövesse a Miigrate to Azure Cosmos DB Java SDK v4 útmutató és a Reactor vs RxJava útmutató utasításait.

Fontos

  1. február 29-én a Azure Cosmos DB Sync Java SDK 2.x-es verziója ki leszvezetve; az SDK és az SDK-t használó összes alkalmazás továbbra is működni fog; Azure Cosmos DB többé nem nyújt további karbantartást és támogatást ehhez az SDK-hoz. Javasoljuk, hogy kövesse a fenti utasításokat a Java SDK v4 Azure Cosmos DB való áttelepítéshez.
Hivatkozások
SDK letöltése Maven
API-dokumentáció A Java API referenciadokumentációja
Közreműködés az SDK-ban GitHub
Első lépések Első lépések a Java SDK-val
Webalkalmazás oktatóanyag Webalkalmazás fejlesztése Azure Cosmos DB
Minimális támogatott futásidő Java fejlesztői készlet (JDK) 7+

Kibocsátási megjegyzések

2.6.3

  • Kijavítottunk egy újrapróbálkozási szabályzatot a burkolt fájlban – – ez a módosítás azért szükséges, hogy az átjáró gyorsítótára frissüljön a 410-es porton, így GoneException IllegalStateException a Spark-összekötő (a Spark 2.4-hez) egyéni újrapróbálkozási szabályzatot használhat, hogy a lekérdezések sikeresek legyenek 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áshoz
  • A függőség frissítve com.fasterxml.jackson.core/jackson-databind a 2.9.10.8-as verzióra
  • A függőség frissítve org.apache.httpcomponents/httpclient a 4.5.13-as verzióra

2.6.1

  • Ki van javítva a lekérdezések szolgáltatás-interopon keresztüli kezelése során hiba.

2.6.0

  • A változáscsatorna időpontról való lekérdezésének támogatása hozzáadva.

2.5.1

  • Kijavítja a documentCollection lekérdezés elsődleges partíciógyorsítótárával kapcsolatban problémákat.

2.5.0

  • A 449-es újrapróbálkozási egyéni konfiguráció támogatása hozzáadva.

2.4.7

  • Kijavítja 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ő újraküldetésen.

2.4.6

  • Frissült az ügyféloldali replika házirendcímkéje a databaseAccount adatbázison, és a databaseAccount konfiguráció beolvassa a gyorsítótárból.

2.4.5

  • Kerülje az újrapróbálkozásokat érvénytelen partíciókulcs-tartományhiba esetén, ha a felhasználó a pkRangeId azonosítót biztosítja.

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 particionálási tippeket ad vissza a kiszolgálóról, és helytelen ügyféloldali útválasztási gyorsítótár-frissítést ad vissza.

2.4.2

  • Frissül az optimalizált gyűjtemény-gyorsítótár.

2.4.1

  • Mostantól támogatott a belső kivételüzenet lekérése a kérelem diagnosztikai sztringből.

2.4.0

  • A PartitionKeyDefinition bevezette a verzió api-t.

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 értékű hibaüzenetek fogadása a szolgáltatástól és a dokumentum-ügyfél kivételének előállítása.

2.2.2

  • A szoftvercsatorna-kapcsolat fejlesztése, a SoKeepAlive alapértelmezett igaz érték hozzáadása.

2.2.0

  • Diagnosztikai sztringek igénylésének támogatása hozzáadva.

2.1.3

  • Javítva lett a PartitionKey hiba a kivonat v2-ben.

2.1.2

  • Az összetett indexek támogatása hozzáadva.
  • Ki lett javítva a hiba a globális végpontkezelőben a frissítés kényszerítve.
  • Kijavítva a közvetlen módban előzetes feltételekkel történő upserts hiba.

2.1.1

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

2.1.0

  • Többrépontos írási támogatás hozzáadva a közvetlen módhoz.
  • Támogatás hozzáadva a proxyról ServiceUnavailable kivételként történt IOExceptions kezeléshez.
  • Kijavítottuk a végpontfelderítés újrapróbálkozási szabályzatának egyik hibaét.
  • Kijavítottunk egy hibát, amely gondoskodott arról, hogy a Null mutató kivételei ne advaiak vissza a BaseDatabaseAccountConfigurationProviderben.
  • Ki van javítva egy hiba, amely biztosítja, hogy a QueryIterator ne ad vissza null értékeket.
  • Kijavítottunk egy hibát, amely gondoskodott arról, hogy a nagy PartitionKey engedélyezve legyen

2.0.0

  • Többrétű írási támogatás hozzáadva az átjáró üzemmódhoz.

1.16.4

  • Ki van javítva a partíciókulcs-tartományok olvasása egy lekérdezésben.

1.16.3

  • Ki van javítva a folytatási token fejlécméretének DirectHttps módban való beállításakor befejlett hiba.

1.16.2

  • Streamelési feladatátvétel támogatása hozzáadva.
  • Egyéni metaadatok támogatása hozzáadva.
  • Továbbfejlesztett munkamenet-kezelési logika.
  • Ki van javítva egy hiba 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.
  • Támogatás hozzáadva a folytatási token méretének korlátozásához a hírcsatorna beállításaiban.
  • Kijavítottunk egy hibát a JSON-szerializálásban (időbélyeg).
  • Kijavítottunk egy hibát a JSON-szerializálásban (enum).
  • Függőség a com.fasterxml.ahhoz.core:az-databind a 2.9.5-ös verzióra frissítve.

1.16.0

  • Továbbfejlesztett kapcsolatkészletezés a közvetlen módhoz.
  • Továbbfejlesztett előzetes becsatorna-fejlesztés a nem rend szerint, több partícióra vonatkozó lekérdezéssel.
  • Továbbfejlesztett UUID-generáció.
  • Továbbfejlesztett munkamenetkonzisztencia-logika.
  • Többpogonos támogatás hozzáadva.
  • Hozzá van adva a partíciókulcs-tartománystatisztikák támogatása a gyűjteményhez.
  • Kijavítottunk egy hibát a többrépontos támogatásban.

1.15.0

1.14.0

  • A Microsoft barátok könyvtárainak belső változásai.

1.13.0

  • Ki van javítva az egypartíciós kulcstartományok olvasásának problémája.
  • Kijavítottunk egy hibát a ResourceID-elemzőben, amely hatással van a rövid névvel szereplő adatbázisra.
  • Ki van javítva a partíciókulcs-kódolás által okozhatott hiba.

1.12.0

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

1.11.0

  • Új konzisztenciaszint támogatása ConsistentPrefix néven.
  • Kijavítottunk egy hibát a gyűjtemény munkamenet módban való olvasása során.

1.10.0

  • Particionált gyűjtemény támogatása engedélyezve, akár 2500 RU/s értékekkel, és skálázható 100 RU/s növekményekben.
  • 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 okozhat az átjáró módú lekérdezéseknél.
  • 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én közvetlenül a gyűjtemény létrehozása után.

1.9.5

  • Az összesítési lekérdezések (COUNT, MIN, MAX, SUM és AVG) támogatása hozzáadva. Lásd: Összesítési támogatás.
  • Változáscsatorna támogatása hozzáadva.
  • A gyűjteménykvótainformációk támogatása a RequestOptions.setPopulateQuotaInfo segítségével.
  • A tárolt eljárás szkriptnaplózásának támogatása a RequestOptions.setScriptLoggingEnabled használatával.
  • Kijavítottunk egy hibát, amely miatt a DirectHttps módban a lekérdezés nem válaszol, amikor a rendszer nem válaszol a hibakezelési hibák esetén.
  • Kijavítottunk egy hibát a munkamenet-konzisztencia módban.
  • Kijavítottunk egy hibát, amely NullReferenceException hibát okozhat a HttpContextben, ha a kérelmek sebessége 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-hoz.
  • 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ármaztatják.
  • Állítsa FAIL_ON_UNKNOWN_PROPERTIES = false értéket, hogy a felhasználóknak ne kell JsonIgnoreProperties értéket meghatározniuk a POJO-ban.
  • Újragyártott naplózás az SLF4J használatára.
  • Kijavítottunk néhány további hibát a konzisztenciaolvasóban.

1.9.3

  • Kijavítottunk egy hibát a kapcsolatkezelésben, amely megakadályozza a közvetlen kapcsolati módban történő kapcsolatszivárgást.
  • Kijavítottunk egy hibát a TOP lekérdezésben, amely nullreferencia kivételt okozhat.
  • Jobb teljesítmény a belső gyorsítótárak hálózati hívási számának csökkentésével.
  • Hozzá lett adva az állapotkód, az ActivityID és a Kérés URI a DocumentClientExceptionben a jobb hibaelhárítás érdekében.

1.9.2

  • Ki van javítva a kapcsolatkezelés stabilitási problémája.

1.9.1

  • A BoundedStaleness konzisztenciaszint támogatása hozzáadva.
  • Közvetlen kapcsolat támogatása a particionált gyűjtemények CRUD-műveleteihez.
  • Kijavítottunk egy hibát az adatbázis lekérdezésekor a SQL.
  • Kijavítottunk egy hibát a munkamenet-gyorsítótárban, amely miatt előfordulhat, hogy a munkamenet-jogkivonat helytelenül lett beállítva.

1.9.0

  • 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ései már támogatottak.
  • Az erős konzisztencia támogatása.
  • Névalapú kérések támogatása közvetlen kapcsolat használata esetén.
  • Kijavítva, hogy az ActivityId konzisztens maradjon az összes kérés-újrakérés során.
  • Kijavítottunk egy, a munkamenet-gyorsítótárral kapcsolatos hibát, amikor egy azonos nevű gyűjteményt hozunk létre újra.
  • Polygon és LineString DataTypes hozzáadva a térinformatikai lekérdezések gyűjteményindexelési szabályzatának megadása közben.
  • Kijavítottuk a Java Doc for Java 1.8 problémáit.

1.8.1

  • Ki van javítva a PartitionKeyDefinitionMap egyik hibaa, amely az egypartíciós gyűjtemények gyorsítótárazását, és nem igényel további 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

  • A többrépontos adatbázisfiókok támogatása hozzáadva.
  • Az automatikus újrapróbálkozás támogatása a lekért kérelmeken a maximális újrapróbálkozási kísérletek és a maximális újrapróbálkozási várakozási idő testreszabási lehetőségekkel. Lásd: RetryOptions és ConnectionPolicy.getRetryOptions().
  • Elavult egyéni IPartitionResolver-alapú particionálási kód. Használjon particionált gyűjteményeket a nagyobb tárterület és átviteli sebesség érdekében.

1.7.1

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

1.7.0

  • A dokumentumokhoz hozzáadva az ideje (TTL) támogatása.

1.6.0

1.5.1

  • Ki lett javítva a HashPartitionResolver egy olyan hiba, amely miatt a little-endian oszlopban kivonatértékeket generált, hogy az konzisztens legyen a többi SDK-val.

1.5.0

  • Adjon hozzá kivonatoló & tartománypartíció-feloldókat az alkalmazások több partícióra történő horizontális skálázásának támogatásához.

1.4.0

  • Az Upsert implementációja. Új upsertXXX metódusok hozzáadva az 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ő.

1.3.0

  • A kiadás kihagyva, hogy a verziószám igazodva egymáshoz igazodva egymáshoz igazodva ugorható le.

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 , végződés szóközt.
  • Új "indexátalakítási folyamat" fejléc hozzáadása a ResourceResponse erőforráshoz.

1.1.0

  • Implementálja a V2 indexelési szabályzatot

1.0.0

  • GA SDK

Kiadási és kieső 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 vannak hozzáadva, ezért javasoljuk, hogy mindig a lehető leghamarabb frissítsen a legújabb SDK-verzióra.

Figyelmeztetés

  1. május 30. után a Azure Cosmos DB nem fog hibajavításokat tenni, új funkciókat hozzáadni, és támogatást nyújtani a Azure Cosmos DB Java SDK for SQL API 1.x verzióihoz. 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.

  2. február 29-től a Azure Cosmos DB nem fog hibajavításokat tenni, új funkciókat hozzáadni, és támogatást nyújtani a Azure Cosmos DB Java SDK for SQL API 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 kiszolgálja.

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 3. 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 4. 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. április 5. 2024. február 29.
2.2.0 2019. március 27. 2024. február 29.
2.1.3 2019. március 13. 2024. február 29.
2.1.2 2019. március 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 9. 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 3. 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 4. 2020. május 30.
1.4.0 2015. október 5. 2020. május 30.
1.3.0 2015. október 5. 2020. május 30.
1.2.0 2015. augusztus 5. 2020. május 30.
1.1.0 2015. július 9. 2020. május 30.
1.0.1 2015. május 12. 2020. május 30.
1.0.0 2015. április 7. 2020. május 30.
0.9.5 előzetes 2015. március 9. 2016. február 29.
0.9.4 előzetes 2015. február 17. 2016. február 29.
0.9.3 előzetes 2015. január 13. 2016. február 29.
0.9.2 előzetes 2014. december 19. 2016. február 29.
0.9.1 előzetes 2014. december 19. 2016. február 29.
0.9.0 –előzetes 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.

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.