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

Ez a cikk bemutatja, hogyan hozhat létre egy 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.

Előfeltételek

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

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

• Apache Maven.

• Azure CLI.

• Egy Git-ügyfél.

• cURL vagy hasonló HTTP-segédprogram 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

Megjegyzés:

A fiókok létrehozásáról az Azure Cosmos DB dokumentációjában olvashat részletesebben.

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 az Első lépések, majd az Azure Cosmos DB lehetőséget.

   

3. Az API kiválasztása beállítási 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 egy egyedi nevet az Azure Cosmos DB-fiókhoz. Ez a név egy teljes 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ázis legközelebbi földrajzi régióját.

   

5. Amikor megadta az összes fenti információt, kattintson a Véleményezés + létrehozás gombra.

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 a létrehozott Azure Cosmos DB-fiókot.

3. Válassza az Adatkezelőt, válassza a lefelé mutató nyíl, majd az Új kulcstér lehetőséget. Adjon meg egy egyedi azonosítót a Keyspace-azonosí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 a létrehozott Azure Cosmos DB-fiókot.

3. Válassza ki a Csatlakozás ion sztringeket, és másolja ki a Kapcsolatpont, a Port, a Felhasználónév és az Elsődleges jelszó mezők értékeit. Ezeket az értékeket később konfigurálhatja az alkalmazáshoz.

   

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 erőforráskönyvtárában , vagy hozza létre a fájlt, ha még nem létezik.

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

Keresse meg azt a könyvtárat, amely a pom.xml fájlt tartalmazza az alkalmazás létrehozá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 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. 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 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"}]
   

Összesíté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.

Clean up resources

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.

További 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

Kapcsolódó információk

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.