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

  • Artikel

VAN TOEPASSING OP: NoSQL

Met Spring Data Azure Cosmos DB versie 2 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 buiten gebruik gestelde versie van de 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 V2 raden we u ten zeerste aan Om Azure Spring Data Azure Cosmos DB v3 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 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.

Belangrijk

Deze releaseopmerkingen zijn voor versie 2 van Spring Data Azure Cosmos DB. Hier vindt u releaseopmerkingen voor versie 3.

Spring Data Azure Cosmos DB ondersteunt alleen de API voor NoSQL.

Zie de volgende artikelen voor informatie over Spring Data op andere Azure Cosmos DB-API's:

Wilt u snel aan de slag?

  1. Installeer de minimaal ondersteunde Java-runtime, JDK 8, zodat u de SDK kunt gebruiken.
  2. Maak een Spring Data Azure Cosmos DB-app met behulp van de starter. Het is makkelijk!
  3. Doorloop de ontwikkelaarshandleiding van Spring Data Azure Cosmos DB, waarmee u eenvoudige Azure Cosmos DB-aanvragen kunt doorlopen.

U kunt Spring Boot Starter-apps snel inschakelen met spring Initializr!

Resources

Bron Koppeling
SDK downloaden Maven
API-documentatie Referentiedocumentatie voor Spring Data Azure Cosmos DB
Bijdragen aan de SDK Spring Data Azure Cosmos DB-opslagplaats op GitHub
Spring Boot Starter Azure Cosmos DB Spring Boot Starter-clientbibliotheek voor Java
Gids voor ontwikkelaars Ontwikkelaarshandleiding voor Spring Data Azure Cosmos DB
Starter gebruiken Spring Boot Starter gebruiken met Azure Cosmos DB for NoSQL
GitHub-opslagplaats voor Azure Cosmos DB Spring Boot Starter
Voorbeeld met Azure-app Service Spring en Azure Cosmos DB gebruiken met App Service op Linux

Versiegeschiedenis

2.3.0 (21 mei 2020)

Nieuwe functies

  • Werkt Spring Boot-versie bij naar 2.3.0.

2.2.5 (19 mei 2020)

Nieuwe functies

  • Hiermee wordt Azure Cosmos DB-versie bijgewerkt naar 3.7.3.

Oplossingen voor belangrijke fouten

  • Bevat oplossingen voor geheugenlekken en Netty-versie-upgrades van Azure Cosmos DB SDK 3.7.3.

2.2.4 (6 april 2020)

Oplossingen voor belangrijke fouten

  • Fixes allowTelemetry vlag om rekening mee te houden van CosmosDbConfig.
  • Corrigeert TTL de eigenschap in de container.

2.2.3 (25 februari 2020)

Nieuwe functies

  • Voegt nieuwe findAll toe op partitiesleutel-API.
  • Hiermee wordt Azure Cosmos DB-versie bijgewerkt naar 3.7.0.

Oplossingen voor belangrijke fouten

  • Fixes collectionName ->containerName.
  • entityClass Oplossingen en domainClass ->domainType.
  • Hiermee wordt 'Retourentiteitverzameling opgeslagen door opslagplaats in plaats van invoerentiteit' opgelost.

2.1.10 (25 februari 2020)

Oplossingen voor belangrijke fouten

  • Backports fix voor 'Return entity collection saved by repository instead of input entity'.

2.2.2 (15 januari 2020)

Nieuwe functies

  • Hiermee wordt Azure Cosmos DB-versie bijgewerkt naar 3.6.0.

Oplossingen voor belangrijke fouten

2.2.1 (31 december 2019)

Nieuwe functies

  • Hiermee wordt azure Cosmos DB SDK-versie bijgewerkt naar 3.5.0.
  • Hiermee wordt een aantekeningsveld toegevoegd om het automatisch maken van verzamelingen in of uit te schakelen.
  • Verbetert de verwerking van uitzonderingen. CosmosClientException Wordt weergegeven via CosmosDBAccessException.
  • Blootstelt requestCharge en activityId door ResponseDiagnostics.

Oplossingen voor belangrijke fouten

  • MET SDK 3.5.0-update wordt 'Uitzondering opgelost wanneer de HTTP-antwoordheader van Azure Cosmos DB groter is dan 8192 bytes', 'ConsistencyPolicy.defaultConsistencyLevel() mislukt op Gebonden veroudering en consistent voorvoegsel'.
  • Corrigeert findById het gedrag van de methode. Voorheen retourneerde deze methode leeg als de entiteit niet werd gevonden in plaats van een uitzondering te genereren.
  • Hiermee lost u een fout op waarbij sorteren niet is toegepast op de volgende pagina toen CosmosPageRequest deze werd gebruikt.

2.1.9 (26 december 2019)

Nieuwe functies

  • Hiermee wordt een aantekeningsveld toegevoegd om het automatisch maken van verzamelingen in of uit te schakelen.

Oplossingen voor belangrijke fouten

  • Corrigeert findById het gedrag van de methode. Voorheen retourneerde deze methode leeg als de entiteit niet werd gevonden in plaats van een uitzondering te genereren.

2.2.0 (21 oktober 2019)

Nieuwe functies

  • Volledige ondersteuning voor reactieve Azure Cosmos DB-opslagplaatsen.
  • Ondersteuning voor diagnostische gegevens van Azure Cosmos DB-aanvragen en metrische querygegevens.
  • Azure Cosmos DB SDK-versie wordt bijgewerkt naar 3.3.1.
  • Spring Framework-versie-upgrade naar 5.2.0.RELEASE.
  • Spring Data Commons-versie wordt bijgewerkt naar 2.2.0.RELEASE.
  • Voegt findByIdAndPartitionKey en deleteByIdAndPartitionKey API's toe.
  • Hiermee verwijdert u afhankelijkheid uit azure-documentdb.
  • DocumentDB hernoemt naar Azure Cosmos DB.

Oplossingen voor belangrijke fouten

  • Oplossingen voor 'Sorteren genereert uitzondering wanneer pageSize kleiner is dan het totale aantal items in de opslagplaats'.

2.1.8 (18 oktober 2019)

Nieuwe functies

  • DocumentDB-API's worden afgeschaft.
  • Voegt findByIdAndPartitionKey en deleteByIdAndPartitionKey API's toe.
  • Voegt optimistische vergrendeling toe op _etagbasis van .
  • Hiermee schakelt u de SpEL-expressie in voor de naam van de documentverzameling.
  • Voegt verbeteringen toe ObjectMapper .

2.1.7 (18 oktober 2019)

Nieuwe functies

  • Hiermee wordt afhankelijkheid van Azure Cosmos DB SDK versie 3 toegevoegd.
  • Voegt reactieve Azure Cosmos DB-opslagplaats toe.
  • Hiermee wordt de implementatie bijgewerkt van het gebruik van DocumentDbTemplate Azure Cosmos DB SDK versie 3.
  • Hiermee worden andere configuratiewijzigingen toegevoegd voor ondersteuning van reactieve Azure Cosmos DB-opslagplaatsen.

2.1.2 (19 maart 2019)

Oplossingen voor belangrijke fouten

  • Hiermee verwijdert u applicationInsights de afhankelijkheid voor:
    • Potentieel risico op afhankelijkheden die vervuilen.
    • Incompatibiliteit van Java 11.
    • Het vermijden van mogelijke prestatie-impact op CPU en/of geheugen.

2.0.7 (20 maart 2019)

Oplossingen voor belangrijke fouten

  • Backport verwijdert applicationInsights afhankelijkheid voor:
    • Potentieel risico op afhankelijkheden die vervuilen.
    • Incompatibiliteit van Java 11.
    • Het vermijden van mogelijke prestatie-impact op CPU en/of geheugen.

2.1.1 (7 maart 2019)

Nieuwe functies

  • Werkt de hoofdversie bij naar 2.1.1.

2.0.6 (7 maart 2019)

Nieuwe functies

  • Negeer alle uitzonderingen van telemetrie.

2.1.0 (17 december 2018)

Nieuwe functies

  • Werkt versie 2.1.0 bij om het probleem op te lossen.

2.0.5 (13 september 2018)

Nieuwe functies

  • Trefwoorden exists en startsWith.
  • Leesmij-updates.

Oplossingen voor belangrijke fouten

  • Fixes 'Kan self href niet rechtstreeks aanroepen voor entiteit'.
  • Oplossingen 'findAll mislukt als de verzameling niet is gemaakt'.

2.0.4 (Voorlopige versie) (23 augustus 2018)

Nieuwe functies

  • Wijzigt de naam van het pakket van documentdb in cosmosdb.
  • Hiermee voegt u een nieuwe functie van het trefwoord van de querymethode toe. 16 trefwoorden van API voor NoSQL worden nu ondersteund.
  • Hiermee voegt u een nieuwe functie van de query toe met paging en sortering.
  • Vereenvoudigt de configuratie van spring-data-cosmosdb.
  • Voegt deleteCollection en deleteAll API's toe.

Oplossingen voor belangrijke fouten

  • Opgeloste fouten en oplossingen voor defecten.

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.