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:

• Egy Azure-előfizetés. Ha még nincs Azure-előfizetése, aktiválhatja MSDN-előfizetői előnyeit, vagy regisztrálhat egy ingyenes Azure-fiókot.
• Egy támogatott Java fejlesztői készlet (JDK). Az Azure-beli fejlesztés során használható JDK-król további információt az Azure-ban és az Azure Stackben elérhető Java-támogatásban talál.
• Az Apache Maven 3.0-s vagy újabb verziója.
• Curl vagy hasonló HTTP-segédeszköz a működés teszteléséhez.
• Egy Git-ügyfél.

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.

   

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

   

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.

   

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.

   

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.

   

   

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.

   

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.

A Spring használata az Azure-ban

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.