So verwenden Sie Spring Data mit Azure Cosmos DB für Apache Cassandra

In diesem Artikel wird die Erstellung einer Beispielanwendung veranschaulicht, die Spring Data verwendet, um Informationen mithilfe Azure Cosmos DB für Apache Cassandrazu speichern und abzurufen.

Voraussetzungen

• Azure-Abonnement kostenloses Abonnement erstellen

• Java Development Kit (JDK), Version 8 oder höher.

• Apache Maven

• Azure-CLI.

• Einen Git-Client

• cURL oder ein ähnliches HTTP-Hilfsprogramm zum Testen der Funktionalität.

Erstellen eines Azure Cosmos DB-Kontos

Das folgende Verfahren erstellt und konfiguriert ein Azure Cosmos DB-Konto im Azure-Portal.

Erstellen eines Azure Cosmos DB-Kontos mithilfe des Azure-Portals

Anmerkung

Ausführlichere Informationen zum Erstellen von Konten finden Sie in der Azure Cosmos DB-Dokumentation.

1. Navigieren Sie zum Azure-Portal unter https://portal.azure.com/, und melden Sie sich an.

2. Wählen Sie Ressource erstellen > Erste Schritte > Azure Cosmos DB aus.

3. Wählen Sie auf dem Bildschirm API-Option auswählen die Option Cassandra aus.

   

4. Geben Sie die folgenden Informationen an:

   • Abonnement: Geben Sie Ihr Azure-Abonnement an, das sie verwenden soll.
   • Ressourcengruppe: Geben Sie an, ob eine neue Ressourcengruppe erstellt werden soll, oder wählen Sie eine vorhandene Ressourcengruppe aus.
   • Kontoname: Wählen Sie einen eindeutigen Namen für Ihr Azure Cosmos DB-Konto aus; Dieser Name wird verwendet, um einen vollqualifizierten Domänennamen wie wingtiptoyscassandra.documents.azure.comzu erstellen.
   • API: Geben Sie Cassandra für dieses Tutorial an.
   • Standort: Geben Sie die nächstgelegene geografische Region für Ihre Datenbank an.

   

5. Nachdem Sie alle oben genannten Informationen eingegeben haben, klicken Sie auf Bewerten + erstellen.

6. Wenn die Angaben auf der Seite „Überprüfen“ korrekt sind, klicken Sie auf Erstellen.

Es dauert ein paar Minuten, die Datenbank bereitzustellen.

Hinzufügen eines Keyspace zu Ihrem Azure Cosmos DB-Konto

1. Navigieren Sie zum Azure-Portal unter https://portal.azure.com/, und melden Sie sich an.

2. Wählen Sie Alle Ressourcenaus, und wählen Sie dann das von Ihnen erstellte Azure Cosmos DB-Konto aus.

3. Wählen Sie Daten-Explorer, den Abwärtspfeil und anschließend New Keyspace (Neuer Keyspace) aus. Geben Sie einen eindeutigen Bezeichner für Keyspace id (Keyspace-ID) ein, und wählen Sie dann OK aus.

   

   

Abrufen der Verbindungseinstellungen für das Azure Cosmos DB-Konto

1. Navigieren Sie zum Azure-Portal unter https://portal.azure.com/, und melden Sie sich an.

2. Wählen Sie Alle Ressourcenaus, und wählen Sie dann das von Ihnen erstellte Azure Cosmos DB-Konto aus.

3. Wählen Sie Verbindungszeichenfolgenaus, und kopieren Sie die Werte für die Felder Kontaktpunkt, Port, Benutzernameund Felder für das primäre Kennwort; Sie verwenden diese Werte, um Ihre Anwendung später zu konfigurieren.

   

Konfigurieren der Beispielanwendung

Im folgenden Verfahren wird die Testanwendung konfiguriert.

1. Öffnen Sie eine Befehlsshell, und klonen Sie das Beispielprojekt mit einem Git-Befehl wie dem folgenden Beispiel:

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. Suchen Sie die Datei application.properties im Ressourcenverzeichnis des Beispielprojekts, oder erstellen Sie die Datei, falls sie noch nicht vorhanden ist.

3. Öffnen Sie die Datei application.properties in einem Text-Editor, und fügen Sie die folgenden Zeilen in der Datei hinzu, bzw. konfigurieren Sie diese Zeilen. Ersetzen Sie dabei die Beispielwerte durch die entsprechenden Werte, die Sie zuvor festgelegt haben:

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

   Wo:

   Parameter	Beschreibung
   spring.data.cassandra.contact-points	Der Kontaktpunkt, den Sie weiter oben in diesem Artikel kopiert haben.
   spring.data.cassandra.port	Der Port, den Sie weiter oben in diesem Artikel kopiert haben.
   spring.data.cassandra.username	Der Benutzername, den Sie weiter oben in diesem Artikel kopiert haben.
   spring.data.cassandra.password	Das primäre Kennwort, das Sie weiter oben in diesem Artikel kopiert haben.

4. Speichern und schließen Sie die application.properties Datei.

Packen und Testen der Beispielanwendung

Navigieren Sie zum Verzeichnis, das die pom.xml Datei enthält, um die Anwendung zu erstellen und zu testen.

1. Erstellen Sie die Beispielanwendung mit Maven; Zum Beispiel:

   mvn clean package
   

2. Starten Sie die Beispielanwendung; Zum Beispiel:

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

3. Erstellen Sie wie in den folgenden Beispielen dargestellt über eine Eingabeaufforderung mit curl neue Datensätze:

   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
   

   Ihre Anwendung sollte Werte wie das folgende Beispiel zurückgeben:

   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. Rufen Sie wie im folgenden Beispiel dargestellt über eine Eingabeaufforderung mit curl alle vorhandenen Datensätze ab:

   curl -s http://localhost:8080/pets
   

   Ihre Anwendung sollte Werte wie die folgenden Beispiele zurückgeben:

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

Zusammenfassung

In diesem Lernprogramm haben Sie eine Java-Beispielanwendung erstellt, die Spring Data verwendet, um Informationen mithilfe von Azure Cosmos DB für Apache Cassandra zu speichern und abzurufen.

Bereinigen von Ressourcen

Wenn sie nicht mehr benötigt wird, verwenden Sie das Azure-Portal, um die in diesem Artikel erstellten Ressourcen zu löschen, um unerwartete Gebühren zu vermeiden.

Nächste Schritte

Um mehr über Spring und Azure zu erfahren, fahren Sie mit dem Spring on Azure-Dokumentationscenter fort.

Spring Framework in Azure

Siehe auch

Weitere Informationen zur Verwendung von Azure mit Java finden Sie unter Azure für Java-Entwickler und Arbeiten mit Azure DevOps und Java.