Udostępnij za pośrednictwem


Jak używać Spring Data z Azure Cosmos DB dla Apache Cassandra

W tym artykule przedstawiono tworzenie przykładowej aplikacji korzystającej z Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB for Apache Cassandra.

Warunki wstępne

  • Klient Git.

  • cURL lub podobne narzędzie HTTP do testowania funkcji.

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

Notatka

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

  1. Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.

  2. Wybierz pozycję Utwórz zasób, a następnie Rozpocznij, a następnie wybierz pozycję Azure Cosmos DB.

  3. Na ekranie Select API option wybierz opcję Cassandra.

    portal Azure, utwórz zasób, wybierz opcję API, wybierz Cassandrę.

  4. Określ następujące informacje:

    • Subskrypcja: Określ subskrypcję platformy Azure do wykorzystania.
    • grupa zasobów: określ, czy 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.
    • interfejsu API: określ Cassandra na potrzeby tego samouczka.
    • Lokalizacja: określ najbliższy region geograficzny dla bazy danych.

    Określ ustawienia konta usługi Azure Cosmos DB.

  5. Po wprowadzeniu wszystkich powyższych informacji, kliknij opcję Przejrzyj i utwórz.

  6. Jeśli wszystko wygląda poprawnie na stronie przeglądu, kliknij przycisk Utwórz.

Wdrożenie bazy danych trwa kilka minut.

Dodawanie przestrzeni kluczy do konta usługi Azure Cosmos DB

  1. Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.

  2. Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto usługi Azure Cosmos DB.

  3. Wybierz pozycję Eksplorator danych, wybierz strzałkę w dół i wybierz pozycję New Keyspace. Wprowadź unikatowy identyfikator Keyspace, a następnie wybierz OK.

    Wybierz nową przestrzeń kluczy.

    Utwórz przestrzeń kluczy usługi Azure Cosmos DB.

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

  1. Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.

  2. Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto usługi Azure Cosmos DB.

  3. Wybierz parametry połączenia i skopiuj wartości pól Punkt kontaktowy, port , nazwa użytkownikai podstawowe hasło; Użyjesz tych wartości do późniejszego skonfigurowania aplikacji.

    Pobierz ustawienia połączenia usługi Azure Cosmos DB.

Konfigurowanie przykładowej aplikacji

Poniższa procedura umożliwia skonfigurowanie aplikacji testowej.

  1. Otwórz powłokę poleceń i sklonuj przykładowy projekt za pomocą polecenia git, jak w poniższym przykładzie:

    git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
    
  2. Znajdź plik application.properties w katalogu zasobów przykładowego projektu lub utwórz plik, jeśli jeszcze nie istnieje.

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

    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 Określa punkt kontaktowy z wcześniejszej części tego artykułu.
    spring.data.cassandra.port Określa port we wcześniejszej części tego artykułu.
    spring.data.cassandra.username Określa nazwę użytkownika z wcześniejszej sekcji tego artykułu.
    spring.data.cassandra.password Wskazuje podstawowe hasło z wcześniejszej części tego artykułu.
  4. Zapisz i zamknij plik application.properties.

Pakowanie i testowanie przykładowej aplikacji

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

  1. Skompiluj przykładową aplikację za pomocą narzędzia Maven; na przykład:

    mvn clean package
    
  2. Uruchom przykładową aplikację; na przykład:

    java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
    
  3. Utwórz nowe rekordy przy użyciu curl z poziomu wiersza polecenia, 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'}.
    
  4. Pobierz wszystkie istniejące rekordy przy użyciu curl z wiersza polecenia, 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"}]
    

Streszczenie

W tym samouczku utworzono przykładową aplikację Java, która używa Spring Data do przechowywania i pobierania informacji z Azure Cosmos DB przeznaczonej do Apache Cassandra.

Czyszczenie zasobów

Gdy zasoby utworzone w tym artykule nie będą już potrzebne, użyj Azure Portal, aby uniknąć nieoczekiwanych opłat.

Następne kroki

Aby dowiedzieć się więcej na temat platformy Spring i platformy Azure, przejdź do Centrum dokumentacji platformy Azure.

Zobacz też

Aby uzyskać więcej informacji na temat korzystania z platformy Azure z językiem Java, zobacz Azure for Java Developers oraz Praca z usługami Azure DevOps i Java.