Spring Data Azure Cosmos DB v2 for API for NoSQL (starsza wersja): informacje o wersji i zasoby

  • Artykuł

DOTYCZY: NoSQL

Usługa Spring Data Azure Cosmos DB w wersji 2 dla bazy danych NoSQL umożliwia deweloperom korzystanie z usługi Azure Cosmos DB w aplikacjach Spring. Usługa Spring Data w usłudze Azure Cosmos DB uwidacznia interfejs Spring Data do manipulowania bazami danych i kolekcjami, pracy z dokumentami i wystawiania zapytań. Interfejsy API synchronizacji i asynchronicznego (reaktywnego) są obsługiwane w tym samym artefaktzie narzędzia Maven.

Ostrzeżenie

Ta wersja zestawu SDK usługi Azure Cosmos DB platformy Spring Data zależy od wycofanej wersji zestawu Java SDK usługi Azure Cosmos DB. Ten zestaw SDK usługi Azure Cosmos DB spring Data zostanie ogłoszony na emeryturę w najbliższej przyszłości! To nie jest najnowsza wersja zestawu AZURE Spring Data Azure Cosmos DB SDK dla usługi Azure Cosmos DB i jest nieaktualna. Ze względu na problemy z wydajnością i niestabilność zestawu Azure Spring Data Azure Cosmos DB SDK w wersji 2 zdecydowanie zalecamy używanie usługi Azure Spring Data Azure Cosmos DB w wersji 3 dla projektu. Aby przeprowadzić uaktualnienie, postępuj zgodnie z instrukcjami w przewodniku Migrate to Azure Cosmos DB Java SDK v4 (Migrowanie do zestawu Java SDK w wersji 4), aby zrozumieć różnicę w podstawowym zestawie JAVA SDK w wersji 4 .

Platforma Spring Framework to model programowania i konfiguracji, który usprawnia tworzenie aplikacji w języku Java. Spring usprawnia "hydraulikę" aplikacji przy użyciu wstrzykiwania zależności. Wielu deweloperów, takich jak Spring, ponieważ sprawia, że kompilowanie i testowanie aplikacji jest prostsze. Spring Boot rozszerza tę obsługę instalacji hydraulicznej z myślą o tworzeniu aplikacji internetowych i mikrousług. Spring Data to model programowania umożliwiający uzyskiwanie dostępu do magazynów danych, takich jak Usługa Azure Cosmos DB z kontekstu aplikacji Spring lub Spring Boot.

Usługi Spring Data Azure Cosmos DB można używać w aplikacjach hostowanych w usłudze Azure Spring Apps.

Ważne

Te informacje o wersji dotyczą wersji 2 usługi Spring Data Azure Cosmos DB. Informacje o wersji dla wersji 3 można znaleźć tutaj.

Usługa Spring Data w usłudze Azure Cosmos DB obsługuje tylko interfejs API dla noSQL.

Zapoznaj się z następującymi artykułami, aby uzyskać informacje o usłudze Spring Data w innych interfejsach API usługi Azure Cosmos DB:

Chcesz szybko przejść?

  1. Zainstaluj minimalne obsługiwane środowisko uruchomieniowe Java JDK 8, aby można było użyć zestawu SDK.
  2. Utwórz aplikację Spring Data w usłudze Azure Cosmos DB przy użyciu szablonu startowego. To łatwe!
  3. Zapoznaj się z przewodnikiem dla deweloperów usługi Azure Cosmos DB dotyczącym usługi Spring Data, który przeprowadzi Cię przez podstawowe żądania usługi Azure Cosmos DB.

Aplikacje startowe Spring Boot można szybko uruchomić przy użyciu narzędzia Spring Initializr!

Zasoby

Zasób Link
Zestaw SDK do pobrania Maven
Dokumentacja interfejsu API Dokumentacja referencyjna usługi Azure Cosmos DB dotycząca usługi Spring Data
Współtworzenie zestawu SDK Repozytorium Spring Data w usłudze Azure Cosmos DB w usłudze GitHub
Spring Boot Starter Biblioteka klienta Spring Boot starter usługi Azure Cosmos DB dla języka Java
Przewodnik dewelopera Przewodnik dewelopera usługi Azure Cosmos DB dotyczący usługi Spring Data
Korzystanie z szablonu startowego Jak używać szablonu startowego Spring Boot z usługą Azure Cosmos DB for NoSQL
Repozytorium GitHub dla szablonu startowego Spring Boot usługi Azure Cosmos DB
Przykład z usługą aplikacja systemu Azure Jak używać platformy Spring i usługi Azure Cosmos DB z usługą App Service dla systemu Linux

Historia wersji

2.3.0 (21 maja 2020 r.)

Nowe funkcje

  • Aktualizacje wersji Spring Boot do wersji 2.3.0.

2.2.5 (19 maja 2020 r.)

Nowe funkcje

  • Aktualizacje wersję usługi Azure Cosmos DB do wersji 3.7.3.

Najważniejsze poprawki błędów

  • Zawiera poprawki przecieków pamięci i uaktualnienia wersji netty z zestawu Azure Cosmos DB SDK 3.7.3.

2.2.4 (6 kwietnia 2020 r.)

Najważniejsze poprawki błędów

  • Flaga poprawek allowTelemetry do uwzględnienia z CosmosDbConfigelementu .
  • TTL Naprawia właściwość w kontenerze.

2.2.3 (25 lutego 2020 r.)

Nowe funkcje

  • Dodaje nowy findAll przez interfejs API klucza partycji.
  • Aktualizacje do wersji 3.7.0 usługi Azure Cosmos DB.

Najważniejsze poprawki błędów

  • Poprawki collectionName —>containerName .
  • Poprawki entityClass i domainClass ->domainType.
  • Poprawki "Zwracanie kolekcji jednostek zapisanych przez repozytorium zamiast jednostki wejściowej".

2.1.10 (25 lutego 2020 r.)

Najważniejsze poprawki błędów

  • Poprawki backports dla "Zwracanie kolekcji jednostek zapisanych przez repozytorium zamiast jednostki wejściowej".

2.2.2 (15 stycznia 2020 r.)

Nowe funkcje

  • Aktualizacje wersję usługi Azure Cosmos DB do wersji 3.6.0.

Najważniejsze poprawki błędów

2.2.1 (31 grudnia 2019 r.)

Nowe funkcje

  • Aktualizacje zestaw SDK usługi Azure Cosmos DB do wersji 3.5.0.
  • Dodaje pole adnotacji w celu włączenia lub wyłączenia automatycznego tworzenia kolekcji.
  • Poprawia obsługę wyjątków. Uwidacznia CosmosClientException za pośrednictwem polecenia CosmosDBAccessException.
  • Uwidacznia requestCharge i activityId za pośrednictwem ResponseDiagnostics.

Najważniejsze poprawki błędów

  • Aktualizacja zestawu SDK 3.5.0 naprawia błędy "Wyjątek, gdy nagłówek odpowiedzi HTTP usługi Azure Cosmos DB jest większy niż 8192 bajtów", "ConsistencyPolicy.defaultConsistencyLevel() kończy się niepowodzeniem w przypadku nieaktualności powiązanej i spójnego prefiksu".
  • findById Naprawia zachowanie metody. Wcześniej ta metoda zwróciła wartość pustą, jeśli jednostka nie została znaleziona, zamiast zgłaszać wyjątek.
  • Naprawia usterkę, w której sortowanie nie zostało zastosowane na następnej stronie, gdy CosmosPageRequest zostało użyte.

2.1.9 (26 grudnia 2019 r.)

Nowe funkcje

  • Dodaje pole adnotacji w celu włączenia lub wyłączenia automatycznego tworzenia kolekcji.

Najważniejsze poprawki błędów

  • findById Naprawia zachowanie metody. Wcześniej ta metoda zwróciła wartość pustą, jeśli jednostka nie została znaleziona, zamiast zgłaszać wyjątek.

2.2.0 (21 października 2019 r.)

Nowe funkcje

  • Pełna obsługa reaktywnego repozytorium usługi Azure Cosmos DB.
  • Obsługa ciągów diagnostycznych żądań usługi Azure Cosmos DB i metryk zapytań.
  • Aktualizacja wersji zestawu SDK usługi Azure Cosmos DB do wersji 3.3.1.
  • Uaktualnienie wersji platformy Spring Framework do wersji 5.2.0.RELEASE.
  • Uaktualnienie wersji spring Data Commons do wersji 2.2.0.RELEASE.
  • Dodaje findByIdAndPartitionKey i deleteByIdAndPartitionKey interfejsy API.
  • Usuwa zależność z usługi azure-documentdb.
  • Zmienia nazwę usługi DocumentDB na usługę Azure Cosmos DB.

Najważniejsze poprawki błędów

  • Poprawki "Sortowanie zgłasza wyjątek, gdy pageSize jest mniejsza niż łączna liczba elementów w repozytorium".

2.1.8 (18 października 2019 r.)

Nowe funkcje

  • Oznacza przestarzałe interfejsy API usługi DocumentDB.
  • Dodaje findByIdAndPartitionKey i deleteByIdAndPartitionKey interfejsy API.
  • Dodaje optymistyczne blokowanie na podstawie elementu _etag.
  • Włącza wyrażenie SpEL dla nazwy kolekcji dokumentów.
  • Dodaje ObjectMapper ulepszenia.

2.1.7 (18 października 2019 r.)

Nowe funkcje

  • Dodaje zależność zestawu SDK usługi Azure Cosmos DB w wersji 3.
  • Dodaje reaktywne repozytorium usługi Azure Cosmos DB.
  • Aktualizacje implementacja zestawu DocumentDbTemplate SDK usługi Azure Cosmos DB w wersji 3.
  • Dodaje inne zmiany konfiguracji dla obsługi reaktywnego repozytorium usługi Azure Cosmos DB.

2.1.2 (19 marca 2019 r.)

Najważniejsze poprawki błędów

  • applicationInsights Usuwa zależność dla:
    • Potencjalne ryzyko zanieczyszczania zależności.
    • Niezgodność języka Java 11.
    • Unikanie potencjalnego wpływu na wydajność procesora CPU i/lub pamięci.

2.0.7 (20 marca 2019 r.)

Najważniejsze poprawki błędów

  • Backport usuwa applicationInsights zależność dla:
    • Potencjalne ryzyko zanieczyszczania zależności.
    • Niezgodność języka Java 11.
    • Unikanie potencjalnego wpływu na wydajność procesora CPU i/lub pamięci.

2.1.1 (7 marca 2019 r.)

Nowe funkcje

  • Aktualizacje wersji głównej do wersji 2.1.1.

2.0.6 (7 marca 2019 r.)

Nowe funkcje

  • Ignoruj wszystkie wyjątki z telemetrii.

2.1.0 (17 grudnia 2018 r.)

Nowe funkcje

  • Aktualizacje wersji do wersji 2.1.0, aby rozwiązać problem.

2.0.5 (13 września 2018 r.)

Nowe funkcje

  • Dodaje słowa kluczowe exists i startsWith.
  • Aktualizacje Readme.

Najważniejsze poprawki błędów

  • Poprawki "Nie można wywołać samodzielnego elementu href bezpośrednio dla jednostki".
  • Poprawki "findAll nie powiedzie się, jeśli kolekcja nie zostanie utworzona".

2.0.4 (wersja wstępna) (23 sierpnia 2018 r.)

Nowe funkcje

  • Zmienia nazwę pakietu z documentdb na cosmosdb.
  • Dodaje nową funkcję słowa kluczowego metody zapytania. 16 słów kluczowych z interfejsu API dla noSQL jest teraz obsługiwanych.
  • Dodaje nową funkcję zapytania z stronicowaniem i sortowaniem.
  • Upraszcza konfigurację bazy danych spring-data-cosmosdb.
  • Dodaje deleteCollection i deleteAll interfejsy API.

Najważniejsze poprawki błędów

  • Naprawianie usterek i ograniczanie ryzyka wad.

Często zadawane pytania

W jaki sposób będę otrzymywać powiadomienia o wycofywanym zestawie SDK?

Firma Microsoft wyśle powiadomienie na 12 miesięcy przed zakończeniem obsługi wycofywanego zestawu SDK, aby ułatwić bezproblemowe przejście do obsługiwanego zestawu SDK. Powiadomimy Cię za pośrednictwem różnych kanałów komunikacyjnych: witryny Azure Portal, aktualizacji platformy Azure i komunikacji bezpośredniej z przypisanymi administratorami usług.

Czy w ciągu tego 12-miesięcznego okresu mogę tworzyć aplikacje przy użyciu zestawu SDK Azure Cosmos DB?

Tak, w ciągu tego 12-miesięcznego okresu będziesz mieć możliwość tworzenia, wdrażania i modyfikowania aplikacji przy użyciu wycofywanego zestawu SDK Azure Cosmos DB. Zalecamy migrację do nowej obsługiwanej wersji zestawu SDK Azure Cosmos DB w ciągu tego 12-miesięcznego okresu zgodnie z potrzebami.

Co się stanie z aplikacjami korzystającymi z nieobsługiwanego zestawu SDK Azure Cosmos DB po jego wycofaniu?

Po dacie wycofania zespół Azure Cosmos DB nie będzie już opracowywał poprawek błędów, dodawał nowych funkcji ani zapewniał pomocy technicznej dla wycofanych wersji zestawu SDK. Jeśli nie chcesz przeprowadzać uaktualnienia, żądania wysyłane z wycofanej wersji zestawu SDK będą nadal obsługiwane przez usługę Azure Cosmos DB.

Które wersje zestawu SDK będą mieć najnowsze funkcje i aktualizacje?

Nowe funkcje i aktualizacje będą dodawane tylko do najnowszej wersji pomocniczej najnowszej obsługiwanej wersji zestawu SDK. Zalecamy używanie najnowszej wersji, aby korzystać z nowych funkcji, ulepszeń wydajności i poprawek błędów. Jeśli używasz starej, niewycofanej wersji zestawu SDK, żądania wysyłane do usługi Azure Cosmos DB będą nadal działać, ale nie będziesz mieć dostępu do żadnych nowych funkcji.

Co zrobić, jeśli nie mogę zaktualizować aplikacji przed datą progową?

Zalecamy przeprowadzenie uaktualnienia do najnowszej wersji zestawu SDK tak szybko, jak to możliwe. Gdy zestaw SDK zostanie oznaczony do wycofania, będziesz mieć 12 miesięcy na zaktualizowanie swojej aplikacji. Jeśli nie uda Ci się wykonać aktualizacji przed datą wycofania, żądania wysyłane z wycofanych wersji zestawu SDK nadal będą obsługiwane przez usługę Azure Cosmos DB, a zatem Twoje uruchomione aplikacje będą nadal działać. Jednak zespół Azure Cosmos DB nie będzie już opracowywał poprawek błędów, dodawał nowych funkcji ani zapewniał pomocy technicznej dla wycofanych wersji zestawu SDK.

Jeśli masz plan pomocy technicznej i potrzebujesz pomocy technicznej, skontaktuj się z nami, tworząc bilet pomocy technicznej.

Jak mogę zażądać dodania funkcji do zestawu SDK lub łącznika?

Nowe funkcje nie zawsze są natychmiast dodawane do każdego zestawu SDK lub łącznika. Jeśli funkcja nie jest obsługiwana, którą chcesz dodać, dodaj opinię do naszego forum społeczności.

Następne kroki

Dowiedz się więcej o usłudze Azure Cosmos DB.

Dowiedz się więcej na temat platformy Spring Framework.

Dowiedz się więcej na temat platformy Spring Boot.

Dowiedz się więcej o usłudze Spring Data.