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

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.

Warning

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.

Versionsunterstützungsrichtlinie

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

Important

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

Content Link
Veröffentlichungshinweise 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 GitHub-Repository mit Schnellstartcode
Einfache Codebeispiele 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

Versionsverlauf

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, 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?

Microsoft wird vor Ablauf des Supports des reaktivierten SDK 12 Monate im Voraus informieren, um einen reibungslosen Übergang zu einem unterstützten SDK zu erleichtern. Wir benachrichtigen Sie über verschiedene Kommunikationskanäle: das Azure-Portal, Azure Updates und die direkte Kommunikation mit zugewiesenen Dienstadministratoren.

Kann ich Anwendungen mithilfe eines to-be-eingestellten Azure Cosmos DB SDK während des Zeitraums von 12 Monaten erstellen?

Ja, Sie können Anwendungen mithilfe des to-be-eingestellten Azure Cosmos DB SDK während des 12-Monat-Benachrichtigungszeitraums erstellen, bereitstellen und ändern. Es wird empfohlen, während des 12-monatigen Kündigungszeitraums zu einer neueren unterstützten Version des Azure Cosmos DB SDK zu migrieren.

Nach dem Deaktivierungsdatum geschieht folgendes mit Anwendungen, die das nicht unterstützte Azure Cosmos DB SDK verwenden?

Nach dem Deaktivierungsdatum werden Azure Cosmos DB keine Fehlerbehebungen mehr vornehmen, neue Features hinzufügen oder Unterstützung für die eingestellten SDK-Versionen bereitstellen. Wenn Sie kein Upgrade durchführen möchten, werden anforderungen, die von den eingestellten Versionen des SDK gesendet werden, weiterhin vom Azure Cosmos DB-Dienst bereitgestellt.

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, nicht eingestellte Version des SDK verwenden, funktionieren Ihre Anforderungen an Azure Cosmos DB weiterhin, aber Sie haben 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 nicht nach dem Einstellungsdatum aktualisieren können, werden anforderungen, die von den eingestellten Versionen des SDK gesendet werden, weiterhin von Azure Cosmos DB bereitgestellt, sodass Ihre ausgeführten Anwendungen weiterhin funktionieren. Aber Azure Cosmos DB werden keine Fehlerbehebungen mehr vornehmen, neue Features hinzufügen oder Unterstützung für die eingestellten SDK-Versionen bereitstellen.

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.