Azure Cosmos DB for NoSQL: Spring Data Azure Cosmos DB v5-példák

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Fontos

Ezek a kibocsátási megjegyzések a Spring Data Azure Cosmos DB 5-ös verziójához tartoznak. A 3- és a 2-es verzió kibocsátási megjegyzéseit itt találja.

A Spring Data Azure Cosmos DB csak a NoSQL API-t támogatja.

A Spring Data más Azure Cosmos DB API-kkal kapcsolatos információit az alábbi cikkekben talál:

Fontos

If you don't have an Azure subscription, create an Azure free account before you begin.

Az Azure Cosmos DB ingyenesen, Azure-előfizetés nélkül és kötelezettségvállalás nélkül is kipróbálható. Másik lehetőségként létrehozhat egy ingyenes szintű Azure Cosmos DB-fiókot, amely az első 1000 RU/s és 25 GB tárterülettel rendelkezik ingyenesen. Az Azure Cosmos DB emulátort az URI-val is használhatja https://localhost:8081. Az emulátorhoz használandó kulcsról a kérelmek hitelesítése című témakörben olvashat.

A CRUD-műveleteket és az Azure Cosmos DB-erőforrások egyéb gyakori műveleteit végző legújabb mintaalkalmazások az azure-spring-boot-samples GitHub-adattárban találhatók. Ez a cikk a következő információkat tartalmazza:

  • A Spring Data Azure Cosmos DB-projektfájlokban található feladatokra mutató hivatkozások.
  • A kapcsolódó API-referenciatartalmak hivatkozásai.

Előfeltételek

A mintaalkalmazás futtatásához a következőkre lesz szüksége:

  • Java fejlesztői készlet 8-as verziója
  • Spring Data Azure Cosmos DB v5

Igény szerint a Maven használatával beszerezheti a legújabb Spring Data Azure Cosmos DB v3 bináris fájlokat a projektben való használatra. A Maven automatikusan hozzáadja az összes szükséges függőséget. Ellenkező esetben közvetlenül letöltheti a pom.xml fájlban felsorolt függőségeket, és hozzáadhatja őket a buildelési útvonalhoz.

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

A mintaalkalmazások futtatása

A mintaadattár klónozása:

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

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

A mintákat futtathatja IDE (Eclipse, IntelliJ vagy VS Code) vagy a parancssorból a Maven használatával.

Az application.properties alkalmazásban ezeket a környezeti változókat be kell állítani

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

annak érdekében, hogy a minták olvasási/írási hozzáférést kaphassanak a fiókhoz, az adatbázisokhoz és a tárolókhoz.

Előfordulhat, hogy az IDE lehetővé teszi a Spring Data-mintakód végrehajtását. Ellenkező esetben a következő terminálparancsot használhatja a minta végrehajtásához:

mvn spring-boot:run

CruD-példák dokumentálása

A mintafájl bemutatja, hogyan hajthatja végre a következő feladatokat. Az Alábbi minták futtatása előtt az Azure Cosmos DB-dokumentumokról további információt az adatbázisok, tárolók és elemek használatáról szóló elméleti cikk tartalmaz.

Task API-referencia
Dokumentum létrehozása CosmosRepository.save
Dokumentum olvasása ID (azonosító) alapján CosmosRepository.derivedQueryMethod
Az összes dokumentum törlése CosmosRepository.deleteAll

Származtatott lekérdezési módszer példák

A mintafájl bemutatja, hogyan hajthatja végre a következő feladatokat. Ha az alábbi minták futtatása előtt szeretné megismerni az Azure Cosmos DB-lekérdezéseket, hasznos lehet elolvasni a Baeldung származtatott lekérdezési módszereit a Spring-cikkben .

| Dokumentumok lekérdezése | CosmosRepository.derivedQueryMethod |

Egyéni lekérdezési példák

A mintafájl bemutatja, hogyan végezheti el a következő feladatokat az SQL-lekérdezés nyelvtanával. Az Azure Cosmos DB SQL-lekérdezési referenciájáról az alábbi minták futtatása előtt az Azure Cosmos DB SQL-lekérdezési példáiban olvashat.

Task API-referencia
Az összes dokumentum lekérdezése @Query Megjegyzés
Egyenlőség lekérdezése == használatával @Query Megjegyzés
Egyenlőtlenség lekérdezése != és NOT használatával @Query Megjegyzés
Lekérdezés tartomány operátorokkal, például >: , <>=, <= @Query Megjegyzés
Lekérdezés tartományi operátorokkal sztringekben @Query Megjegyzés
Lekérdezés ORDER BY használatával @Query Megjegyzés
Lekérdezés a DISTINCT használatával @Query Megjegyzés
Lekérdezés összesítő függvényekkel @Query Megjegyzés
Aldokumentumok használata @Query Megjegyzés
Lekérdezés dokumentumon belüli illesztésekkel @Query Megjegyzés
Lekérdezés sztring-, matematikai és tömb operátorokkal @Query Megjegyzés

További lépések

Kapacitástervezést szeretne végezni az Azure Cosmos DB-be való migráláshoz? A kapacitástervezéshez használhatja a meglévő adatbázisfürt adatait.