Spring Data Azure Cosmos DB v3 voor API voor NoSQL (verouderd): Opmerkingen bij de release en resources

VAN TOEPASSING OP: NoSQL

• .NET SDK v3
• .NET SDK v2
• .NET Core SDK v2
• .NET wijzigingenfeed-SDK v2
• Node.js
• Java SDK v4
• Java SDK v2 synchroniseren
• Async Java SDK v2
• Spring Data v2
• Spring Data v3
• Spring Data v5
• Python
• Go
• REST
• REST-resourceprovider
• SQL
• Bulkuitvoerprogramma - .NET v2
• Bulkuitvoerprogramma - Java

Met spring Data Azure Cosmos DB versie 3 voor NoSQL kunnen ontwikkelaars Azure Cosmos DB gebruiken in Spring-toepassingen. Spring Data Azure Cosmos DB maakt de Spring Data-interface beschikbaar voor het bewerken van databases en verzamelingen, het werken met documenten en het uitgeven van query's. Synchronisatie- en Async-API's (reactief) worden ondersteund in hetzelfde Maven-artefact.

Waarschuwing

Deze versie van Spring Data Azure Cosmos DB SDK is afhankelijk van een oudere versie van Spring Boot en Azure Cosmos DB Java SDK. Deze Spring Data Azure Cosmos DB SDK wordt in de nabije toekomst aangekondigd als buiten gebruik gesteld! Dit is niet de nieuwste Azure Spring Data Azure Cosmos DB SDK voor Azure Cosmos DB en is verouderd. Vanwege prestatieproblemen en instabiliteit in Azure Spring Data Azure Cosmos DB SDK V3 raden we u ten zeerste aan Om Azure Spring Data Azure Cosmos DB v5 voor uw project te gebruiken. Als u een upgrade wilt uitvoeren, volgt u de instructies in de handleiding Migreren naar Azure Cosmos DB Java SDK v4 om inzicht te hebben in het verschil in de onderliggende Java SDK V4.

Het Spring Framework is een programmeer- en configuratiemodel dat de ontwikkeling van Java-toepassingen stroomlijnt. Spring stroomlijnt het 'sanitair' van toepassingen met behulp van afhankelijkheidsinjectie. Veel ontwikkelaars zoals Spring omdat het bouwen en testen van toepassingen eenvoudiger maakt. Spring Boot breidt deze verwerking van het sanitair uit met een oog op de ontwikkeling van webtoepassingen en microservices. Spring Data is een programmeermodel en framework voor toegang tot gegevensarchieven zoals Azure Cosmos DB vanuit de context van een Spring- of Spring Boot-toepassing.

U kunt Spring Data Azure Cosmos DB gebruiken in uw toepassingen die worden gehost in Azure Spring Apps.

Versieondersteuningsbeleid

Ondersteuning voor Spring Boot-versie

Dit project ondersteunt meerdere Spring Boot-versies. Ga naar het spring boot-ondersteuningsbeleid voor meer informatie. Maven-gebruikers kunnen overnemen van het spring-boot-starter-parent project om een sectie voor afhankelijkheidsbeheer te verkrijgen om Spring de versies voor afhankelijkheden te laten beheren. Ga naar ondersteuning voor spring boot-versies voor meer informatie.

Ondersteuning voor Spring Data-versies

Dit project ondersteunt verschillende spring-data-commons-versies. Ga naar ondersteuning voor spring data-versies voor meer informatie.

Welke versie van Azure Spring Data Azure Cosmos DB moet ik gebruiken

Azure Spring Data Azure Cosmos DB-bibliotheek ondersteunt meerdere versies van Spring Boot/Spring Cloud. Raadpleeg Azure Spring Data Azure Cosmos DB-versietoewijzing voor gedetailleerde informatie over welke versie van Azure Spring Data Azure Cosmos DB moet worden gebruikt met Spring Boot/Spring Cloud-versie.

Belangrijk

Deze release-opmerkingen horen bij versie 3 van Spring Data Azure Cosmos DB.

Azure Spring Data Azure Cosmos DB SDK is afhankelijk van het Spring Data-framework en biedt alleen ondersteuning voor de API voor NoSQL.

Lees deze artikelen voor informatie over Spring Data op andere Azure Cosmos DB-API's:

• Spring Data voor Apache Cassandra met Azure Cosmos DB
• Spring Data MongoDB met Azure Cosmos DB

Snel aan de slag

Ga aan de slag met Spring Data Azure Cosmos DB door onze Spring Boot Starter-handleiding te volgen. De Spring Boot Starter-benadering is de aanbevolen manier om aan de slag te gaan met de Spring Data Azure Cosmos DB-connector.

U kunt ook de Spring Data Azure Cosmos DB-afhankelijkheid toevoegen aan uw pom.xml bestand, zoals hieronder wordt weergegeven:

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

Nuttige inhoud

Inhoud	Koppeling
Opmerkingen bij de release	Releaseopmerkingen voor Spring Data Azure Cosmos DB SDK v3
SDK-documentatie	Documentatie voor Azure Spring Data Azure Cosmos DB SDK v3
SDK downloaden	Maven
API-documentatie	Naslagdocumentatie voor Java-API
Bijdragen aan SDK	Azure SDK voor Java Central-opslagplaats op GitHub
Aan de slag	Quickstart: Een Spring Data Azure Cosmos DB-app bouwen om Azure Cosmos DB for NoSQL-gegevens te beheren GitHub-opslagplaats met quickstartcode
Basiscodevoorbeelden	Azure Cosmos DB: Spring Data Azure Cosmos DB-voorbeelden voor de API voor NoSQL GitHub-opslagplaats met voorbeeldcode
Tips voor prestaties	Tips voor prestaties voor Java SDK v4 (van toepassing op Spring Data)
Problemen oplossen	Problemen met Java SDK v4 oplossen (van toepassing op Spring Data)
Azure Cosmos DB-workshops en -labs	Startpagina van Azure Cosmos DB-workshops

Versiegeschiedenis

Releasegeschiedenis wordt bijgehouden in de azure-sdk-for-java-opslagplaats, voor een gedetailleerde lijst met releases, zie het changelog-bestand.

Aanbevolen versie

Het wordt sterk aanbevolen om een upgrade uit te voeren naar Azure Spring Data Azure Cosmos DB v5 en de minimaal aanbevolen versie en hoger te gebruiken.

Aanvullende opmerkingen

• Spring Data Azure Cosmos DB ondersteunt Java JDK 8, Java JDK 11. Versie 3.8.0 en hoger ondersteunen ook Java JDK 17.

Veelgestelde vragen

Hoe word ik op de hoogte gesteld van de buitengebruikstelling van de SDK?

Microsoft zal u 12 maanden vóór het einde van de ondersteuning op de hoogte stellen van de buitengebruikstelling van de SDK om een soepele overgang naar een ondersteunde SDK te vergemakkelijken. We sturen u een melding via verschillende communicatiekanalen: de Azure Portal, Azure-updates en rechtstreekse communicatie met toegewezen servicebeheerders.

Kan ik toepassingen maken met behulp van de Azure Cosmos DB SDK die buiten gebruik gesteld zal worden gedurende de periode van 12 maanden?

Ja, u kunt toepassingen ontwerpen, implementeren en wijzigen met behulp van de Azure Cosmos DB SDK die buiten gebruik gesteld zal worden, gedurende de periode van 12 maanden. Wij raden u aan, indien van toepassing, te migreren naar een nieuwere, ondersteunde versie van de Azure Cosmos DB SDK gedurende de kennisgevingsperiode van 12 maanden.

Wat gebeurt er na de buitengebruikstellingsdatum met de toepassingen die de niet-ondersteunde Azure Cosmos DB SDK gebruiken?

Na de buitengebruikstellingsdatum lost Azure Cosmos DB geen problemen meer op, voegt geen nieuwe functies meer toe en levert geen ondersteuning meer voor de buiten gebruik gestelde SDK-versies. Als u liever geen upgrade uitvoert, worden aanvragen die zijn verzonden vanaf de buiten gebruik gestelde versies van de SDK nog steeds behandeld door de Azure Cosmos DB-service.

Welke SDK-versies hebben de nieuwste functies en updates?

Nieuwe functies en updates worden alleen toegevoegd aan de meest recente secundaire versie van de meest recente ondersteunde primaire SDK-versie. Wij raden aan altijd de nieuwste versie te gebruiken om te profiteren van nieuwe functies, prestatieverbeteringen en oplossingen voor problemen. Als u een oude, niet buiten gebruik gestelde versie van de SDK gebruikt, zullen uw aanvragen voor Azure Cosmos DB nog steeds werken, maar hebt u geen toegang tot nieuwe mogelijkheden.

Wat moet ik doen als ik mijn toepassing niet kan bijwerken vóór een afsluitdatum?

Wij raden u aan zo snel mogelijk een upgrade naar de nieuwste SDK uit te voeren. Nadat een SDK is gelabeld voor buitengebruikstelling, hebt u 12 maanden om de toepassing bij te werken. Als u niet kunt bijwerken voor de buitengebruikstellingsdatum, worden aanvragen die zijn verzonden vanuit de buiten gebruik gestelde versies van de SDK nog steeds behandeld door Azure Cosmos DB, zodat uw actieve toepassingen blijven functioneren. Maar Azure Cosmos DB lost geen problemen meer op, voegt geen nieuwe functies meer toe en levert geen ondersteuning meer voor de buiten gebruik gestelde SDK-versies.

Als u een ondersteuningsplan hebt en technische ondersteuning nodig hebt, neem contact met ons op door een ondersteuningsticket in te vullen.

Hoe kan ik aanvragen dat functies worden toegevoegd aan een SDK of connector?

Nieuwe functies worden niet altijd onmiddellijk toegevoegd aan elke SDK of connector. Als er geen functie wordt ondersteund die u wilt toevoegen, kunt u feedback toevoegen aan ons communityforum.

Volgende stappen

Meer informatie over Azure Cosmos DB.

Meer informatie over het Spring Framework.

Meer informatie over Spring Boot.

Meer informatie over Spring Data.