Sdílet prostřednictvím

Spring Data Azure Cosmos DB verze 2 pro rozhraní API for NoSQL (starší verze): Poznámky k verzi a prostředky

  • Článek

PLATÍ PRO: NoSQL

Spring Data Azure Cosmos DB verze 2 pro NoSQL umožňuje vývojářům používat azure Cosmos DB v aplikacích Spring. Spring Data Azure Cosmos DB zveřejňuje rozhraní Spring Data pro manipulaci s databázemi a kolekcemi, práci s dokumenty a vydávání dotazů. Synchronizační i asynchronní (reaktivní) rozhraní API se podporují ve stejném artefaktu Mavenu.

Upozorňující

Tato verze sady Spring Data Azure Cosmos DB SDK závisí na vyřazené verzi sady Java SDK služby Azure Cosmos DB. Tato sada Spring Data SDK služby Azure Cosmos DB bude oznámena jako vyřazení v blízké budoucnosti. Nejedná se o nejnovější sadu AZURE Spring Data SDK služby Azure Cosmos DB pro Azure Cosmos DB a je zastaralá. Kvůli problémům s výkonem a nestabilitě v sadě Azure Spring Data SDK služby Azure Cosmos DB V2 důrazně doporučujeme pro váš projekt použít Azure Spring Data Azure Cosmos DB v5 . Pokud chcete upgradovat, postupujte podle pokynů v příručce Migrate to Azure Cosmos DB Java SDK v4 a seznamte se s rozdílem v podkladové sadě Java SDK V4.

Spring Framework je programovací a konfigurační model, který zjednodušuje vývoj aplikací v Javě. Spring zjednodušuje "instalaci" aplikací pomocí injektáže závislostí. Mnoho vývojářů, jako je Spring, protože usnadňuje sestavování a testování aplikací. Spring Boot rozšiřuje toto zpracování instalatérů o pohled na vývoj webových aplikací a mikroslužeb. Spring Data je programovací model pro přístup k úložištím dat, jako je Azure Cosmos DB z kontextu aplikace Spring nebo Spring Boot.

Spring Data Azure Cosmos DB můžete použít ve svých aplikacích hostovaných v Azure Spring Apps.

Důležité

Tyto poznámky k verzi jsou určené pro verzi 2 služby Spring Data Azure Cosmos DB. Poznámky k verzi pro verzi 3 najdete tady.

Spring Data Azure Cosmos DB podporuje pouze rozhraní API pro NoSQL.

Informace o Spring Data v dalších rozhraních API služby Azure Cosmos DB najdete v následujících článcích:

Chcete se rychle chystnout?

  1. Nainstalujte minimální podporovaný modul runtime Java, sadu JDK 8, abyste mohli použít sadu SDK.
  2. Pomocí úvodní sady vytvořte aplikaci Spring Data Azure Cosmos DB. Je to snadné!
  3. Projděte si příručku pro vývojáře služby Spring Data Azure Cosmos DB, která vás provede základními požadavky azure Cosmos DB.

Aplikace Spring Boot Starter můžete rychle aktivovat pomocí Aplikace Spring Initializr!

Zdroje informací

Prostředek Odkaz
Stažení sady SDK Maven
Dokumentace k rozhraní API Referenční dokumentace ke službě Spring Data Azure Cosmos DB
Přispívání do sady SDK Úložiště Spring Data Azure Cosmos DB na GitHubu
Úvodní sada Spring Boot Klientská knihovna Spring Boot Starter pro Azure Cosmos DB pro Javu
Průvodce vývojáře Příručka pro vývojáře ve službě Spring Data Azure Cosmos DB
Použití úvodní sady Použití úvodní sady Spring Boot se službou Azure Cosmos DB for NoSQL
Úložiště GitHub pro úvodní sadu Spring Boot služby Azure Cosmos DB
Ukázka se službou Aplikace Azure Service Jak používat Spring a Azure Cosmos DB s App Service v Linuxu

Historie vydaných verzí

2.3.0 (21. května 2020)

Nové funkce

  • Aktualizuje verzi Spring Boot na verzi 2.3.0.

2.2.5 (19. května 2020)

Nové funkce

  • Aktualizuje verzi služby Azure Cosmos DB na verzi 3.7.3.

Opravy klíčových chyb

  • Obsahuje opravy nevracení paměti a upgrady verzí Netty ze sady Azure Cosmos DB SDK 3.7.3.

2.2.4 (6. dubna 2020)

Opravy klíčových chyb

  • Opravuje allowTelemetry příznak, který se má vzít v úvahu z CosmosDbConfig.
  • Opravuje TTL vlastnost kontejneru.

2.2.3 (25. února 2020)

Nové funkce

  • Přidá nové findAll rozhraní API klíče oddílu.
  • Aktualizuje verzi služby Azure Cosmos DB na verzi 3.7.0.

Opravy klíčových chyb

  • Opravy collectionName ->containerName
  • Opravy entityClass a domainClass ->domainType.
  • Opravili jsme chybu "Vrácení kolekce entit uložené v úložišti místo vstupní entity".

2.1.10 (25. února 2020)

Opravy klíčových chyb

  • Oprava backportů pro "Vrácení kolekce entit uložené v úložišti místo vstupní entity".

2.2.2 (15. ledna 2020)

Nové funkce

  • Aktualizuje verzi služby Azure Cosmos DB na verzi 3.6.0.

Opravy klíčových chyb

2.2.1 (31. prosince 2019)

Nové funkce

  • Aktualizuje sadu SDK služby Azure Cosmos DB na verzi 3.5.0.
  • Přidá pole poznámek pro povolení nebo zakázání automatického vytváření kolekce.
  • Zlepšuje zpracování výjimek. Zpřístupňuje CosmosClientException prostřednictvím CosmosDBAccessException.
  • Zpřístupňuje requestCharge a activityId prochází ResponseDiagnostics.

Opravy klíčových chyb

  • Aktualizace SADY SDK 3.5.0 opravuje výjimku, pokud je hlavička odpovědi HTTP služby Azure Cosmos DB větší než 8192 bajtů, chyba ConsistencyPolicy.defaultConsistencyLevel() u omezené nestarosti a konzistentní předpony.
  • Opravuje findById chování metody. Dříve tato metoda vrátila prázdnou, pokud entita nebyla nalezena místo vyvolání výjimky.
  • Opraví chybu, při které se při použití nepoužilo řazení na další stránce CosmosPageRequest .

2.1.9 (26. prosince 2019)

Nové funkce

  • Přidá pole poznámek pro povolení nebo zakázání automatického vytváření kolekce.

Opravy klíčových chyb

  • Opravuje findById chování metody. Dříve tato metoda vrátila prázdnou, pokud entita nebyla nalezena místo vyvolání výjimky.

2.2.0 (21. října 2019)

Nové funkce

  • Dokončete podporu reaktivního úložiště Azure Cosmos DB.
  • Podpora diagnostických řetězců žádostí azure Cosmos DB a metrik dotazů
  • Aktualizace verze sady SDK služby Azure Cosmos DB na verzi 3.3.1
  • Upgrade verze Spring Frameworku na verzi 5.2.0.RELEASE
  • Upgrade verze Spring Data Commons na verzi 2.2.0.RELEASE
  • Přidává findByIdAndPartitionKey a deleteByIdAndPartitionKey rozhraní API.
  • Odebere závislost z azure-documentdb.
  • Rebrands DocumentDB to Azure Cosmos DB.

Opravy klíčových chyb

  • Opravili jsme chybu "Řazení vyvolá výjimku, když pageSize je menší než celkový počet položek v úložišti.".

2.1.8 (18. října 2019)

Nové funkce

  • Zastará rozhraní API DocumentDB.
  • Přidává findByIdAndPartitionKey a deleteByIdAndPartitionKey rozhraní API.
  • Přidá optimistické uzamčení na _etagzákladě .
  • Povolí výraz SpEL pro název kolekce dokumentů.
  • Přidává ObjectMapper vylepšení.

2.1.7 (18. října 2019)

Nové funkce

  • Přidá závislost sady SDK služby Azure Cosmos DB verze 3.
  • Přidá reaktivní úložiště Azure Cosmos DB.
  • Aktualizuje implementaci DocumentDbTemplate použití sady SDK služby Azure Cosmos DB verze 3.
  • Přidá další změny konfigurace pro podporu reaktivního úložiště Azure Cosmos DB.

2.1.2 (19. března 2019)

Opravy klíčových chyb

  • Odebere applicationInsights závislost pro:
    • Potenciální riziko znečišťování závislostí.
    • Nekompatibilita Java 11
    • Vyhněte se potenciálnímu dopadu na výkon procesoru nebo paměti.

2.0.7 (20. března 2019)

Opravy klíčových chyb

  • Backport odebere applicationInsights závislost pro:
    • Potenciální riziko znečišťování závislostí.
    • Nekompatibilita Java 11
    • Vyhněte se potenciálnímu dopadu na výkon procesoru nebo paměti.

2.1.1 (7. března 2019)

Nové funkce

  • Aktualizuje hlavní verzi na verzi 2.1.1.

2.0.6 (7. března 2019)

Nové funkce

  • Ignorujte všechny výjimky z telemetrie.

2.1.0 (17. prosince 2018)

Nové funkce

  • Aktualizuje verzi na verzi 2.1.0, aby se vyřešil problém.

2.0.5 (13. září 2018)

Nové funkce

  • Přidá klíčová slova exists a startsWith.
  • Aktualizuje soubor Readme.

Opravy klíčových chyb

  • Opravuje chybu "Nejde volat self href přímo pro entitu".
  • Opravy příkazu findAll selžou, pokud se kolekce nevytvoří.

2.0.4 (Předběžná verze) (23. srpna 2018)

Nové funkce

  • Přejmenuje balíček z documentdb na cosmosdb.
  • Přidá novou funkci klíčového slova metody dotazu. Nyní se podporuje 16 klíčových slov z rozhraní API pro NoSQL.
  • Přidá novou funkci dotazu se stránkováním a řazením.
  • Zjednodušuje konfiguraci spring-data-cosmosdb.
  • Přidává deleteCollection a deleteAll rozhraní API.

Opravy klíčových chyb

  • Oprava chyb a zmírnění chyb

Často kladené 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.

Další kroky

Přečtěte si další informace o službě Azure Cosmos DB.

Přečtěte si další informace o spring frameworku.

Přečtěte si další informace o Spring Bootu.

Přečtěte si další informace o Spring Data.