Dela via

Azure Cosmos DB för NoSQL: Spring Data Azure Cosmos DB v5-exempel

  • Artikel

GÄLLER FÖR: NoSQL

Viktigt!

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

Spring Data Azure Cosmos DB 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:

Viktigt!

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Du kan prova Azure Cosmos DB kostnadsfritt, utan en Azure-prenumeration och utan något åtagande. Du kan också skapa ett kostnadsfritt Azure Cosmos DB-konto med de första 1 000 RU/s och 25 GB lagringsutrymme utan kostnad. Du kan också använda Azure Cosmos DB-emulatorn med en URI för https://localhost:8081. Den nyckel som ska användas med emulatorn finns i Autentisera begäranden.

De senaste exempelprogrammen som utför CRUD-åtgärder och andra vanliga åtgärder på Azure Cosmos DB-resurser ingår i GitHub-lagringsplatsen azure-spring-boot-samples . Den här artikeln innehåller:

  • Länkar till aktiviteterna i vart och ett av exempelprojektfilerna för Spring Data Azure Cosmos DB.
  • Länkar till det relaterade API-referensinnehållet.

Krav

Du behöver följande för att köra det här exempelprogrammet:

  • Java Development Kit 8
  • Spring Data Azure Cosmos DB v5

Du kan också använda Maven för att hämta de senaste Spring Data Azure Cosmos DB v3-binärfilerna för användning i projektet. Maven lägger automatiskt till alla nödvändiga beroenden. Annars kan du ladda ned beroendena direkt i pom.xml-filen och lägga till dem i din byggsökväg.

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

Köra exempelprogrammen

Klona lagringsplatsexemplet:

$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples

$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples

Du kan köra exemplen med antingen en IDE (Eclipse, IntelliJ eller VS Code) eller från kommandoraden med hjälp av Maven.

I application.properties måste dessa miljövariabler anges

cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}

dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true

för att ge exemplen läs-/skrivåtkomst till ditt konto, databaser och containrar.

Din IDE kan ge möjlighet att köra Spring Data-exempelkoden. Annars kan du använda följande terminalkommando för att köra exemplet:

mvn spring-boot:run

Dokument-CRUD-exempel

Exempelfilen visar hur du utför följande uppgifter. Mer information om Azure Cosmos DB-dokument innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa ett dokument CosmosRepository.save
Läsa ett dokument via ID CosmosRepository.derivedQueryMethod
Ta bort alla dokument CosmosRepository.deleteAll

Exempel på härledda frågemetoder

Exempelfilen visar hur du utför följande uppgifter. Om du vill veta mer om Azure Cosmos DB-frågor innan du kör följande exempel kan det vara bra att läsa artikeln Härledda frågemetoder i Baeldung i Spring .

| Fråga efter dokument | CosmosRepository.derivedQueryMethod |

Exempel på anpassade frågor

Exempelfilen visar hur du utför följande uppgifter med hjälp av SQL-fråge grammatik. Mer information om SQL-frågereferensen i Azure Cosmos DB innan du kör följande exempel finns i SQL-frågeexempel för Azure Cosmos DB.

Uppgift API-referens
Fråga för alla dokument @Query anteckning
Fråga för likhet med == @Query anteckning
Fråga för olikhet med != och NOT @Query anteckning
Fråga med intervalloperatorer som >, <, >=, <= @Query anteckning
Fråga med intervalloperatorer mot strängar @Query anteckning
Fråga med ORDER BY @Query anteckning
Fråga med DISTINCT @Query anteckning
Fråga med mängdfunktioner @Query anteckning
Arbeta med underdokument @Query anteckning
Fråga med intradokumentkopplingar @Query anteckning
Fråga med sträng-, matematik- och matrisoperatorer @Query anteckning

Nästa steg

Försöker du planera kapacitet för en migrering till Azure Cosmos DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.