Udostępnij za pośrednictwem

Azure Cosmos DB for NoSQL: Przykłady spring data usługi Azure Cosmos DB w wersji 5

  • Artykuł

DOTYCZY: NoSQL

Ważne

Te informacje o wersji dotyczą wersji 5 usługi Spring Data w usłudze Azure Cosmos DB. Informacje o wersji dla wersji 3 można znaleźć tutaj i w wersji 2 tutaj.

Usługa Spring Data w usłudze Azure Cosmos DB obsługuje tylko interfejs API dla noSQL.

Zobacz następujące artykuły, aby uzyskać informacje o usłudze Spring Data w innych interfejsach API usługi Azure Cosmos DB:

Ważne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

Możesz bezpłatnie wypróbować usługę Azure Cosmos DB bez subskrypcji platformy Azure i bez zobowiązania. Alternatywnie możesz utworzyć konto warstwy bezpłatnej usługi Azure Cosmos DB z pierwszymi 1000 RU/s i 25 GB miejsca do magazynowania bezpłatnie. Możesz również użyć emulatora usługi Azure Cosmos DB z identyfikatorem URI .https://localhost:8081 Aby uzyskać klucz do użycia z emulatorem, zobacz Uwierzytelnianie żądań.

Najnowsze przykładowe aplikacje, które wykonują operacje CRUD i inne typowe operacje na zasobach usługi Azure Cosmos DB, znajdują się w repozytorium GitHub azure-spring-boot-samples . Ten artykuł zawiera:

  • Linki do zadań w każdym z przykładowych plików projektu Spring Data w usłudze Azure Cosmos DB.
  • Linki do powiązanej dokumentacji interfejsu API.

Wymagania wstępne

Do uruchomienia tej aplikacji przykładowej potrzebne są następujące elementy:

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

Opcjonalnie możesz użyć narzędzia Maven, aby pobrać najnowsze pliki binarne spring Data usługi Azure Cosmos DB w wersji 3 do użycia w projekcie. Rozwiązanie Maven automatycznie dodaje wszystkie wymagane zależności. W przeciwnym razie możesz bezpośrednio pobrać zależności wymienione w pliku pom.xml i dodać je do ścieżki kompilacji.

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

Uruchamianie aplikacji przykładowych

Sklonuj repozytorium przykładowe:

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

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

Przykłady można uruchamiać przy użyciu środowiska IDE (Eclipse, IntelliJ lub VS Code) albo z wiersza polecenia przy użyciu narzędzia Maven.

W pliku application.properties te zmienne środowiskowe muszą być ustawione

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

w celu udzielenia przykładom dostępu do odczytu/zapisu na koncie, bazach danych i kontenerach.

Środowisko IDE może zapewnić możliwość wykonywania przykładowego kodu Spring Data. W przeciwnym razie możesz użyć następującego polecenia terminalu, aby wykonać przykład:

mvn spring-boot:run

Przykłady operacji CRUD dokumentu

Plik przykładów pokazuje, jak wykonać następujące zadania. Aby dowiedzieć się więcej o dokumentach usługi Azure Cosmos DB przed uruchomieniem poniższych przykładów, zobacz Artykuł koncepcyjny Dotyczący pracy z bazami danych, kontenerami i elementami .

Zadanie Odwołanie do interfejsu API
Tworzenie dokumentu CosmosRepository.save
Odczytywanie dokumentu na podstawie identyfikatora CosmosRepository.derivedQueryMethod
Usuń wszystkie dokumenty CosmosRepository.deleteAll

Przykłady metod zapytań pochodnych

Plik przykładów pokazuje, jak wykonać następujące zadania. Aby dowiedzieć się więcej o zapytaniach usługi Azure Cosmos DB przed uruchomieniem poniższych przykładów, warto przeczytać artykuł Metody zapytań pochodnych Baeldung w środowisku Spring .

| Wykonywanie zapytań dotyczących dokumentów | CosmosRepository.derivedQueryMethod |

Przykłady zapytań niestandardowych

W pliku samples pokazano, jak wykonać następujące zadania przy użyciu gramatyki zapytań SQL. Aby dowiedzieć się więcej o dokumentacji zapytań SQL w usłudze Azure Cosmos DB przed uruchomieniem poniższych przykładów, zobacz Przykłady zapytań SQL dla usługi Azure Cosmos DB.

Zadanie Odwołanie do interfejsu API
Wykonywanie zapytań dotyczących wszystkich dokumentów @Query adnotacja
Wykonywanie zapytań dotyczących równości przy użyciu operatora == @Query adnotacja
Wykonywanie zapytań dotyczących nierówności przy użyciu operatorów != i NOT @Query adnotacja
Wykonywanie zapytań przy użyciu operatorów zakresu, takich jak >, <>= , = < @Query adnotacja
Wykonywanie zapytań przy użyciu operatorów zakresu względem ciągów @Query adnotacja
Wykonywanie zapytań za pomocą funkcji ORDER BY @Query adnotacja
Wykonywanie zapytań za pomocą funkcji DISTINCT @Query adnotacja
Wykonywanie zapytań za pomocą funkcji agregujących @Query adnotacja
Praca z dokumentami podrzędnymi @Query adnotacja
Wykonywanie zapytań przy użyciu sprzężeń wewnątrz dokumentu @Query adnotacja
Wykonywanie zapytań przy użyciu operatorów ciągów, matematycznych i tablic @Query adnotacja

Następne kroki

Próbujesz zaplanować pojemność migracji do usługi Azure Cosmos DB? Informacje o istniejącym klastrze bazy danych można użyć do planowania pojemności.