Cara menggunakan Spring Data dengan Azure Cosmos DB untuk Apache Cassandra

Artikel
10/23/2023

Artikel ini menunjukkan pembuatan aplikasi sampel yang menggunakan Spring Data untuk menyimpan dan mengambil informasi menggunakan Azure Cosmos DB untuk Apache Cassandra.

Prasyarat

Langganan Azure - membuat secara gratis.
Java Development Kit (JDK), versi 8 atau yang lebih tinggi.
Apache Maven.
Azure CLI.

Klien Git.
cURL atau utilitas HTTP serupa untuk menguji fungsionalitas.

Membuat akun Azure Cosmos DB

Prosedur berikut membuat dan mengonfigurasi akun Azure Cosmos DB di portal Azure.

Membuat akun Azure Cosmos DB menggunakan Azure CLI

Catatan

Anda dapat membaca informasi lebih rinci tentang membuat akun dalam dokumentasi Azure Cosmos DB.

Buka portal Azure di https://portal.azure.com/, lalu masuk.
Pilih Buat sumber daya, lalu Mulai, lalu pilih Azure Cosmos DB.
Pada layar Pilih opsi API, pilih Cassandra.
Tentukan informasi berikut:
- Langganan: Tentukan langganan Azure Anda untuk yang akan digunakan.
- Grup sumber daya: Tentukan apakah akan membuat grup sumber daya baru atau memilih grup sumber daya yang ada.
- Nama akun: Pilih nama unik untuk akun Azure Cosmos DB Anda; nama ini akan digunakan untuk membuat nama domain yang sepenuhnya memenuhi syarat seperti wingtiptoyscassandra.documents.azure.com.
- API: Tentukan Cassandra untuk tutorial ini.
- Lokasi: Tentukan wilayah geografis terdekat untuk database Anda.
Setelah Anda memasukkan semua informasi di atas, klik Tinjau + buat.
Jika semuanya terlihat benar di halaman ulasan, klik Buat.

Dibutuhkan beberapa menit untuk menyebarkan database.

Menambahkan keyspace ke akun Azure Cosmos DB Anda

Buka portal Azure di https://portal.azure.com/, lalu masuk.
Pilih Semua Sumber Daya, lalu pilih akun Azure Cosmos DB yang Anda buat.
Pilih Data Explorer, pilih panah bawah dan pilih Keyspace Baru. Masukkan pengidentifikasi unik untuk id Keyspace Anda, lalu pilih OK.

Mengambil pengaturan koneksi untuk akun Azure Cosmos DB

Buka portal Azure di https://portal.azure.com/, lalu masuk.
Pilih Semua Sumber Daya, lalu pilih akun Azure Cosmos DB yang Anda buat.
Pilih string Koneksi ion, dan salin nilai untuk bidang Titik Kontak, Port, Nama Pengguna, dan Kata Sandi Utama; Anda akan menggunakan nilai tersebut untuk mengonfigurasi aplikasi Anda nanti.

Konfigurasikan aplikasi contoh

Prosedur berikut ini mengonfigurasi aplikasi pengujian.

Buka shell perintah dan klon proyek sampel menggunakan perintah git seperti contoh berikut:
```
git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
```
Temukan file application.properties di direktori sumber daya proyek sampel, atau buat file jika belum ada.

Buka file application.properties di editor teks, dan tambahkan atau konfigurasikan baris berikut dalam file, dan ganti nilai sampel dengan nilai yang sesuai dari sebelumnya:

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

Mana:

Parameter	Deskripsi
`spring.data.cassandra.contact-points`	Menentukan Titik Kontak dari bagian sebelumnya di artikel ini.
`spring.data.cassandra.port`	Menentukan Port dari bagian sebelumnya di artikel ini.
`spring.data.cassandra.username`	Menentukan Nama Pengguna dari bagian sebelumnya di artikel ini.
`spring.data.cassandra.password`	Menentukan Kata Sandi Utama dari bagian sebelumnya di artikel ini.

Simpan dan tutup file application.properties .

Mengemas dan menguji aplikasi contoh

Telusuri ke direktori yang berisi file pom.xml untuk membangun dan menguji aplikasi.

Bangun aplikasi contoh dengan Maven; sebagai contoh:
```
mvn clean package
```

Mulai aplikasi contoh; sebagai contoh:

java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar

Buat catatan baru menggunakan curl dari perintah seperti contoh berikut:

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

Aplikasi Anda harus mengembalikan nilai seperti contoh berikut:

Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.

Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.

Ambil semua rekaman yang ada menggunakan curl dari perintah seperti contoh berikut:

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

Aplikasi Anda harus mengembalikan nilai seperti contoh berikut:

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

Ringkasan

Dalam tutorial ini, Anda membuat contoh aplikasi Java yang menggunakan Spring Data untuk menyimpan dan mengambil informasi menggunakan Azure Cosmos DB untuk Apache Cassandra.

Membersihkan sumber daya

Bila tidak lagi diperlukan, gunakan portal Azure untuk menghapus sumber daya yang dibuat dalam artikel ini untuk menghindari biaya tak terduga.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang Spring dan Azure, lanjutkan ke pusat dokumentasi Spring di Azure.

Spring di Azure

Lihat juga

Selengkapnya mengenai cara menggunakan Azure dengan Java, lihat Azure untuk Pengembang Java dan Bekerja dengan Azure DevOps dan Java.

Bagikan melalui