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 kostnadsfri.

• 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

Anteckning

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

1. Bläddra till Azure-portalen på https://portal.azure.com/ och logga in.

2. Välj Skapa en resursoch sedan Kom igångoch 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 handledningen.
   • 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 allt ser korrekt ut på granskningssidan klickar du på Skapa.

Det tar några minuter att distribuera databasen.

Lägga till en nyckelrymd i ditt Azure Cosmos DB-konto

1. Bläddra till Azure-portalen på https://portal.azure.com/ och logga in.

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

3. Välj DataUtforskaren, välj nedåtpil och välj Ny nyckelrymd. Ange en unik identifierare för ditt Keyspace-IDoch välj sedan OK.

   

   

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

1. Bläddra till Azure-portalen på https://portal.azure.com/ och logga in.

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

3. Välj Anslutningssträngaroch kopiera värdena för Kontaktpunkt, Port, Användarnamnoch primära fält för 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 resurser katalogen i 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=********
   

   Var:

   Parameter	Beskrivning
   spring.data.cassandra.contact-points	Anger kontaktpunkten som nämnts 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 ditt användarnamn från tidigare i den här artikeln.
   spring.data.cassandra.password	Anger ditt primära 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 filen pom.xml för att skapa och testa programmet.

1. Skapa exempelprogrammet med Maven; till exempel:

   mvn clean package
   

2. Starta exempelprogrammet. till exempel:

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

3. Skapa nya poster med curl från en kommandorad 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 en kommandotolk 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 handledningen skapade du 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 du inte längre behöver det kan du använda Azure-portalen för att ta bort resurserna som skapas i den här artikeln för att undvika oväntade avgifter.

Nästa steg

Om du vill veta mer om Spring och Azure fortsätter du till dokumentationscentret för Spring on Azure.

Spring på Azure

Se även

Mer information om hur du använder Azure med Java finns i Azure for Java Developers och Working with Azure DevOps and Java.