How to use Spring Data with Azure Cosmos DB for Apache Cassandra

Artykuł
10/23/2023

W tym artykule przedstawiono tworzenie przykładowej aplikacji, która używa rozwiązania Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB dla bazy danych Apache Cassandra.

Wymagania wstępne

Subskrypcja platformy Azure — utwórz bezpłatnie.
Zestaw Java Development Kit (JDK) w wersji 8 lub nowszej.
Apache Maven.
Interfejs wiersza polecenia platformy Azure.

Klient usługi Git.
cURL lub podobne narzędzie HTTP do testowania funkcjonalności.

Tworzenie konta usługi Azure Cosmos DB

Poniższa procedura tworzy i konfiguruje konto usługi Azure Cosmos DB w witrynie Azure Portal.

Tworzenie konta usługi Azure Cosmos DB przy użyciu witryny Azure Portal

Uwaga

Więcej szczegółowych informacji na temat tworzenia kont można znaleźć w dokumentacji usługi Azure Cosmos DB.

Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.
Wybierz pozycję Utwórz zasób, a następnie pozycję Rozpocznij, a następnie wybierz pozycję Azure Cosmos DB.
Na ekranie Wybierz interfejs API wybierz pozycję Cassandra.
Pozwala określić następujące informacje:
- Subskrypcja: określ subskrypcję platformy Azure do użycia.
- Grupa zasobów: określ, czy chcesz utworzyć nową grupę zasobów, czy wybrać istniejącą grupę zasobów.
- Nazwa konta: wybierz unikatową nazwę konta usługi Azure Cosmos DB. Ta nazwa zostanie użyta do utworzenia w pełni kwalifikowanej nazwy domeny, takiej jak wingtiptoyscassandra.documents.azure.com.
- Interfejs API: określ cassandra na potrzeby tego samouczka.
- Lokalizacja: określ najbliższy region geograficzny dla bazy danych.
Po wprowadzeniu wszystkich powyższych informacji kliknij pozycję Przejrzyj i utwórz.
Jeśli na stronie przeglądu wszystko wygląda poprawnie, kliknij przycisk Utwórz.

Wdrożenie bazy danych trwa kilka minut.

Dodawanie przestrzeni kluczy do konta usługi Azure Cosmos DB

Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.
Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto usługi Azure Cosmos DB.
Wybierz pozycję Eksplorator danych, wybierz strzałkę w dół i wybierz pozycję Nowa przestrzeń kluczy. Wprowadź unikatowy identyfikator identyfikatora przestrzeni kluczy, a następnie wybierz przycisk OK.

Pobieranie ustawień połączenia dla konta usługi Azure Cosmos DB

Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.
Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto usługi Azure Cosmos DB.
Wybierz ciągi Połączenie ion i skopiuj wartości pól Punkt kontaktu, Port, Nazwa użytkownika i Hasło podstawowe. Te wartości będą używane do późniejszego skonfigurowania aplikacji.

Konfigurowanie aplikacji przykładowej

Poniższa procedura umożliwia skonfigurowanie aplikacji testowej.

Otwórz powłokę poleceń i sklonuj przykładowy projekt przy użyciu polecenia git, jak w poniższym przykładzie:
```
git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
```
Znajdź plik application.properties w katalogu resources przykładowego projektu lub utwórz plik, jeśli jeszcze nie istnieje.

Otwórz plik application.properties w edytorze tekstów, a następnie dodaj lub skonfiguruj następujące wiersze w pliku i zastąp przykładowe wartości odpowiednimi wartościami skopiowanymi wcześniej:

spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
spring.data.cassandra.port=10350
spring.data.cassandra.username=wingtiptoyscassandra
spring.data.cassandra.password=********

Gdzie:

Parametr	Opis
`spring.data.cassandra.contact-points`	Podaj wartość pola Punkt kontaktowy z wcześniejszej części tego artykułu.
`spring.data.cassandra.port`	Podaj wartość pola Port z wcześniejszej części tego artykułu.
`spring.data.cassandra.username`	Podaj wartość pola Nazwa użytkownika z wcześniejszej części tego artykułu.
`spring.data.cassandra.password`	Podaj wartość pola Hasło podstawowe z wcześniejszej części tego artykułu.

Zapisz i zamknij plik application.properties.

Pakowanie i testowanie aplikacji przykładowej

Przejdź do katalogu zawierającego plik pom.xml , aby skompilować i przetestować aplikację.

Skompiluj aplikację przykładową przy użyciu narzędzia Maven, na przykład:
```
mvn clean package
```

Uruchom aplikację przykładową, na przykład:

java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar

Utwórz nowe rekordy przy użyciu narzędzia curl z poziomu wiersza polecenia, tak jak w następujących przykładach:

curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets

curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets

Aplikacja powinna zwracać wartości podobne do następującego przykładu:

Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.

Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.

Pobierz wszystkie istniejące rekordy przy użyciu narzędzia curl z poziomu wiersza polecenia, tak jak w następujących przykładach:
```
curl -s http://localhost:8080/pets
```
Aplikacja powinna zwracać wartości podobne do następujących przykładów:
```
[{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
```

Podsumowanie

W tym samouczku utworzono przykładową aplikację Java, która używa rozwiązania Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB dla usługi Apache Cassandra.

Czyszczenie zasobów

Gdy zasoby utworzone w tym artykule nie będą już potrzebne, usuń je w witrynie Azure Portal, aby uniknąć naliczania opłat.

Następne kroki

Aby dowiedzieć się więcej na temat oprogramowania Spring i platformy Azure, przejdź do centrum dokumentacji dotyczącej oprogramowania Spring na platformie Azure.

Oprogramowanie Spring na platformie Azure

Zobacz też

Aby uzyskać więcej informacji na temat korzystania z platformy Azure przy użyciu języka Java, zapoznaj się z tematami Platforma Azure dla deweloperów języka Java oraz Praca z narzędziami Azure DevOps i językiem Java.

Share via