Cara menggunakan Spring Data dengan Azure Cosmos DB untuk Apache Cassandra

Artikel ini memperlihatkan cara menggunakan Spring Data dengan Azure Cosmos DB untuk Apache Cassandra untuk membuat sampel aplikasi Java yang menyimpan dan mengambil data.

Prasyarat

• Langganan Azure - buat langganan 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 Microsoft Azure.

Membuat akun Azure Cosmos DB dengan menggunakan portal Azure

Nota

Untuk informasi selengkapnya tentang membuat akun, lihat dokumentasi Azure Cosmos DB.

1. Telusuri ke portal Microsoft Azure di https://portal.azure.com/ dan masuk.

2. Pilih Buat sumber daya, pilih Mulai, lalu pilih Azure Cosmos DB.

3. Pada layar opsi Pilih API , pilih Cassandra.

   

4. Tentukan informasi berikut:

   • Langganan: Tentukan langganan Azure Anda yang akan digunakan.
   • Grup sumber daya: Tentukan apakah akan membuat grup sumber daya baru atau memilih grup sumber daya yang sudah ada.
   • Nama akun: Pilih nama unik untuk akun Azure Cosmos DB Anda. Nama ini 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.

   

5. Saat Anda memasukkan semua informasi sebelumnya, pilih Tinjau + buat.

6. Jika semuanya terlihat benar di halaman tinjauan, pilih Buat.

Dibutuhkan beberapa menit untuk menyebarkan database.

Menambahkan keyspace ke akun Azure Cosmos DB Anda

1. Telusuri ke portal Microsoft Azure di https://portal.azure.com/ dan masuk.

2. Pilih Semua Sumber Daya, lalu pilih akun Azure Cosmos DB yang Anda buat.

3. 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 Anda

1. Telusuri ke portal Microsoft Azure di https://portal.azure.com/ dan masuk.

2. Pilih Semua Sumber Daya, lalu pilih akun Azure Cosmos DB yang Anda buat.

3. Pilih String koneksi, dan salin nilai untuk bidang Titik Kontak, Port, Nama Pengguna, dan Kata Sandi Utama . Anda menggunakan nilai-nilai tersebut untuk mengonfigurasi aplikasi Anda nanti.

   

Mengonfigurasi aplikasi sampel

Prosedur berikut mengonfigurasi aplikasi pengujian.

1. Buka shell perintah dan kloning proyek sampel menggunakan perintah git seperti contoh berikut:

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

2. Temukan file application.properties di sumber daya direktori proyek sampel, atau buat file jika belum ada.

3. 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=********
   

   Lokasi:

   Pengaturan	Deskripsi
   spring.data.cassandra.contact-points	Menentukan Titik Kontak dari yang disebutkan sebelumnya dalam artikel ini.
   spring.data.cassandra.port	Menentukan Port seperti disebutkan sebelumnya dalam artikel ini.
   spring.data.cassandra.username	Menentukan Nama Pengguna Anda seperti yang disebutkan sebelumnya dalam artikel ini.
   spring.data.cassandra.password	Tentukan Kata Sandi Utama Anda yang disebutkan sebelumnya dalam artikel ini.

4. Simpan dan tutup file application.properties .

Mengemas dan menguji aplikasi sampel

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

1. Bangun aplikasi sampel dengan Maven; misalnya:

   mvn clean package
   

2. Mulai aplikasi sampel; misalnya:

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

3. Buat rekaman baru dengan menggunakan curl dari prompt perintah. Contoh berikut menunjukkan cara membuat rekaman:

   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'}.
   

4. Ambil semua rekaman yang ada dengan menggunakan curl dari prompt perintah. Contoh berikut menunjukkan cara mengambil rekaman:

   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 sampel aplikasi Java yang menggunakan Spring Data untuk menyimpan dan mengambil informasi dengan menggunakan Azure Cosmos DB untuk Apache Cassandra.

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan sumber daya, gunakan portal Azure untuk menghapusnya. Menghapus sumber daya membantu Anda menghindari biaya tak terduga.

Langkah berikutnya

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

Spring pada Azure

Lihat juga

Untuk informasi selengkapnya tentang menggunakan Azure dengan Java, lihat Azure for Java Developers dan Bekerja dengan Azure DevOps dan Java.