A Spring Data Apache Cassandra API használata az Azure Cosmos DB-vel

Ebben a cikkben egy mintaalkalmazás létrehozását mutatjuk be, amely a Spring Data és az Azure Cosmos DB Cassandra API használatával tárol és kér le információkat.

Előfeltételek

A cikkben leírt lépések elvégzéséhez a következő előfeltételek szükségesek:

Azure Cosmos DB-fiók létrehozása

Az alábbi eljárás egy Cosmos-fiókot hoz létre és konfigurál az Azure Portalon.

Cosmos DB-fiók létrehozása az Azure Portalon

Megjegyzés

Az Azure Cosmos DB-fiókok létrehozásával kapcsolatos részletes információkat az Azure Cosmos DB dokumentációjában olvashatja át.

  1. Lépjen az Azure Portalra a https://portal.azure.com/ webhelyen, és jelentkezzen be.

  2. Válassza az Erőforrás létrehozása, majd Első lépések, majd az Azure Cosmos DB lehetőséget.

    Azure portal, create a resource, search for Azure Cosmos DB.

  3. Az API kiválasztása képernyőn válassza a Cassandra lehetőséget.

    Azure portal, create a resource, select API option, Cassandra selected.

  4. Adja meg a következő információkat:

    • Előfizetés: Adja meg a használni kívánt Azure-előfizetést.
    • Erőforráscsoport: Adja meg, hogy új erőforráscsoportot szeretne-e létrehozni, vagy válasszon egy meglévő erőforráscsoportot.
    • Fióknév: Válasszon egyedi nevet a Cosmos DB-fióknak; ez egy teljesen minősített tartománynév, például wingtiptoyscassandra.documents.azure.com létrehozásához használható.
    • API: Adja meg a Cassandra-t ehhez az oktatóanyaghoz.
    • Hely: Adja meg az adatbázishoz legközelebbi földrajzi régiót.

    Specify your Cosmos DB account settings.

  5. Miután megadta az összes fenti adatot, kattintson az Ellenőrzés és létrehozás lehetőségre.

  6. Ha az áttekintési lapon minden rendben lévőnek tűnik, kattintson a Létrehozás gombra.

    Review your Cosmos DB account settings.

Az adatbázis üzembe helyezése néhány percet vesz igénybe.

Kulcstér hozzáadása az Azure Cosmos DB-fiókhoz

  1. Lépjen az Azure Portalra a https://portal.azure.com/ webhelyen, és jelentkezzen be.

  2. Válassza az Összes erőforrás lehetőséget, majd válassza ki az imént létrehozott Azure Cosmos DB-fiókot.

  3. Válassza a Data Explorer, a lefelé mutató nyíl, majd az Új kulcstér lehetőséget. Adjon meg egy egyedi azonosítót a kulcstérazonosítóhoz, majd kattintson az OK gombra.

    Select new keyspace.

    Create a Cosmos DB keyspace.

Az Azure Cosmos DB-fiók kapcsolati beállításainak lekérése

  1. Lépjen az Azure Portalra a https://portal.azure.com/ webhelyen, és jelentkezzen be.

  2. Válassza az Összes erőforrás lehetőséget, majd válassza ki az imént létrehozott Azure Cosmos DB-fiókot.

  3. Válassza ki a kapcsolati sztringeket, és másolja ki a Kapcsolattartó pont, a Port, a Felhasználónév és az Elsődleges jelszó mezők értékeit; ezeket az értékeket fogja használni az alkalmazás későbbi konfigurálásához.

    Retrieve your Cosmos DB connection settings.

A mintaalkalmazás konfigurálása

A tesztalkalmazás az alábbi eljárással konfigurálható.

  1. Nyisson meg egy parancsfelületet, és klónozza a mintaprojektet a következőhöz hasonló git-paranccsal:

    git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
    
  2. Keresse meg az application.properties fájlt a mintaprojekt resources mappájában, vagy hozza létre, ha még nem létezne.

  3. Nyissa meg az application.properties fájlt egy szövegszerkesztőben, majd adja hozzá vagy konfigurálja a következő sorokat a fájlban, és cserélje a mintaértékeket a megfelelő értékekre korábbról:

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

    Ahol:

    Paraméter Leírás
    spring.data.cassandra.contact-points A Kapcsolati pont értékét adja meg – lásd a cikk korábbi részében.
    spring.data.cassandra.port A Port értékét adja meg – lásd a cikk korábbi részében.
    spring.data.cassandra.username A Felhasználónév értékét adja meg – lásd a cikk korábbi részében.
    spring.data.cassandra.password Az Elsődleges jelszó értékét adja meg – lásd a cikk korábbi részében.
  4. Mentse és zárja be az application.properties fájlt.

A mintaalkalmazás csomagolása és tesztelése

Lépjen a .pom fájlt tartalmazó könyvtárra az alkalmazás összeállításához és teszteléséhez.

  1. Állítsa össze a mintaalkalmazást Mavennel – például:

    mvn clean package
    
  2. Indítsa el a mintaalkalmazást. Például:

    java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
    
  3. Hozzon létre új rekordokat a curl használatával egy parancssorból, mint az alábbi példákban:

    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
    

    Az alkalmazásnak a következőhöz hasonló értékeket kell visszaadnia:

    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. Kérje le a meglévő rekordokat a curl használatával egy parancssorból, mint az alábbi példákban:

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

    Az alkalmazásnak a következőhöz hasonló értékeket kell visszaadnia:

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

Összefoglalás

Ebben az oktatóanyagban egy Java-mintaalkalmazást hozott létre, amely a Spring Data és az Azure Cosmos DB Cassandra API használatával információkat tárol és kér le.

Az erőforrások eltávolítása

Ha már nincs rájuk szüksége, az Azure Portalon törölheti a cikkhez létrehozott erőforrásokat a váratlan költségek elkerülése érdekében.

Következő lépések

Ha szeretne többet megtudni a Spring és az Azure szolgáltatásról, lépjen tovább a Spring on Azure dokumentációs központra.

További források

Az Azure a Javával való együttes használatáról további információt az Azure Java-fejlesztőknek és Az Azure DevOps és a Java használata című cikkben találhat.