Spring Data Azure Cosmos DB v3 för API för NoSQL (äldre): Viktig information och resurser

  • Gäller för: ✅ NoSQL

Med Spring Data Azure Cosmos DB version 3 för NoSQL kan utvecklare använda Azure Cosmos DB i Spring-program. Spring Data Azure Cosmos DB exponerar Spring Data-gränssnittet för att manipulera databaser och samlingar, arbeta med dokument och utfärda frågor. Api:er för både Synkronisering och Async (reaktiv) stöds i samma Maven-artefakt.

Varning

Den här versionen av Spring Data Azure Cosmos DB SDK är beroende av en äldre version av Spring Boot och Azure Cosmos DB Java SDK. Denna Spring Data Azure Cosmos DB SDK kommer att tillkännages som går i pension inom en snar framtid! Detta är inte den senaste Azure Spring Data Azure Cosmos DB SDK för Azure Cosmos DB och är inaktuell. På grund av prestandaproblem och instabilitet i Azure Spring Data Azure Cosmos DB SDK V3 rekommenderar vi starkt att du använder Azure Spring Data Azure Cosmos DB v5 för ditt projekt. Om du vill uppgradera följer du anvisningarna i guiden Migrera till Azure Cosmos DB Java SDK v4 för att förstå skillnaden i den underliggande Java SDK V4.

Spring Framework är en programmerings- och konfigurationsmodell som effektiviserar Java-programutvecklingen. Spring effektiviserar "VVS" av program med hjälp av beroendeinmatning. Många utvecklare gillar Spring eftersom det gör det enklare att skapa och testa program. Spring Boot utökar den här hanteringen av VVS med ett öga mot webbprogram och utveckling av mikrotjänster. Spring Data är en programmeringsmodell och ett ramverk för åtkomst till datalager som Azure Cosmos DB från kontexten för ett Spring- eller Spring Boot-program.

Du kan använda Spring Data Azure Cosmos DB i dina program som finns i Azure Spring Apps.

Princip för versionsstöd

Stöd för Spring Data-version

Det här projektet stöder olika spring-data-commons-versioner. Mer information finns i supporten för vårdataversion.

Vilken version av Azure Spring Data Azure Cosmos DB ska jag använda

Azure Spring Data Azure Cosmos DB-biblioteket stöder flera versioner av Spring Boot/Spring Cloud. Se Azure Spring Data Azure Cosmos DB-versionsmappning för detaljerad information om vilken version av Azure Spring Data Azure Cosmos DB som ska användas med Spring Boot/Spring Cloud-versionen.

Important

Dessa viktig information gäller version 3 av Spring Data Azure Cosmos DB.

Azure Spring Data Azure Cosmos DB SDK är beroende av Spring Data-ramverket och stöder endast API:et för NoSQL.

I de här artiklarna finns information om Spring Data på andra Azure Cosmos DB-API:er:

Kom igång snabbt

Kom igång med Spring Data Azure Cosmos DB genom att följa vår Spring Boot Starter-guide. Spring Boot Starter-metoden är det rekommenderade sättet att komma igång med Spring Data Azure Cosmos DB-anslutningsappen.

Du kan också lägga till Spring Data Azure Cosmos DB-beroendet till filen pom.xml enligt nedan:

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

Användbart innehåll

Content Link
Viktig information Viktig information för Spring Data Azure Cosmos DB SDK v3
SDK-dokumentation Dokumentation om Azure Spring Data Azure Cosmos DB SDK v3
SDK-nedladdning Maven
API-dokumentation Referensdokumentation för Java API
Bidra till SDK Azure SDKs för Java Central-lagringsplats på GitHub
Kom igång GitHub-lagringsplats med snabbstartskod
Grundläggande kodexempel GitHub-lagringsplats med exempelkod
Prestandatips Prestandatips för Java SDK v4 (gäller för Spring Data)
Felsökning Felsöka Java SDK v4 (gäller för Spring Data)
Azure Cosmos DB-workshops och labb Startsida för Azure Cosmos DB-workshops

Versionshistorik

Versionshistorik finns på lagringsplatsen azure-sdk-for-java, för detaljerad lista över versioner, se filen changelog.

Vi rekommenderar starkt att du uppgraderar till Azure Spring Data Azure Cosmos DB v5 och använder den lägsta rekommenderade versionen och senare.

Ytterligare anteckningar

  • Spring Data Azure Cosmos DB stöder Java JDK 8, Java JDK 11. Version 3.8.0 och senare stöder även Java JDK 17.

FAQ

Hur meddelas jag om tillbakadragningen av SDK?

Microsoft kommer att tillhandahålla 12 månaders förhandsmeddelande innan supporten för det avgående SDK:et upphör för att underlätta en smidig övergång till ett SDK som stöds. Vi meddelar dig via olika kommunikationskanaler: Azure-portalen, Azure uppdateringar och direktkommunikation till tilldelade tjänstadministratörer.

Kan jag skapa program med hjälp av en to-be-retired Azure Cosmos DB SDK under 12-månadersperioden?

Ja, du kommer att kunna skapa, distribuera och ändra program med hjälp av to-be-retired Azure Cosmos DB SDK under uppsägningstiden på 12 månader. Vi rekommenderar att du migrerar till en nyare version av Azure Cosmos DB SDK under uppsägningstiden på 12 månader efter behov.

Efter slutdatumet, vad händer med program som använder Azure Cosmos DB SDK:t som inte stöds?

Efter slutdatumet kommer Azure Cosmos DB inte längre att göra felkorrigeringar, lägga till nya funktioner eller ge stöd till de tillbakadragna SDK-versionerna. Om du föredrar att inte uppgradera fortsätter begäranden som skickas från de tillbakadragna versionerna av SDK:et att hanteras av Azure Cosmos DB-tjänsten.

Vilka SDK-versioner har de senaste funktionerna och uppdateringarna?

Nya funktioner och uppdateringar läggs bara till i den senaste delversionen av den senaste större SDK-versionen som stöds. Vi rekommenderar att du alltid använder den senaste versionen för att dra nytta av nya funktioner, prestandaförbättringar och felkorrigeringar. Om du använder en gammal, icke-tillbakadragen version av SDK:n kommer dina begäranden till Azure Cosmos DB fortfarande att fungera, men du har inte åtkomst till några nya funktioner.

Vad gör jag om jag inte har möjlighet att uppdatera mitt program före det sista datumet?

Vi rekommenderar att du uppgraderar till den senaste SDK:n så tidigt som möjligt. När en SDK-version har flaggats för tillbakadragning har du 12 månader på dig att uppdatera ditt program. Om du inte kan uppdatera efter indragningsdatumet fortsätter begäranden som skickas från de tillbakadragna versionerna av SDK:et att hanteras av Azure Cosmos DB, så dina program som körs fortsätter att fungera. Men Azure Cosmos DB kommer inte längre att göra felkorrigeringar, lägga till nya funktioner eller ge stöd till de tillbakadragna SDK-versionerna.

Om du har en supportplan och behöver teknisk support kontaktar du oss genom att skicka in en supportbegäran.

Hur kan jag begära att funktioner läggs till i ett SDK eller en anslutningsapp?

Nya funktioner läggs inte alltid till i varje SDK eller anslutningsapp omedelbart. Om det finns en funktion som inte stöds som du vill lägga till kan du lägga till feedback i vårt communityforum.

Nästa steg

Läs mer om Azure Cosmos DB.

Läs mer om Spring Framework.

Läs mer om Spring Boot.

Läs mer om Spring Data.

  • Last updated on