Spring Data Azure Cosmos DB v3 för API för NoSQL: 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.
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:
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 |
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 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.