Mulai cepat: Membuat aplikasi konsol dengan Java dan Azure Cosmos DB untuk MongoDB

BERLAKU UNTUK: MongoDB

• .NET
• Python
• Java
• Node.js
• Go

Dalam mulai cepat ini, Anda membuat dan mengelola akun Azure Cosmos DB for MongoDB dari portal Azure, dan menambahkan data dengan menggunakan aplikasi Java SDK yang dikloning dari GitHub. Azure Cosmos DB adalah layanan database multi-model yang memungkinkan Anda membuat dan kueri dokumen, tabel, nilai-kunci, dan database grafik dengan kemampuan distribusi global dan skala horizontal dengan cepat.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun gratis. Atau coba Azure Cosmos DB secara gratis tanpa langganan Azure. Anda juga dapat menggunakan Azure Cosmos DB Emulator dengan string koneksi .mongodb://localhost:C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==@localhost:10255/admin?ssl=true.
• Java Development Kit versi 8.
• Maven. Atau jalankan apt-get install maven untuk menginstal Maven.
• Git.

Buat akun database

1. Buka jendela browser baru dan masuk ke portal Microsoft Azure.

2. Di panel kiri, pilih Buat sumber daya.

   

3. Di halaman Baru, pilih Database>Azure Cosmos DB.

   

4. Pada halaman Pilih opsi API, pilih Azure Cosmos DB untuk Buat MongoDB>.

   API akan menentukan jenis akun yang akan dibuat. Pilih Azure Cosmos DB untuk MongoDB karena Anda akan membuat koleksi yang berfungsi dengan MongoDB dalam mulai cepat ini. Untuk mempelajari selengkapnya, lihat Gambaran Umum Azure Cosmos DB untuk MongoDB.

   

5. Di halaman Buat Akun Azure Cosmos DB, masukkan pengaturan untuk akun Azure Cosmos DB baru Anda.

   Pengaturan	Nilai	Deskripsi
   Langganan	Nama langganan	Pilih langganan Azure yang ingin Anda gunakan untuk akun Azure Cosmos DB ini.
   Grup Sumber Daya	Nama grup sumber daya	Pilih grup sumber daya, atau pilih Buat baru, lalu masukkan nama unik untuk grup sumber daya baru.
   Nama Akun	Masukkan nama yang unik	Masukkan nama unik untuk mengidentifikasi akun Azure Cosmos DB Anda. URI akun Anda mongo.cosmos.azure.com akan dilampirkan ke nama akun unik Anda. Nama akun hanya dapat menggunakan huruf kecil, angka, dan tanda hubung (-), dan panjangnya harus antara 3 dan 44 karakter.
   Lokasi	Wilayah yang paling dekat dengan pengguna Anda	Pilih lokasi geografis untuk menghosting akun Azure Cosmos DB Anda. Gunakan lokasi yang paling dekat dengan pengguna Anda untuk memberi mereka akses tercepat ke data.
   Mode kapasitas	Throughput yang disediakan atau Tanpa server	Pilih Throughput yang Tersedia untuk membuat akun dalam mode throughput yang tersedia. Pilih Tanpa server untuk membuat akun dalam mode tanpa server. Catatan: Hanya API untuk MongoDB versi 4.2, 4.0, dan 3.6 yang didukung oleh akun tanpa server. Memilih 3.2 sebagai versi akan memaksa akun dalam mode throughput yang diprovisi.
   Terapkan diskon tingkat gratis Azure Cosmos DB	Terapkan atau Jangan terapkan	Dengan tingkat gratis Azure Cosmos DB, Anda akan mendapatkan 1000 RU/dtk pertama dan penyimpanan 25 GB secara gratis pada akun. Pelajari lebih lanjut tentang tingkat gratis.
   Versi	Pilih versi server yang diperlukan	Azure Cosmos DB for MongoDB kompatibel dengan server versi 4.2, 4.0, 3.6, dan 3.2. Anda meningkatkan atau menurunkan akun setelah dibuat.

   Catatan

   Anda dapat memiliki hingga satu akun Azure Cosmos DB tingkat gratis per langganan Azure dan harus ikut serta saat membuat akun. Jika Anda tidak melihat opsi untuk menerapkan diskon tingkat gratis, ini berarti akun lain dalam langganan telah diaktifkan dengan tingkat gratis.

   

6. Pada tab Distribusi Global, konfigurasikan detail berikut. Anda dapat membiarkan nilai default untuk tujuan quickstart ini:

   Pengaturan	Nilai	Deskripsi
   Redundansi Geografis	Nonaktifkan	Aktifkan atau nonaktifkan distribusi global di akun Anda dengan memasangkan wilayah Anda dengan wilayah pasangan. Anda dapat menambahkan lebih banyak wilayah ke akun Anda nanti.
   Tulisan Multiwilayah	Nonaktifkan	Kemampuan tulisan multiwilayah memungkinkan Anda untuk mengambil keuntungan dari throughput terprovisi untuk database dan kontainer Anda di seluruh dunia.

   Catatan

   Opsi berikut ini tidak tersedia jika Anda memilih Tanpa Server sebagai mode Kapasitas:

   • Terapkan Diskon Tingkat Gratis
   • Redundansi geografis
   • Tulisan Multiwilayah

7. Secara opsional, Anda dapat mengonfigurasi detail tambahan di tab berikut:

   • Jaringan - Konfigurasikan akses dari jaringan virtual.
   • Kebijakan Pencadangan - Konfigurasikan kebijakan pencadangan berkala atau berkelanjutan.
   • Enkripsi - Gunakan kunci yang dikelola layanan atau kunci yang dikelola pelanggan.
   • Tag - Tag adalah pasangan nama/nilai yang memungkinkan Anda mengategorikan sumber daya dan melihat tagihan gabungan dengan menerapkan tag yang sama ke beberapa sumber daya dan grup sumber daya.

8. Pilih Tinjau + buat.

9. Pembuatan akun memakan waktu beberapa menit. Tunggu hingga portal menampilkan Selamat! Akun Azure Cosmos DB for MongoDB Anda sudah siap .

   

Menambahkan koleksi

Beri nama database baru Anda db, dan koleksi baru Anda coll.

Sekarang Anda dapat menggunakan alat Data Explorer di portal Azure untuk membuat API Azure Cosmos DB untuk database dan kontainer MongoDB.

1. Pilih Data Explorer>Kontainer Baru.

   Area Tambahkan Kontainer ditampilkan di ujung kanan, Anda mungkin perlu menggulir ke kanan untuk melihatnya.

   

2. Di halaman Tambahkan kontainer, masukkan pengaturan untuk kontainer baru.

   Pengaturan	Nilai yang disarankan	Deskripsi
   ID Database	db	Masukkan db sebagai nama untuk database baru. Nama database harus berisi 1 hingga 255 karakter, dan tidak boleh berisi /, \\, #, ?, atau spasi di belakang. Centang opsi Provisikan throughput database, ini memungkinkan Anda berbagi throughput yang diprovisikan ke database di semua kontainer dalam database. Opsi ini juga membantu penghematan biaya.
   Throughput	400	Biarkan throughput pada unit permintaan 400 per detik (RU/dtk). Jika Anda ingin mengurangi latensi, Anda dapat meningkatkan throughput nanti. Anda juga dapat memilih Mode penskalaan otomatis, yang akan memberi Anda rentang RU/dtk yang akan meningkat dan berkurang secara dinamis sesuai kebutuhan.
   ID Koleksi	coll	Masukkan coll sebagai nama untuk kontainer baru Anda. ID kontainer memiliki persyaratan karakter yang sama dengan nama database.
   Kapasitas penyimpanan	Tetap (10 GB)	Masukkan Tetap (10 GB) untuk aplikasi ini. Jika Anda memilih Tidak Terbatas, Anda harus membuat Shard Key, yang akan dibutuhkan oleh semua item yang dimasukkan.
   Kunci pecahan	/_id	Sampel yang dijelaskan dalam artikel ini tidak menggunakan Kunci Shard, jadi mengaturnya ke /_id akan menggunakan bidang ID yang dibuat secara otomatis sebagai kunci shard. Pelajari lebih lanjut tentang sharding, juga dikenal sebagai partisi, dalam Partisi di Azure Cosmos DB

   Pilih OK. Data Explorer akan menampilkan database dan kontainer baru.

Buat klon sampel aplikasi

Sekarang mari kita kloning aplikasi dari GitHub, set string koneksi, dan menjalankannya. Anda akan melihat betapa mudahnya bekerja dengan data secara terprogram.

1. Buka prompt perintah, buat folder baru bernama git-samples, lalu tutup prompt perintah.

   md "C:\git-samples"
   

2. Buka jendela terminal git, seperti git bash, dan gunakan perintah cd untuk mengubah ke folder baru untuk memasang aplikasi sampel.

   cd "C:\git-samples"
   

3. Jalankan perintah berikut untuk mengkloning repositori sampel. Perintah ini membuat salinan aplikasi sampel di komputer Anda.

   git clone https://github.com/Azure-Samples/azure-cosmos-db-mongodb-java-getting-started.git
   

4. Kemudian buka kode di editor favorit Anda.

Mengulas kode

Langkah ini bersifat opsional. Jika Anda tertarik mempelajari bagaimana sumber daya database Azure Cosmos dibuat dalam kode, Anda dapat memberi ulasan cuplikan berikut. Jika tidak, Anda dapat melompatinya untuk Memperbarui string koneksi Anda.

Cuplikan berikut semuanya diambil dari file Program.java.

Aplikasi konsol ini menggunakan driver MongoDB Java.

• DokumenClient diinisialisasi.

  MongoClientURI uri = new MongoClientURI("FILLME");`
  
  MongoClient mongoClient = new MongoClient(uri);            
  

• Database dan koleksi baru dibuat.

  MongoDatabase database = mongoClient.getDatabase("db");
  
  MongoCollection<Document> collection = database.getCollection("coll");
  

• Beberapa dokumen disisipkan menggunakan MongoCollection.insertOne

  Document document = new Document("fruit", "apple")
  collection.insertOne(document);
  

• Beberapa kueri dilakukan menggunakan MongoCollection.find

  Document queryResult = collection.find(Filters.eq("fruit", "apple")).first();
  System.out.println(queryResult.toJson());    	
  

Memperbarui string koneksi Anda

Sekarang kembali ke portal Microsoft Azure untuk mendapatkan informasi string koneksi Anda dan menyalinnya ke dalam aplikasi.

1. Dari akun Azure Cosmos DB Anda, pilih Mulai Cepat, pilih Java, lalu salin string koneksi ke clipboard Anda.

2. Buka file Program.java, ganti argumen ke konstruktor MongoClientURI dengan string koneksi. Anda sekarang telah memperbarui aplikasi Anda dengan semua info yang diperlukan untuk berkomunikasi dengan Microsoft Azure Cosmos DB.

Menjalankan aplikasi konsol

1. Jalankan mvn package di terminal untuk menginstal paket yang diperlukan

2. Jalankan mvn exec:java -D exec.mainClass=GetStarted.Program di terminal untuk memulai aplikasi Java Anda.

Kini Anda dapat menggunakan Robomongo / Studio 3T untuk membuat kueri, memodifikasi, dan bekerja sama dengan data baru ini.

Mengulas SLA di portal Microsoft Azure

portal Azure memantau throughput, penyimpanan, ketersediaan, latensi, dan konsistensi akun Azure Cosmos DB Anda. Bagan untuk metrik yang terkait dengan Service Level Agreement (SLA) Azure Cosmos DB menunjukkan nilai SLA dibandingkan dengan performa aktual. Rangkaian metrik ini membuat pemantauan SLA Anda transparan.

Untuk meninjau metrik dan SLA:

1. Pilih Metrik di menu navigasi akun Azure Cosmos DB Anda.

2. Pilih tab seperti Latensi, dan pilih jangka waktu di sebelah kanan. Bandingkan garis Aktual dan SLA pada bagan.

   

3. Tinjau metrik pada tab lain.

Membersihkan sumber daya

Setelah selesai dengan aplikasi dan akun Azure Cosmos DB, Anda dapat menghapus sumber daya Azure yang dibuat sehingga tidak dikenakan lebih banyak biaya. Untuk menghapus sumber daya:

1. Di portal Azure, cari dan pilih Grup sumber daya.

2. Dari daftar, pilih grup sumber daya yang Anda buat untuk panduan mulai cepat ini.

   

3. Di panel Gambaran umum grup sumber daya, pilih Hapus grup sumber daya.

   

4. Di jendela berikutnya, masukkan nama grup sumber daya yang akan dihapus, lalu pilih Hapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda mempelajari cara membuat akun Azure Cosmos DB for MongoDB, menambahkan database dan kontainer menggunakan Data Explorer, dan menambahkan data menggunakan aplikasi konsol Java. Sekarang Anda dapat mengimpor data tambahan ke database Azure Cosmos DB Anda.

Mencoba melakukan perencanaan kapasitas untuk migrasi ke Azure Cosmos DB? Anda dapat menggunakan informasi tentang kluster database Anda yang ada saat ini untuk membuat perencanaan kapasitas.

• Jika Anda hanya mengetahui jumlah vcore dan server di kluster database yang ada, baca tentang memperkirakan unit permintaan menggunakan vCore atau vCPU
• Jika Anda mengetahui rasio permintaan umum untuk beban kerja database Anda saat ini, baca memperkirakan unit permintaan menggunakan perencana kapasitas Azure Cosmos DB

Mengimpor data MongoDB ke dalam Azure Cosmos DB