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

Den här artikeln visar hur du använder Spring Data med Azure Cosmos DB för Apache Cassandra för att skapa ett exempel Java program som lagrar och hämtar data.

Förutsättningar

  • 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

Mer information om hur du skapar konton finns i dokumentationen om Azure Cosmos DB.

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

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

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

    Skärmbild av alternativsidan för Azure-portalens API med Cassandra valt.

  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.

    Skärmbild av Azure Cosmos DB kontoinställningar i Azure-portalen.

  5. När du anger all föregående information väljer du Granska + skapa.

  6. Om allt ser korrekt ut på granskningssidan väljer du 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 resurser och välj sedan det Azure Cosmos DB konto som du skapade.

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

    Skärmbild av Data Explorer med alternativet Ny nyckelrymd valt.

    Skärmbild av dialogrutan som används för att skapa en Azure Cosmos DB nyckelrymd.

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 resurser och välj sedan det Azure Cosmos DB konto som du skapade.

  3. Välj Anslutningssträ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.

    Skärmbild av Azure Cosmos DB reťazec pripojenia inställningar i Azure-portalen.

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 hjälp curl av från en kommandotolk. Följande exempel visar hur du skapar poster:

    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 hjälp curl av en kommandotolk. Följande exempel visar hur du hämtar poster:

    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 skapade du ett exempel Java program 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 resurserna använder du Azure-portalen för att ta bort dem. Om du tar bort resurserna kan du 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.

Våren 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.

  • Last updated on