Använda Spring Data med Azure Cosmos DB för Apache Cassandra

Den här artikeln visar hur du skapar ett exempelprogram som använder Spring Data för att lagra och hämta information med Hjälp av Azure Cosmos DB för Apache Cassandra.

Förutsättningar

• En Azure-prenumeration – skapa en kostnadsfritt.

• Java Development Kit (JDK), version 8 eller senare.

• Apache Maven.

• Azure CLI.

• En Git-klient.

• cURL eller ett liknande HTTP-verktyg för att testa funktioner.

Skapa ett Azure Cosmos DB-konto

Följande procedur skapar och konfigurerar ett Azure Cosmos DB-konto i Azure-portalen.

Skapa ett Azure Cosmos DB-konto med hjälp av Azure-portalen

Kommentar

Du kan läsa mer detaljerad information om hur du skapar konton i Azure Cosmos DB-dokumentationen.

1. Gå till Azure Portal på https://portal.azure.com/ och logga in.

2. Välj Skapa en resurs och sedan Kom igång och välj sedan Azure Cosmos DB.

3. På skärmen Välj API-alternativ väljer du Cassandra.

   

4. Ange följande information:

   • Prenumeration: Ange din Azure-prenumeration som ska användas.
   • Resursgrupp: Ange om du vill skapa en ny resursgrupp eller välja en befintlig resursgrupp.
   • Kontonamn: Välj ett unikt namn för ditt Azure Cosmos DB-konto. Det här namnet används för att skapa ett fullständigt domännamn som wingtiptoyscassandra.documents.azure.com.
   • API: Ange Cassandra för den här självstudien.
   • Plats: Ange den närmaste geografiska regionen för databasen.

   

5. När du har angett all ovanstående information klickar du på Granska + skapa.

6. Om allting ser korrekt ut på sidan Granska klickar du på Skapa.

Det tar några minuter att distribuera databasen.

Lägg till ett nyckelutrymme i ditt Azure Cosmos DB-konto

1. Gå till Azure Portal på https://portal.azure.com/ och logga in.

2. Välj Alla resurser och välj sedan det Azure Cosmos DB-konto som du skapade.

3. Välj Datautforskaren, välj nedåtpil och välj Nytt nyckelområde. Ange en unik identifierare för ditt Nyckelområdes-ID och välj sedan OK.

   

   

Hämta anslutningsinställningarna för ditt Azure Cosmos DB-konto

1. Gå till Azure Portal på https://portal.azure.com/ och logga in.

2. Välj Alla resurser och välj sedan det Azure Cosmos DB-konto som du skapade.

3. Välj Anslut ionssträngar och kopiera värdena för fälten Kontaktpunkt, Port, Användarnamn och Primärt lösenord. Du använder dessa värden för att konfigurera programmet senare.

   

Konfigurera exempelprogrammet

Följande procedur konfigurerar testprogrammet.

1. Öppna ett kommandogränssnitt och klona exempelprojektet med ett git-kommando som i följande exempel:

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

2. Leta upp filen application.properties i resurskatalogen för exempelprojektet eller skapa filen om den inte redan finns.

3. Öppna filen application.properties i en textredigerare och lägg till eller konfigurera följande rader i filen och ersätt exempelvärdena med lämpliga värden från tidigare:

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

   Där:

   Parameter	Description
   spring.data.cassandra.contact-points	Anger Kontaktpunkt från tidigare i den här artikeln.
   spring.data.cassandra.port	Anger Port från tidigare i den här artikeln.
   spring.data.cassandra.username	Anger Användarnamn från tidigare i den här artikeln.
   spring.data.cassandra.password	Anger Primärt lösenord från tidigare i den här artikeln.

4. Spara och stäng filen application.properties.

Paketera och testa exempelprogrammet

Bläddra till katalogen som innehåller pom.xml-filen för att skapa och testa programmet.

1. Bygg exempelprogrammet med hjälp av Maven, som exempelvis:

   mvn clean package
   

2. Starta exempelprogrammet, exempelvis:

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

3. Skapa nya poster med curl från kommandotolken som i följande exempel:

   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
   

   Programmet bör returnera värden som i följande exempel:

   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. Hämta alla befintliga poster med curl från kommandotolken så som i följande exempel:

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

   Programmet bör returnera värden som följande exempel:

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

Sammanfattning

I den här självstudien har du skapat ett Java-exempelprogram som använder Spring Data för att lagra och hämta information med Hjälp av Azure Cosmos DB för Apache Cassandra.

Rensa resurser

När de inte längre behövs använder du Azure Portal för att ta bort de resurser som skapats i den här artikeln för att undvika oväntade kostnader.

Nästa steg

Om du vill veta mer om Spring och Azure kan du fortsätta till dokumentationscentret för Spring i Azure.

Spring på Azure

Se även

Mer information om hur du använder Azure med Java finns i Azure för Java-utvecklare och Arbeta med Azure DevOps och Java.