Spring Data Azure Cosmos DB v3 für API für NoSQL (Legacy): Versionshinweise und Ressourcen

GILT FÜR: NoSQL

• .NET SDK v3
• .NET SDK v2
• .NET Core SDK v2
• .NET Change Feed SDK v2
• Node.js
• Java SDK v4
• Sync Java SDK v2
• Async Java SDK v2
• Spring Data v2
• Spring Data v3
• Spring Data v5
• Python
• Go
• REST
• REST-Ressourcenanbieter
• SQL
• Bulk Executor – .NET v2
• Bulk Executor – Java

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.

Warnung

Diese Version von Spring Data Azure Cosmos DB SDK hängt von einer älteren Version von Spring Boot und Azure Cosmos DB Java SDK ab. Dieses Spring Data Azure Cosmos DB SDK wird in naher Zukunft eingestellt! Dies ist nicht das neueste Azure Spring Data Azure Cosmos DB SDK für Azure Cosmos DB und ist veraltet. Aufgrund von Leistungsproblemen und Instabilität in Azure Spring Data Azure Cosmos DB SDK V3 empfehlen wir dringend, Azure Spring Data Azure Cosmos DB v5 für Ihr Projekt zu verwenden. Befolgen Sie für das Upgrade die Anweisungen im Leitfaden Migrieren zu Azure Cosmos DB Java SDK v4, um sich über die Unterschiede beim zugrunde liegenden Java SDK V4 zu informieren.

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. Ausführliche Informationen dazu , welche Version von Azure Spring Data Azure Cosmos DB mit Spring Boot /Spring Cloud-Version verwendet werden soll, finden Sie in azure Spring Data Azure Cosmos DB.

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:

• Spring Data für Apache Cassandra mit Azure Cosmos DB
• Spring Data MongoDB mit Azure Cosmos DB

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“.

Empfohlene Version

Es wird dringend empfohlen, ein Upgrade auf Azure Spring Data Azure Cosmos DB v5 durchzuführen und die empfohlene Mindestversion und höher zu verwenden.

Zusätzliche Hinweise

• Spring Data Azure Cosmos DB unterstützt Java JDK 8, Java JDK 11. Version 3.8.0 und höher unterstützen auch 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.