Spring Data használata az Apache Cassandra-hoz készült Azure Cosmos DB-vel

Ez a cikk egy mintaalkalmazás létrehozását mutatja be, amely Spring Data használatával tárol és kér le adatokat Azure Cosmos DB for Apache Cassandrahasználatával.

Előfeltételek

• Azure-előfizetés – hozzon létre egyet ingyen.

• Java Development Kit (JDK), 8-os vagy újabb verzió.

• Apache Maven.

• Azure parancssori felület (CLI).

• Egy Git ügyfél.

• cURL vagy egy hasonló HTTP-segédprogramot a funkciók teszteléséhez.

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

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

Azure Cosmos DB-fiók létrehozása az Azure Portal használatával

Jegyzet

A fiókok létrehozásáról részletesebb információkat az Azure Cosmos DB dokumentációjábanolvashat.

1. Nyissa meg az Azure Portal oldalt a https://portal.azure.com/ címen, és jelentkezzen be.

2. Válassza Erőforrás létrehozása, majd Első lépéseklehetőséget, majd válassza Azure Cosmos DBlehetőséget.

3. Az API kiválasztása opció képernyőn válassza ki a Cassandraopciót.

   

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 az Azure Cosmos DB-fiókhoz; ezzel a névvel hozzon létre egy teljes tartománynevet, például wingtiptoyscassandra.documents.azure.com.
   • API: Adja meg Cassandra ehhez az oktatóanyaghoz.
   • Hely: Adja meg az adatbázis legközelebbi földrajzi régióját.

   

5. A fenti információk megadása után kattintson a Véleményezés + létrehozásgombra.

6. Ha minden helyesnek tűnik az áttekintő oldalon, kattintson a Create 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. Nyissa meg az Azure Portal oldalt a https://portal.azure.com/ címen, és jelentkezzen be.

2. Válassza Minden erőforráslehetőséget, majd válassza ki a létrehozott Azure Cosmos DB-fiókot.

3. Válassza a Adatböngésző, majd a lefelé mutató nyilat, és válassza a Új kulcstérlehetőséget. Adjon meg egy egyedi azonosítót a keyspace ID-jéhez, majd válassza OKlehetőséget.

   

   

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

1. Nyissa meg az Azure Portal oldalt a https://portal.azure.com/ címen, és jelentkezzen be.

2. Válassza Minden erőforráslehetőséget, majd válassza ki a létrehozott Azure Cosmos DB-fiókot.

3. Jelölje ki kapcsolati sztringeket, és másolja a kapcsolati pont, port, felhasználónévés elsődleges jelszó mező é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

Az alábbi eljárás konfigurálja a tesztalkalmazást.

1. Nyisson meg egy parancshéjat, és klónozza a mintaprojektet az alábbi példához hasonló Git-paranccsal:

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

2. Keresse meg a application.properties fájlt a mintaprojekt erőforrások könyvtárában, vagy hozza létre a fájlt, ha még nem létezik.

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

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

   Hol:

   Paraméter	Leírás
   spring.data.cassandra.contact-points	Meghatározza a kapcsolattartó pontot a cikk korábbi részében.
   spring.data.cassandra.port	Megadja a port-et, amelyet korábban említettek ebben a cikkben.
   spring.data.cassandra.username	Meghatározza a cikk korábbi részéből vett felhasználónevét.
   spring.data.cassandra.password	Adja meg az ön elsődleges jelszavát a cikk korábbi szakaszából.

4. Mentse és zárja be az application.properties fájlt.

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

Keresse meg a pom.xml fájlt tartalmazó könyvtárat az alkalmazás létrehozásához és teszteléséhez.

1. Hozza létre a mintaalkalmazást a 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 curl parancssorból, például az alábbi példákból:

   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 az alábbi példához 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. Az összes meglévő rekord lekérése curl használatával egy parancssorból, az alábbi példákhoz hasonlóan:

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

   Az alkalmazásnak az alábbi példákhoz 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 létrehozott egy Java-mintaalkalmazást, amely a Spring Data használatával tárol és kér le adatokat az Azure Cosmos DB for Apache Cassandra használatával.

Erőforrások törlése

Ha már nincs rá szükség, a Azure Portal használatával törölheti a cikkben létrehozott erőforrásokat a váratlan költségek elkerülése érdekében.

Következő lépések

Ha többet szeretne megtudni a Springről és az Azure-ról, lépjen tovább a Spring on Azure dokumentációs központjába.

Tavasz az Azure-on

Lásd még:

Az Azure és a Java használatáról további információkért tekintse meg az Azure for Java Developers és a Working with Azure DevOps and Javacikkeket.