Dela via

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

  • Artikel

GÄLLER FÖR: NoSQL

Med Spring Data Azure Cosmos DB version 2 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 tillbakadragen version av 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 V2 rekommenderar vi starkt att du använder Azure Spring Data Azure Cosmos DB v3 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 för åtkomst till datalager som Azure Cosmos DB från en Spring- eller Spring Boot-app.

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

Viktigt!

Dessa viktig information gäller version 2 av Spring Data Azure Cosmos DB. Du hittar viktig information för version 3 här.

Spring Data Azure Cosmos DB stöder endast API:et för NoSQL.

I följande artiklar finns information om Spring Data på andra Azure Cosmos DB-API:er:

Vill du komma igång snabbt?

  1. Installera den lägsta Java-körning som stöds, JDK 8, så att du kan använda SDK:t.
  2. Skapa en Spring Data Azure Cosmos DB-app med hjälp av startprogrammet. Det är enkelt!
  3. Gå igenom utvecklarguiden för Spring Data Azure Cosmos DB, som går igenom grundläggande Azure Cosmos DB-begäranden.

Du kan snabbt starta Spring Boot Starter-appar med Spring Initializr!

Resurser

Resurs Länk
SDK-nedladdning Maven
API-dokumentation Referensdokumentation för Spring Data Azure Cosmos DB
Bidra till SDK Spring Data Azure Cosmos DB-lagringsplats på GitHub
Spring Boot Starter Azure Cosmos DB Spring Boot Starter-klientbibliotek för Java
Utvecklarguide Utvecklarguide för Spring Data Azure Cosmos DB
Använda Starter Använda Spring Boot Starter med Azure Cosmos DB for NoSQL
GitHub-lagringsplats för Azure Cosmos DB Spring Boot Starter
Exempel med Azure App Service Använda Spring och Azure Cosmos DB med App Service i Linux

Tidigare versioner

2.3.0 (21 maj 2020)

Nya funktioner

  • Uppdaterar Spring Boot-versionen till 2.3.0.

2.2.5 (19 maj 2020)

Nya funktioner

  • Uppdaterar Azure Cosmos DB-versionen till 3.7.3.

Korrigeringar av nyckelfel

  • Innehåller korrigeringar av minnesläckage och uppgraderingar av Netty-versionen från Azure Cosmos DB SDK 3.7.3.

2.2.4 (6 april 2020)

Korrigeringar av nyckelfel

  • Åtgärdar allowTelemetry flaggan för att ta hänsyn till från CosmosDbConfig.
  • Åtgärdar TTL egenskapen för containern.

2.2.3 (25 februari 2020)

Nya funktioner

  • Lägger till nytt findAll av partitionsnyckel-API.et.
  • Uppdaterar Azure Cosmos DB-versionen till 3.7.0.

Korrigeringar av nyckelfel

  • Korrigeringar collectionName ->containerName.
  • Korrigeringar entityClass och domainClass ->domainType.
  • Åtgärdar "Return entity collection saved by repository instead of input entity" (Returnera entitetssamling som sparats av lagringsplatsen i stället för indataentitet).

2.1.10 (25 februari 2020)

Korrigeringar av nyckelfel

  • Korrigering av backports för "Return entity collection saved by repository instead of input entity" (Returnera entitetssamling som sparats av lagringsplatsen i stället för indataentitet).

2.2.2 (15 januari 2020)

Nya funktioner

  • Uppdaterar Azure Cosmos DB-versionen till 3.6.0.

Korrigeringar av nyckelfel

2.2.1 (31 december 2019)

Nya funktioner

  • Uppdaterar Azure Cosmos DB SDK-versionen till 3.5.0.
  • Lägger till anteckningsfält för att aktivera eller inaktivera automatisk skapande av samling.
  • Förbättrar undantagshanteringen. Exponerar CosmosClientException via CosmosDBAccessException.
  • Exponerar requestCharge och activityId via ResponseDiagnostics.

Korrigeringar av nyckelfel

  • SDK 3.5.0-uppdateringen åtgärdar "Undantag när Azure Cosmos DB HTTP-svarsrubriken är större än 8 192 byte", "ConsistencyPolicy.defaultConsistencyLevel() misslyckas med begränsad föråldring och konsekvent prefix."
  • Åtgärdar findById metodens beteende. Tidigare returnerade den här metoden tom om entiteten inte hittades i stället för att utlösa ett undantag.
  • Åtgärdar en bugg där sortering inte tillämpades på nästa sida när CosmosPageRequest den användes.

2.1.9 (26 december 2019)

Nya funktioner

  • Lägger till anteckningsfält för att aktivera eller inaktivera automatisk skapande av samling.

Korrigeringar av nyckelfel

  • Åtgärdar findById metodens beteende. Tidigare returnerade den här metoden tom om entiteten inte hittades i stället för att utlösa ett undantag.

2.2.0 (21 oktober 2019)

Nya funktioner

  • Fullständigt stöd för reaktiva Azure Cosmos DB-lagringsplatser.
  • Stöd för Azure Cosmos DB-begärandediagnostiksträng och frågemått.
  • Versionsuppdatering för Azure Cosmos DB SDK till 3.3.1.
  • Spring Framework-versionsuppgradering till 5.2.0.RELEASE.
  • Spring Data Commons-versionsuppgradering till 2.2.0.RELEASE.
  • Lägger till findByIdAndPartitionKey och deleteByIdAndPartitionKey API:er.
  • Tar bort beroende från azure-documentdb.
  • Byter namn på DocumentDB till Azure Cosmos DB.

Korrigeringar av nyckelfel

  • Åtgärdar "Sortering genererar undantag när pageSize är mindre än totalt antal objekt på lagringsplatsen.".

2.1.8 (18 oktober 2019)

Nya funktioner

  • Inaktuella DocumentDB-API:er.
  • Lägger till findByIdAndPartitionKey och deleteByIdAndPartitionKey API:er.
  • Lägger till optimistisk låsning baserat på _etag.
  • Aktiverar SpEL-uttryck för dokumentsamlingens namn.
  • Lägger till ObjectMapper förbättringar.

2.1.7 (18 oktober 2019)

Nya funktioner

  • Lägger till Azure Cosmos DB SDK version 3-beroende.
  • Lägger till reaktiv Azure Cosmos DB-lagringsplats.
  • Uppdaterar implementeringen av DocumentDbTemplate för att använda Azure Cosmos DB SDK version 3.
  • Lägger till andra konfigurationsändringar för stöd för reaktiva Azure Cosmos DB-lagringsplatser.

2.1.2 (19 mars 2019)

Korrigeringar av nyckelfel

  • applicationInsights Tar bort beroende för:
    • Potentiell risk för att beroenden förorenar.
    • Java 11-inkompatibilitet.
    • Undvika potentiell prestandapåverkan på cpu och/eller minne.

2.0.7 (20 mars 2019)

Korrigeringar av nyckelfel

  • Backport tar applicationInsights bort beroendet för:
    • Potentiell risk för att beroenden förorenar.
    • Java 11-inkompatibilitet.
    • Undvika potentiell prestandapåverkan på cpu och/eller minne.

2.1.1 (7 mars 2019)

Nya funktioner

  • Uppdaterar huvudversionen till 2.1.1.

2.0.6 (7 mars 2019)

Nya funktioner

  • Ignorera alla undantag från telemetri.

2.1.0 (17 december 2018)

Nya funktioner

  • Uppdaterar versionen till 2.1.0 för att åtgärda problemet.

2.0.5 (13 september 2018)

Nya funktioner

  • Lägger till nyckelord exists och startsWith.
  • Uppdaterar Readme.

Korrigeringar av nyckelfel

  • Åtgärdar "Det går inte att anropa själv href direkt för entitet".
  • Åtgärdar "findAll misslyckas om samlingen inte skapas".

2.0.4 (förhandsversion) (23 augusti 2018)

Nya funktioner

  • Byter namn på paketet från documentdb till cosmosdb.
  • Lägger till ny funktion i nyckelordet frågemetod. 16 nyckelord från API för NoSQL stöds nu.
  • Lägger till en ny funktion i frågan med växling och sortering.
  • Förenklar konfigurationen av spring-data-cosmosdb.
  • Lägger till deleteCollection och deleteAll API:er.

Korrigeringar av nyckelfel

  • Felkorrigering och defektreducering.

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.