Sdílet prostřednictvím

Sada Azure Cosmos DB for NoSQL Java SDK (starší verze): Poznámky k verzi a prostředky

  • Článek

PLATÍ PRO: NoSQL

Tento článek se zabývá sadou Java SDK pro synchronizaci služby Azure Cosmos DB v2 pro rozhraní API for NoSQL. Toto rozhraní API podporuje pouze synchronní operace.

Důležité

Nejedná se o nejnovější sadu Java SDK pro službu Azure Cosmos DB! Důrazně doporučujeme pro váš projekt použít sadu Java SDK služby Azure Cosmos DB v4. Pokud chcete provést upgrade, postupujte podle pokynů v průvodci migrací do sady Java SDK služby Azure Cosmos DB v4 a příručky Reactor vs. RxJava .

Upozorňující

Od 29. února 2024 je sada Java SDK služby Azure Cosmos DB Sync v2.x vyřazena. Azure Cosmos DB už po vyřazení této sady SDK neposkytuje údržbu ani podporu. Pokud chcete migrovat na sadu Java SDK služby Azure Cosmos DB verze 4, postupujte podle zde uvedených pokynů.

Odkazy
Stažení sady SDK Maven
Dokumentace k rozhraní API Referenční dokumentace k rozhraní Java API
Přispívání do sady SDK GitHub
Začínáme Začínáme se sadou Java SDK
Kurz k webové aplikaci Vývoj webových aplikací pomocí služby Azure Cosmos DB
Minimální podporovaný modul runtime Java Development Kit (JDK) 7 a novější

Poznámky k verzi

Tady jsou poznámky k verzi pro každou verzi sady SDK.

2.6.5

  • Odebrání závislosti com.google.guava/guava testu kvůli ohrožením zabezpečení
  • Upgrade závislosti com.fasterxml.jackson.core/jackson-databind na verzi 2.14.0
  • Upgradovaná závislost commons-codec/commons-codec na verzi 1.15
  • Upgradovaná závislost org.json/json na 20180130

2.6.4

  • Oprava zásad opakování pro vypršení časových limitů čtení

2.6.3

  • Opravili jsme zásadu opakování při GoneException zabalení IllegalStateException – tato změna je nezbytná k tomu, aby se při dělení oddílů aktualizovala mezipaměť brány na 410, aby konektor Sparku (pro Spark 2.4) mohl použít vlastní zásadu opakování, aby bylo možné úspěšně provádět dotazy během dělení oddílů.

2.6.2

  • Přidání nové zásady opakování pro opakování při vypršení časového limitu čtení
  • Upgrade závislosti com.fasterxml.jackson.core/jackson-databind na verzi 2.9.10.8
  • Upgrade závislosti org.apache.httpcomponents/httpclient na verzi 4.5.13

2.6.1

  • Opravili jsme chybu při zpracování dotazu prostřednictvím spolupráce služby.

2.6.0

  • Přidání podpory pro dotazování kanálu změn z bodu v čase

2.5.1

  • Řeší problém s mezipamětí primárních oddílů v dotazu documentCollection.

2.5.0

  • Přidání podpory pro 449 opakování vlastní konfigurace

2.4.7

  • Řeší problém s vypršením časového limitu fondu připojení.
  • Opravuje aktualizaci ověřovacího tokenu při interních opakováních.

2.4.6

  • Aktualizace správné značky zásad repliky na straně klienta pro databaseAccount a nastavení konfigurace databaseAccount se čte z mezipaměti.

2.4.5

  • Pokud uživatel poskytuje pkRangeId, tato verze se vyhne opakování při chybě neplatného rozsahu klíčů oddílu.

2.4.4

  • Optimalizované aktualizace mezipaměti rozsahu klíčů oddílu
  • Opravuje scénář, kdy sada SDK nezbaví rady rozdělení oddílů ze serveru a vede k nesprávné aktualizaci mezipaměti směrování na straně klienta.

2.4.2

  • Optimalizované aktualizace mezipaměti kolekce.

2.4.1

  • Přidání podpory pro načtení vnitřní zprávy o výjimce z diagnostického řetězce požadavku

2.4.0

  • Zavedli jsme rozhraní API verze v PartitionKeyDefinition.

2.3.0

  • Přidání samostatné podpory časového limitu pro přímý režim

2.2.3

  • Využívání chybové zprávy s hodnotou null ze služby a vytvoření výjimky klienta dokumentu

2.2.2

  • Vylepšení připojení soketu, přidání SoKeepAlive výchozí true.

2.2.0

  • Byla přidána podpora diagnostických řetězců požadavků.

2.1.3

  • Opravili jsme chybu v PartitionKey pro hash V2.

2.1.2

  • Přidání podpory složených indexů
  • Opravili jsme chybu globálního správce koncových bodů, která vynutil aktualizaci.
  • Opravili jsme chybu pro operace upsertování s předběžnými předpoklady v přímém režimu.

2.1.1

  • Opravili jsme chybu v mezipaměti adres brány.

2.1.0

  • Podpora zápisů do více oblastí byla přidána pro přímý režim.
  • Přidání podpory pro zpracování IOExceptions vyvolané jako ServiceUnavailable výjimky z proxy serveru
  • Opravili jsme chybu v zásadách opakování zjišťování koncových bodů.
  • Opravili jsme chybu, která zajistila, že výjimky ukazatele null nebyly vyvolány v BaseDatabaseAccountConfigurationProvider.
  • Opravili jsme chybu, která zajistila, že QueryIterator nevrací hodnoty null.
  • Opravili jsme chybu, která zajistila, že je povolený klíč velkého oddílu.

2.0.0

  • Podpora zápisů do více oblastí je přidaná pro režim brány.

1.16.4

  • Opravili jsme chybu v rozsazích klíče oddílu pro čtení dotazu.

1.16.3

  • Opravili jsme chybu v nastavení velikosti hlavičky tokenu pokračování v režimu DirectHttps.

1.16.2

  • Přidali jsme podporu převzetí služeb při selhání streamování.
  • Přidání podpory pro vlastní metadata
  • Vylepšená logika zpracování relací
  • Opravili jsme chybu v mezipaměti rozsahu klíčů oddílu.
  • NullPointerException Opravili jsme chybu (NPE) v přímém režimu.

1.16.1

  • Byla přidána podpora pro jedinečný index.
  • Přidání podpory pro omezení velikosti tokenu pokračování v možnostech informačního kanálu
  • Opravili jsme chybu v serializaci JSON (časové razítko).
  • Opravili jsme chybu v serializaci JSON (výčet).
  • Závislost na com.fasterxml.jackson.core:jackson-databind byla upgradována na verzi 2.9.5.

1.16.0

  • Vylepšené sdružování připojení pro přímý režim
  • Vylepšené vylepšení předběžného načtení pro dotaz mezi oddíly, které nejsou v pořadí.
  • Vylepšené generování UUID
  • Vylepšená logika konzistence relace
  • Přidání podpory pro multipolygon
  • Přidání podpory pro statistiku rozsahu klíčů oddílu pro kolekci
  • Opravili jsme chybu v podpoře více oblastí.

1.15.0

  • Vylepšili jsme výkon serializace JSON.
  • Tato verze sady SDK vyžaduje nejnovější verzi emulátoru služby Azure Cosmos DB.

1.14.0

  • Interní změny knihoven přátel Microsoftu

1.13.0

  • Opravili jsme problém při čtení rozsahů klíčů s jedním oddílem.
  • Opravili jsme problém s parsováním RESOURCEID, který se týká databáze s krátkými názvy.
  • Opravili jsme problém s kódováním klíče oddílu.

1.12.0

  • Opravy kritických chyb zpracování požadavků během dělení oddílů.
  • Opravili jsme problém s úrovněmi konzistence strong a boundedStaleness.

1.11.0

  • Přidání podpory pro novou úroveň konzistence s názvem ConsistentPrefix.
  • Opravili jsme chybu v kolekci čtení v režimu relace.

1.10.0

  • Povolená podpora dělené kolekce s minimálním než 2 500 RU/s a škálováním v přírůstcích po 100 RU/s.
  • Opraví chybu v nativním sestavení, která může v některých dotazech způsobit výjimku NullRef.

1.9.6

  • Opravili jsme chybu v konfiguraci dotazovacího stroje, která mohla způsobovat výjimky dotazů v režimu brány.
  • Opravili jsme několik chyb v kontejneru relací, které mohly způsobit výjimku "Prostředek vlastníka se nenašel" pro žádosti okamžitě po vytvoření kolekce.

1.9.5

  • Přidání podpory pro agregační dotazy (COUNT, MIN, MAX, SUM a AVG).
  • Byla přidána podpora kanálu změn.
  • Přidání podpory pro informace o kvótě kolekce prostřednictvím RequestOptions.setPopulateQuotaInfo.
  • Přidání podpory pro protokolování skriptu uložené procedury prostřednictvím RequestOptions.setScriptLoggingEnabled.
  • Opravili jsme chybu, kdy dotaz v režimu DirectHttps mohl přestat reagovat při výskytu selhání omezování.
  • Opravili jsme chybu v režimu konzistence relace.
  • Opravili jsme chybu, která může způsobit chybu NullReferenceException v httpContext, pokud je rychlost požadavků vysoká.
  • Vylepšený výkon režimu DirectHttps

1.9.4

  • Přidání jednoduché podpory proxy serveru na základě instance klienta s využitím rozhraní ConnectionPolicy.setProxy() API
  • Přidání rozhraní DocumentClient.close() API pro správné zavření instance DocumentClient
  • Vylepšený výkon dotazů v režimu přímého připojení odvozením plánu dotazu z nativního sestavení místo brány.
  • Nastavte FAIL_ON_UNKNOWN_PROPERTIES = false, aby uživatelé nemuseli definovat JsonIgnoreProperties ve svém prostém starém objektu Java (POJO).
  • Refaktorované protokolování pro použití SLF4J
  • Opravili jsme několik dalších chyb ve čtečce konzistence.

1.9.3

  • Opravili jsme chybu ve správě připojení, která bránila únikům připojení v režimu přímého připojení.
  • Opravili jsme chybu v dotazu TOP, kdy mohlo dojít k výjimce NullReference.
  • Vylepšili jsme výkon snížením počtu síťových volání pro interní mezipaměti.
  • Přidání stavového kódu, ID aktivity a identifikátoru URI požadavku v DocumentClientException pro lepší řešení potíží

1.9.2

  • Opravili jsme problém se správou připojení pro stabilitu.

1.9.1

  • Přidání podpory pro úroveň konzistence BoundedStaleness
  • Přidání podpory přímého připojení pro operace CRUD pro dělené kolekce
  • Opravili jsme chybu při dotazování databáze pomocí SQL.
  • Opravili jsme chybu v mezipaměti relace, kdy se token relace mohl nastavit nesprávně.

1.9.0

  • Přidání podpory paralelních dotazů napříč oddíly
  • Přidání podpory pro dotazy TOP/ORDER BY pro dělené kolekce
  • Přidání podpory pro silnou konzistenci
  • Přidání podpory pro požadavky založené na názvech při použití přímého připojení
  • Bylo opraveno, že id aktivity zůstává konzistentní napříč všemi opakováními požadavků.
  • Opravili jsme chybu související s mezipamětí relace při opětovném vytvoření kolekce se stejným názvem.
  • Přidání datových typů Polygon a LineString při zadávání zásad indexování kolekce pro prostorové dotazy geografického ohraničení
  • Opravili jsme problémy s dokumentem Java pro Javu 1.8.

1.8.1

  • Opravili jsme chybu v Objektu PartitionKeyDefinitionMap pro ukládání kolekcí s jedním oddílem do mezipaměti a nezáslili další požadavky na klíč oddílu.
  • Opravili jsme chybu, která se neopakuje při zadání nesprávné hodnoty klíče oddílu.

1.8.0

  • Přidali jsme podporu pro účty databáze s více oblastmi.
  • Přidání podpory automatického opakování u omezených požadavků s možnostmi přizpůsobení maximálního počtu pokusů o opakování a maximální doby čekání opakování Další informace naleznete v tématu RetryOptions a ConnectionPolicy.getRetryOptions().
  • Zastaralý vlastní kód pro dělení na základě IPartitionResolver Používejte dělené kolekce pro vyšší úložiště a propustnost.

1.7.1

  • Přidání podpory zásad opakování pro omezování rychlosti

1.7.0

  • Přidání podpory TTL (Time to Live) pro dokumenty

1.6.0

1.5.1

  • Opravili jsme chybu v HashPartitionResolveru, která generovala hodnoty hash v little-endianu tak, aby byla konzistentní s jinými sadami SDK (Software Development Kit).

1.5.0

  • Přidejte překladače oddílů hash a rozsahu, které vám pomůžou s horizontálním dělením aplikací napříč několika oddíly.

1.4.0

  • Implementujte upsert. Byly přidány nové metody upsertXXX pro podporu funkce Upsert.
  • Implementujte směrování založené na ID. Žádné změny veřejného rozhraní API, všechny změny jsou interní.

1.3.0

  • Vydání se přeskočilo, aby bylo číslo verze v souladu s jinými sadami SDK.

1.2.0

  • Podporuje geoprostorový index.
  • Ověřuje vlastnost ID pro všechny prostředky. ID prostředků nemohou obsahovat ?, , /, #, \, znaky nebo končit mezerou.
  • Přidá do ResourceResponse novou hlavičku "průběh transformace indexu".

1.1.0

  • Implementuje zásady indexování V2.

1.0.0

  • Sada GA SDK

Data vydání a vyřazení

Microsoft poskytuje oznámení alespoň 12 měsíců před vyřazením sady SDK, aby se přechod na novější nebo podporovanou verzi vyhladil. Nové funkce a funkce a optimalizace se přidávají jenom do aktuální sady SDK. Doporučujeme vždy upgradovat na nejnovější verzi sady SDK co nejdříve.

Upozorňující

Po 30. 30. 2020 už Azure Cosmos DB nebude provádět opravy chyb, přidávat nové funkce a poskytovat podporu pro verze 1.x sady Java SDK služby Azure Cosmos DB pro rozhraní API for NoSQL. Pokud nechcete provést upgrade, služba Azure Cosmos DB bude dál zpracovávat požadavky odeslané z verze 1.x sady SDK.

Po 29. únoru 2016 už Azure Cosmos DB nebude provádět opravy chyb, přidávat nové funkce a poskytovat podporu pro verze 0.x sady Java SDK služby Azure Cosmos DB pro rozhraní API for NoSQL. Pokud nechcete upgradovat, budou žádosti odeslané ze sady SDK verze 0.x dál obsluhovat služba Azure Cosmos DB.

Verze Datum vydání Datum vyřazení
2.6.1 Prosinec 17, 2020 29. února 2024
2.6.0 16. července 2020 29. února 2024
2.5.1 3. června 2020 29. února 2024
2.5.0 úterý 12. května 2020 29. února 2024
2.4.7 20. února 2020 29. února 2024
2.4.6 24. ledna 2020 29. února 2024
2.4.5 10. listopadu 2019 29. února 2024
2.4.4 24. října 2019 29. února 2024
2.4.2 26. zář 2019 29. února 2024
2.4.1 18. července 2019 29. února 2024
2.4.0 4. května 2019 29. února 2024
2.3.0 24. dubna 2019 29. února 2024
2.2.3 16. dubna 2019 29. února 2024
2.2.2 Duben 05, 2019 29. února 2024
2.2.0 27. března 2019 29. února 2024
2.1.3 13. března 2019 29. února 2024
2.1.2 09. března 2019 29. února 2024
2.1.1 Prosinec 13, 2018 29. února 2024
2.1.0 20. listopadu 2018 29. února 2024
2.0.0 21. září 2018 29. února 2024
1.16.4 10. září 2018 30. května 2020
1.16.3 9. září 2018 30. května 2020
1.16.2 29. června 2018 30. května 2020
1.16.1 16. května 2018 30. května 2020
1.16.0 15. března 2018 30. května 2020
1.15.0 14. listopadu 2017 30. května 2020
1.14.0 28. října 2017 30. května 2020
1.13.0 25. srpna 2017 30. května 2020
1.12.0 úterý 11. července 2017 30. května 2020
1.11.0 10. května 2017 30. května 2020
1.10.0 sobota 11. března 2017 30. května 2020
1.9.6 21. února 2017 30. května 2020
1.9.5 31. ledna 2017 30. května 2020
1.9.4 24. listopadu 2016 30. května 2020
1.9.3 30. října 2016 30. května 2020
1.9.2 28. října 2016 30. května 2020
1.9.1 26. října 2016 30. května 2020
1.9.0 3. října 2016 30. května 2020
1.8.1 30. června 2016 30. května 2020
1.8.0 14. června 2016 30. května 2020
1.7.1 30. dubna 2016 30. května 2020
1.7.0 27. dubna 2016 30. května 2020
1.6.0 29. března 2016 30. května 2020
1.5.1 čtvrtek 31. prosince 2015 30. května 2020
1.5.0 4. prosince 2015 30. května 2020
1.4.0 5. října 2015 30. května 2020
1.3.0 5. října 2015 30. května 2020
1.2.0 5. srpna 2015 30. května 2020
1.1.0 9. července 2015 30. května 2020
1.0.1 12. května 2015 30. května 2020
1.0.0 7. dubna 2015 30. května 2020
0.9.5-předběžné verze 9. března 2015 29. února 2016
0.9.4 Předběžné verze 17. února 2015 29. února 2016
0.9.3 Předběžné verze úterý 13. ledna 2015 29. února 2016
0.9.2 předběžné verze 19. prosince 2014 29. února 2016
0.9.1 předběžná verze 19. prosince 2014 29. února 2016
0.9.0-předběžné verze 10. prosince 2014 29. února 2016

Časté dotazy

Jak se dozvím o vyřazení sady SDK?

Microsoft oznámí ukončení podpory vyřazené sady SDK s 12měsíčním předstihem, aby mohlo dojít k bezproblémovému přechodu na podporovanou sadu SDK. Budeme vás informovat pomocí různých komunikačních kanálů: webu Azure Portal, aktualizací Azure a přímých zpráv určeným správcům služeb.

Můžu během těchto 12 měsíců vytvářet aplikace pomocí sady SDK Azure Cosmos DB určené k vyřazení z provozu?

Ano, během těchto 12 měsíců budete moct pomocí sady SDK Azure Cosmos DB určené k vyřazení z provozu vytvářet, nasazovat a upravovat aplikace. Doporučujeme vám během tohoto 12měsíčního období provést migraci na novější podporovanou verzi sady SDK Azure Cosmos DB.

Co se stane po datu vyřazení z provozu s aplikacemi, které používají nepodporovanou sadu SDK Azure Cosmos DB?

Po datu vyřazení už Azure Cosmos DB nebude u vyřazených verzí sady SDK provádět opravy chyb, přidávat nové funkce ani poskytovat podporu. Pokud nechcete provést upgrade, služba Azure Cosmos DB bude dál zpracovávat požadavky odeslané z vyřazených verzí sady SDK.

Které verze sady SDK budou mít nejnovější funkce a aktualizace?

Nové funkce a aktualizace se budou přidávat jenom do nejnovější podverze nejnovější podporované hlavní verze sady SDK. Doporučujeme vám vždy používat nejnovější verzi, abyste mohli využívat nové funkce, vylepšení výkonu a opravy chyb. Pokud používáte starou nevyřazenou verzi sady SDK, požadavky na Azure Cosmos DB budou pořád fungovat, ale nebudete mít přístup k žádným novým funkcím.

Co mám dělat, když nemůžu aktualizovat aplikaci před datem přerušení?

Doporučujeme vám co nejdřív provést upgrade na nejnovější sadu SDK. Jakmile označíme některou sadu SDK k vyřazení, máte na aktualizaci své aplikace ještě 12 měsíců. Pokud se vám nepodaří provést aktualizaci do data vyřazení, Azure Cosmos DB bude dál zpracovávat požadavky odeslané z vyřazených verzí sady SDK, takže vaše spuštěné aplikace budou dál fungovat. Azure Cosmos DB už ale nebude u vyřazených verzí sady SDK provádět opravy chyb, přidávat nové funkce ani poskytovat podporu.

Pokud máte plán podpory a potřebujete technickou podporu, kontaktujte nás vytvořením lístku podpory.

Jak můžu požádat o přidání funkcí do sady SDK nebo konektoru?

Nové funkce se vždy nepřidávají do každé sady SDK nebo konektoru okamžitě. Pokud není podporovaná funkce, kterou byste chtěli přidat, přidejte nám prosím svůj názor na fóru komunity.