Azure Cosmos DB for NoSQL: Spring Data Azure Cosmos DB v5-voorbeelden

  • Artikel

VAN TOEPASSING OP: NoSQL

Belangrijk

Deze releaseopmerkingen zijn voor versie 5 van Spring Data Azure Cosmos DB. Hier vindt u releaseopmerkingen voor versie 3 en versie 2.

Spring Data Azure Cosmos DB ondersteunt alleen de API voor NoSQL.

Lees deze artikelen voor informatie over Spring Data op andere Azure Cosmos DB-API's:

Belangrijk

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

U kunt Azure Cosmos DB gratis proberen, zonder een Azure-abonnement en zonder toezegging. U kunt ook een gratis Azure Cosmos DB-account maken met de eerste 1000 RU/s en 25 GB opslagruimte. U kunt ook de Azure Cosmos DB-emulator gebruiken met een URI van https://localhost:8081. Zie Aanvragen verifiëren voor de sleutel die u nodig hebt voor de emulator.

De nieuwste voorbeeldtoepassingen die CRUD-bewerkingen en andere algemene bewerkingen uitvoeren op Azure Cosmos DB-resources, zijn opgenomen in de GitHub-opslagplaats azure-spring-boot-samples . Dit artikel bevat:

  • Koppelingen naar de taken in elk van de Spring Data Azure Cosmos DB-voorbeeldprojectbestanden.
  • Koppelingen naar het bijbehorende API-referentiemateriaal.

Vereisten

U hebt het volgende nodig om deze voorbeeldtoepassing uit te voeren:

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

U kunt eventueel Maven gebruiken om de recentste binaire Spring Data Azure Cosmos DB v3-bestanden op te halen voor gebruik in uw project. Maven voegt automatisch eventuele vereiste afhankelijkheden toe. Anders kunt u de afhankelijkheden die worden vermeld in het bestand pom.xml, rechtstreeks downloaden en toevoegen aan uw build-pad.

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

De voorbeeldtoepassingen uitvoeren

De voorbeeldopslagplaats klonen:

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

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

U kunt de voorbeelden uitvoeren met behulp van een IDE (Eclipse, IntelliJ of VS Code) of vanaf de opdrachtregel met behulp van Maven.

Deze omgevingsvariabelen moeten worden ingesteld in application.properties

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

om de voorbeelden lees-en schrijftoegang tot uw account, databases en containers te geven.

Uw IDE kan u de mogelijkheid bieden om de voorbeeldcode van Spring Data uit te voeren. Anders kunt u de volgende terminalopdracht gebruiken om het voorbeeld uit te voeren:

mvn spring-boot:run

CRUD-voorbeelden van documenteren

Het bestand samples laat u zien hoe u de volgende taken uitvoert. Zie het conceptuele artikel Werken met databases, containers en items voor meer informatie over Azure Cosmos DB-documenten voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Een document maken CosmosRepository.save
Een document lezen op id CosmosRepository.derivedQueryMethod
Alle documenten verwijderen CosmosRepository.deleteAll

Voorbeelden van afgeleide querymethoden

Het bestand samples laat u zien hoe u de volgende taken uitvoert. Als u meer wilt weten over Azure Cosmos DB-query's voordat u de volgende voo beelden uitvoert, kan het zinvol zijn om het artikel Afgeleide querymethoden van Baeldung in Spring te lezen.

| Voer een query uit voor documenten | CosmosRepository.derivedQueryMethod |

Voorbeelden van aangepaste query's

In het bestand samples ziet u hoe u de volgende taken kunt uitvoeren met behulp van de SQL-querygrammatica. Zie SQL-queryvoorbeelden voor Azure Cosmos DB voor meer informatie over de SQL-queryreferentie in Azure Cosmos DB voordat u de volgende voorbeelden uitvoert.

Opdracht API-verwijzing
Een query uitvoeren voor alle documenten @Query-annotatie
Query uitvoeren voor gelijkheid met behulp van == @Query-annotatie
Query uitvoeren voor ongelijkheid met behulp van != en NOT @Query-annotatie
Query's uitvoeren met bereikoperators zoals >, = <>< @Query-annotatie
Query uitvoeren met behulp van bereikoperators op tekenreeksen @Query-annotatie
Query uitvoeren met ORDER BY @Query-annotatie
Query uitvoeren met DISTINCT @Query-annotatie
Query uitvoeren met statistische functies @Query-annotatie
Werken met subdocumenten @Query-annotatie
Query uitvoeren met Joins tussen documenten @Query-annotatie
Query uitvoeren met tekenreeks-, berekenings- en matrixoperators @Query-annotatie

Volgende stappen

Wilt u capaciteitsplanning uitvoeren voor een migratie naar Azure Cosmos DB? U kunt informatie over uw bestaande databasecluster gebruiken voor capaciteitsplanning.