Versionshinweise und Ressourcen zu Spring Data Azure Cosmos DB v3 für die API für NoSQL

  • Artikel

GILT FÜR: NoSQL

Mit der Spring Data Azure Cosmos DB-Version 3 für NoSQL können Entwickler Azure Cosmos DB in Spring-Anwendungen nutzen. Bei Spring Data Azure Cosmos DB wird die Spring Data-Schnittstelle für die Bearbeitung von Datenbanken und Sammlungen, die Verwendung von Dokumenten und die Ausgabe von Abfragen verfügbar gemacht. Für dasselbe Maven-Artefakt werden sowohl synchrone als auch asynchrone (reaktive) APIs unterstützt.

Das Spring-Framework ist ein Programmier- und Konfigurationsmodell, mit dem die Java-Anwendungsentwicklung optimiert wird. Spring optimiert die „Verknüpfung“ von Anwendungen mithilfe von Abhängigkeitsinjektion. Spring ist bei vielen Entwicklern beliebt, weil dadurch das Erstellen und Testen von Anwendungen vereinfacht wird. Mit Spring Boot wird diese „Verknüpfung“ auf die Entwicklung von Webanwendungen und Microservices ausgedehnt. Spring Data ist ein Programmiermodell und -framework für den Zugriff auf Datenspeicher wie Azure Cosmos DB, im Kontext einer Spring- bzw. Spring Boot-Anwendung.

Sie können das Spring Data-Modell für Azure Cosmos DB in Ihren in Azure Spring Apps gehosteten Anwendung verwenden.

Richtlinie zur Versionsunterstützung

Versionsunterstützung für Spring Boot

Dieses Projekt unterstützt mehrere Spring Boot-Versionen. Weitere Informationen finden Sie in der Richtlinie für die Spring Boot-Unterstützung. Maven-Benutzer können mittels Vererbung aus dem Projekt spring-boot-starter-parent einen Abschnitt zur Abhängigkeitsverwaltung beziehen, um Spring die Versionsverwaltung für Abhängigkeiten zu überlassen. Weitere Informationen finden Sie unter Versionsunterstützung für Spring Boot.

Versionsunterstützung für Spring Data

Dieses Projekt unterstützt verschiedene spring-data-commons-Versionen. Weitere Informationen finden Sie unter Versionsunterstützung für Spring Data.

Welche Version von Azure Spring Data Azure Cosmos DB sollte ich verwenden?

Die Azure Spring Data Azure Cosmos DB-Bibliothek unterstützt mehrere Versionen von Spring Boot und Spring Cloud. Detaillierte Informationen dazu, welche Version von Spring Data Azure Cosmos DB mit welcher Version von Spring Boot/Spring Cloud verwendet werden sollte, finden Sie in der Zuordnung von Azure Spring Data- und Azure Cosmos DB-Versionen.

Wichtig

Diese Versionshinweise gelten für Version 3 von Spring Data Azure Cosmos DB.

Das Azure Spring Data Azure Cosmos DB SDK enthält eine Abhängigkeit vom Spring Data-Framework und unterstützt nur die API für NoSQL.

In diesen Artikeln finden Sie Informationen zu Spring Data für andere Azure Cosmos DB-APIs:

Schneller Einstieg

Nutzen Sie zur schnellen Einrichtung von Spring Data Azure Cosmos DB unsere Anleitung für Spring Boot Starter. Spring Boot Starter wird für die ersten Schritte mit dem Spring Data Azure Cosmos DB-Connector empfohlen.

Alternativ können Sie der Datei pom.xml wie folgt die Spring Data Azure Cosmos DB-Abhängigkeit hinzufügen:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-spring-data-cosmos</artifactId>
    <version>latest-version</version>
</dependency>

Nützliche Inhalte

Inhalt Link
Versionshinweise Versionshinweise für das Spring Data Azure Cosmos DB SDK v3
SDK-Dokumentation Dokumentation zum Azure Spring Data Azure Cosmos DB SDK v3
SDK-Download Maven
API-Dokumentation Java-API-Referenzdokumentation
Am SDK mitwirken Azure SDK für das zentrale Java-Repository auf GitHub
Erste Schritte Schnellstart: Erstellen einer Spring Data Azure Cosmos DB-App zum Verwalten von Azure Cosmos DB for NoSQL-Daten
GitHub-Repository mit Schnellstartcode
Einfache Codebeispiele Azure Cosmos DB: Spring Data Azure Cosmos DB-Beispiele für die API für NoSQL
GitHub-Repository mit Beispielcode
Leistungstipps Leistungstipps für das Azure Cosmos DB Java SDK v4 (anwendbar auf Spring Data)
Problembehandlung Behandeln von Problemen bei der Verwendung des Azure Cosmos DB Java SDK v4 mit SQL-API-Konten (anwendbar auf Spring Data)
Azure Cosmos DB-Workshops und -Labs Homepage der Azure Cosmos DB-Workshops

Releaseverlauf

Der Releaseverlauf wird im Repository „azure-sdk-for-java“ verwaltet. Eine ausführliche Liste der Releases finden Sie in der Datei „changelog“.

Es wird dringend empfohlen, Version 3.28.1 oder höher zu verwenden.

Zusätzliche Hinweise

  • Spring Data Azure Cosmos DB unterstützt Java JDK 8, Java JDK 11 und Versionen 3.8.0 und höher Java JDK 17.

Häufig gestellte Fragen

Wie werde ich über die Einstellung eines SDK benachrichtigt?

Um einen reibungslosen Übergang zu einem unterstützten SDK zu ermöglichen, informiert Microsoft 12 Monate vor Ende des Supports über die Einstellung eines SDK. Sie werden über verschiedene Kommunikationskanäle benachrichtigt: Azure-Portal, Azure-Updates und direkte Kommunikation mit den entsprechenden Dienstadministratoren.

Kann ich mit einem Azure Cosmos DB SDK, das eingestellt werden soll, während der 12-monatigen Frist Anwendungen erstellen?

Ja, mit einem solchen Azure Cosmos DB SDK können Sie während der 12-monatigen Frist Anwendungen erstellen, bereitstellen und ändern. Es wird empfohlen, nach Bedarf innerhalb der 12-monatigen Frist zu einer neueren unterstützten Version des Azure Cosmos DB SDK zu migrieren.

Was geschieht nach dem Einstellungsdatum mit Anwendungen, die das nicht unterstützte Azure Cosmos DB SDK verwenden?

Nach dem Einstellungsdatum werden von Azure Cosmos DB für die eingestellten SDK-Versionen keine Fehlerbehebungen mehr durchgeführt und keine neuen Funktionen hinzugefügt, und es wird auch kein Support mehr dafür angeboten. Wenn Sie kein Upgrade durchführen möchten, werden von den eingestellten Versionen des SDK gesendete Anforderungen weiterhin vom Azure Cosmos DB-Dienst bedient.

Welche SDK-Versionen werden über die neuesten Funktionen und Updates verfügen?

Neue Funktionen und Updates werden nur der aktuellen Nebenversion der neuesten unterstützten SDK-Hauptversion hinzugefügt. Es wird empfohlen, immer die aktuelle Version zu verwenden, um von neuen Funktionen, Leistungsverbesserungen und Fehlerbehebungen zu profitieren. Wenn Sie eine alte, noch nicht eingestellte Version des SDK verwenden, funktionieren Ihre Anforderungen an Azure Cosmos DB weiterhin, Sie haben jedoch keinen Zugriff auf neue Funktionen.

Was muss ich tun, wenn ich meine Anwendung nicht vor einem Stichtag aktualisieren kann?

Es wird empfohlen, so früh wie möglich auf das neueste SDK zu aktualisieren. Nachdem ein SDK für die Einstellung markiert wurde, bleiben Ihnen 12 Monate zur Aktualisierung Ihrer Anwendung. Wenn Sie die Aktualisierung nicht bis zum Einstellungsdatum vornehmen können, werden von den eingestellten Versionen des SDK gesendete Anforderungen weiterhin von Azure Cosmos DB verarbeitet, sodass Ihre ausgeführten Anwendungen weiterhin funktionieren. Für die eingestellten SDK-Versionen werden jedoch von Azure Cosmos DB keine Fehlerbehebungen mehr durchgeführt und keine neuen Funktionen hinzugefügt, und es wird auch kein Support mehr dafür angeboten.

Wenn Sie über einen Supportplan verfügen und technischen Support benötigen, kontaktieren Sie uns, indem Sie ein Supportticket erstellen.

Wie kann ich anfordern, dass Features zu einem SDK oder Connector hinzugefügt werden?

Neue Features werden nicht immer jedem SDK oder Connector sofort hinzugefügt. Wenn eine Funktion, die Ihrer Meinung hinzugefügt werden sollte, nicht unterstützt wird, fügen Sie bitte unserem Communityforum ein Feedback hinzu.

Nächste Schritte

Erfahren Sie mehr über Azure Cosmos DB.

Informieren Sie sich genauer über das Spring-Framework.

Informieren Sie sich genauer über Spring Boot.

Informieren Sie sich genauer über Spring Data.