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

GÄLLER FÖR: NoSQL

• .NET SDK v3
• .NET SDK v2
• .NET Core SDK v2
• .NET Change Feed SDK v2
• Node.js
• Java SDK v4
• Synkronisera Java SDK v2
• Async Java SDK v2
• Spring-data v2
• Spring-data v3
• Spring Data v5
• Python
• Kör
• REST
• REST-resursleverantör
• SQL
• Masskörningsbibliotek – .NET v2
• Masskörningsbibliotek – Java

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.

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 Boot-version

Det här projektet stöder flera Spring Boot-versioner. Mer information finns i supportpolicyn för Spring Boot. Maven-användare kan ärva från spring-boot-starter-parent projektet för att få ett beroendehanteringsavsnitt för att låta Spring hantera versionerna för beroenden. Mer information finns i supporten för Spring Boot-versionen.

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.

Viktigt!

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:

• Spring Data för Apache Cassandra med Azure Cosmos DB
• Spring Data MongoDB med Azure Cosmos DB

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

Innehåll	Länk
Versionsanmärkningar	Viktig information för Spring Data Azure Cosmos DB SDK v3
Dokumentation om SDK	Dokumentation om Azure Spring Data Azure Cosmos DB SDK v3
SDK-nedladdning	Maven
API-dokumentation	Referensdokumentation för Java API
Bidra till SDK	Azure SDK för Java Central-lagringsplats på GitHub
Kom igång	Snabbstart: Skapa en Spring Data Azure Cosmos DB-app för att hantera Azure Cosmos DB för NoSQL-data GitHub-lagringsplats med snabbstartskod
Grundläggande kodexempel	Azure Cosmos DB: Spring Data Azure Cosmos DB-exempel för API:et för NoSQL 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

Tidigare versioner

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

Rekommenderad version

Vi rekommenderar starkt att du använder version 3.28.1 och senare.

Ytterligare kommentarer

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

Vanliga frågor

Hur meddelas jag om tillbakadragningen av SDK?

För att säkerställa en smidig övergång till en SDK-version som stöds meddelar Microsoft kunder 12 månader innan stödet för den äldre SDK:n upphör. Vi meddelar dig via flera kommunikationskanaler: på Azure-portalen, genom Azure-uppdateringar och via direktkommunikation till tjänstadministratörer.

Kan jag skapa program med en SDK för Azure Cosmos DB som kommer att dras tillbaka inom 12 månader?

Ja. Du kan skapa, distribuera och ändra program med Azure Cosmos DB-SDK:n som kommer att dras tillbaka under 12-månadsperioden. Vi rekommenderar att du migrerar till en senare version av SDK:n för Azure Cosmos DB under 12-månadsperioden.

Vad händer med program som använder den Azure Cosmos DB-SDK som inte längre stöds efter tillbakadragningsdatumet?

Efter tillbakadragningsdatumet kommer Azure Cosmos DB inte att erbjuda buggkorrigeringar, nya funktioner eller stöd för de SDK-versioner som har dragits tillbaka. Om du föredrar att inte uppgradera kommer begäranden från de inaktuella versionerna av SDK:n att fortsätta att hanteras av tjänsten Azure Cosmos DB.

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 kommer inte att ha tillgång till 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 har möjlighet att uppdatera före tillbakadragningsdatumet kommer begäranden som skickas från de tillbakadragna versionerna av SDK:n att fortsätta att betjänas av Azure Cosmos DB, och dina aktiva program kommer att fortsätta att fungera. Men Azure Cosmos DB kommer inte längre att erbjuda felkorrigeringar, nya funktioner eller stöd för 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.