Azure Cosmos DB for NoSQL: Příklady Spring Data Azure Cosmos DB v5

Článek
06/13/2024

PLATÍ PRO: NoSQL

Důležité

Tyto poznámky k verzi jsou určené pro verzi 5 služby Spring Data Azure Cosmos DB. Poznámky k verzi pro verzi 3 najdete tady a verzi 2 najdete tady.

Spring Data Azure Cosmos DB podporuje pouze rozhraní API pro NoSQL.

Informace o Spring Data v dalších rozhraních API služby Azure Cosmos DB najdete v těchto článcích:

Důležité

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Můžete si aktivovat výhody pro předplatitele sady Visual Studio: Za své předplatné sady Visual Studio každý měsíc získáváte kredity, které můžete použít k placení za služby Azure.

Službu Azure Cosmos DB můžete vyzkoušet zdarma bez předplatného Azure a bez nutnosti závazku. Alternativně můžete vytvořit účet úrovně Free služby Azure Cosmos DB s prvních 1 000 RU/s a 25 GB úložiště zdarma. Emulátor služby Azure Cosmos DB můžete také použít s identifikátorem URI https://localhost:8081služby . Klíč, který se má použít s emulátorem, najdete v tématu Ověřování požadavků.

Nejnovější ukázkové aplikace, které provádějí operace CRUD a další běžné operace s prostředky Azure Cosmos DB, jsou součástí úložiště GitHubu azure-spring-boot-samples . Tento článek obsahuje:

Odkazuje na úkoly v jednotlivých ukázkových souborech projektu Spring Data Azure Cosmos DB.
Odkazy na související referenční obsah rozhraní API

Požadavky

Ke spuštění této ukázkové aplikace budete potřebovat:

Sadu Java Development Kit (JDK) 8
Spring Data Azure Cosmos DB v5

Volitelně můžete pomocí Mavenu získat nejnovější binární soubory Spring Data Azure Cosmos DB verze 3 pro použití v projektu. Maven automaticky přidá všechny potřebné závislosti. Jinak můžete přímo stáhnout závislosti uvedené v souboru pom.xml a přidat je do cesty sestavení.

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

Spuštění ukázkových aplikací

Naklonování ukázkového úložiště:

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

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

Ukázky můžete spustit pomocí integrovaného vývojového prostředí (Eclipse, IntelliJ nebo VS Code) nebo z příkazového řádku pomocí Mavenu.

V souboru application.properties musí být tyto proměnné prostředí nastaveny.

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

abyste ukázkám poskytli přístup pro čtení a zápis k vašemu účtu, databázím a kontejnerům.

Integrované vývojové prostředí (IDE) může poskytnout možnost spuštění ukázkového kódu Spring Data. V opačném případě můžete k provedení ukázky použít následující příkaz terminálu:

mvn spring-boot:run

Příklady CRUD dokumentu

Ukázkový soubor ukazuje, jak provádět následující úlohy. Další informace o dokumentech Azure Cosmos DB před spuštěním následujících ukázek najdete v koncepčním článku Práce s databázemi, kontejnery a položkami .

Úloha	Reference rozhraní API
Vytvoření dokumentu	CosmosRepository.save
Čtení dokumentu podle ID	CosmosRepository.derivedQueryMethod
Odstranit všechny dokumenty	CosmosRepository.deleteAll

Příklady odvozených metod dotazů

Ukázkový soubor ukazuje, jak provádět následující úlohy. Pokud se chcete seznámit s dotazy Azure Cosmos DB před spuštěním následujících ukázek, může být užitečné přečíst si odvozené metody dotazů Baeldungu v článku Spring .

| Dotaz na dokumenty | CosmosRepository.derivedQueryMethod |

Příklady vlastních dotazů

Ukázkový soubor ukazuje, jak provádět následující úlohy pomocí gramatiky dotazu SQL. Další informace o referenčních informacích k dotazům SQL ve službě Azure Cosmos DB před spuštěním následujících ukázek najdete v příkladech dotazů SQL pro Službu Azure Cosmos DB.

Úloha	Reference rozhraní API
Dotazování na všechny dokumenty	@Query anotace
Dotaz na rovnost s využitím ==	@Query anotace
Dotaz na nerovnost s využitím != a NOT	@Query anotace
Dotaz pomocí operátorů rozsahu, jako >je , = <><	@Query anotace
Dotaz s využitím operátorů rozsahu na řetězce	@Query anotace
Dotazování pomocí FUNKCE ORDER BY	@Query anotace
Dotazování s využitím DISTINCT	@Query anotace
Dotazování s agregačními funkcemi	@Query anotace
Práce s vnořenými dokumenty	@Query anotace
Dotaz s využitím operace Join uvnitř dokumentů	@Query anotace
Dotazování pomocí řetězcových, matematických a maticových operátorů	@Query anotace

Další kroky

Pokoušíte se naplánovat kapacitu migrace do služby Azure Cosmos DB? Informace o stávajícím databázovém clusteru můžete použít k plánování kapacity.

Pokud víte, že je počet virtuálních jader a serverů ve vašem existujícím databázovém clusteru, přečtěte si o odhadu jednotek žádostí pomocí virtuálních jader nebo virtuálních procesorů.
Pokud znáte typické sazby požadavků pro vaši aktuální úlohu databáze, přečtěte si informace o odhadu jednotek žádostí pomocí plánovače kapacity služby Azure Cosmos DB.

Sdílet prostřednictvím