Mulai cepat: Menggunakan Azure DocumentDB dengan driver MongoDB untuk Java

Dalam panduan memulai cepat ini, Anda membuat aplikasi Azure DocumentDB sederhana menggunakan Java. Azure DocumentDB adalah penyimpanan data NoSQL yang memungkinkan aplikasi menyimpan dokumen di cloud dan mengaksesnya menggunakan driver MongoDB resmi. Panduan ini memperlihatkan cara membuat dokumen dan melakukan tugas dasar di kluster Azure DocumentDB Anda menggunakan Java.

Referensi | APIKode sumber | Paket (Maven)

Prasyarat

Langganan Azure
- Jika Anda tidak memiliki langganan Azure, buat akun gratis

Java 21 atau yang lebih baru

Membuat kluster Azure DocumentDB

Untuk memulai, Pertama-tama Anda perlu membuat kluster Azure DocumentDB, yang berfungsi sebagai fondasi untuk menyimpan dan mengelola data NoSQL Anda.

Masuk ke portal Microsoft Azure (https://portal.azure.com).
Pada menu portal Microsoft Azure atau halaman Beranda, pilih Buat sumber daya.
Pada halaman Baru , cari dan pilih Azure DocumentDB.
Pada halaman Buat kluster Azure DocumentDB dan di dalam bagian Dasar , pilih opsi Konfigurasi di dalam bagian Tingkat kluster .
Pada halaman Skala , konfigurasikan opsi ini lalu pilih Simpan untuk mempertahankan perubahan Anda ke tingkat kluster.

Nilai

Tingkat kluster M30 tier, 2 vCore, 8-GiB RAM

Penyimpanan per pecahan 128 GiB

	Nilai
Tingkat kluster	`M30 tier, 2 vCore, 8-GiB RAM`
Penyimpanan per pecahan	`128 GiB`

Kembali ke bagian Dasar , konfigurasikan opsi berikut:

	Nilai
Subscription	Pilih langganan Azure Anda
grup Sumber Daya	Membuat grup sumber daya baru atau memilih grup sumber daya yang sudah ada
Nama kluster	Berikan nama yang unik secara global
Tempat	Pilih wilayah Azure yang didukung untuk langganan Anda
Versi MongoDB	Pilih `8.0`
Nama pengguna admin	Membuat nama pengguna untuk mengakses kluster sebagai administrator pengguna
Password	Menggunakan kata sandi unik yang terkait dengan nama pengguna

Cuplikan layar memperlihatkan parameter kluster.

Petunjuk / Saran

Catat nilai yang Anda gunakan untuk nama pengguna dan kata sandi. Nilai-nilai ini digunakan nanti dalam panduan ini. Untuk informasi selengkapnya tentang nilai yang valid, lihat batasan kluster.

Pilih Berikutnya: Jaringan.
Di bagian Aturan firewall pada tab Jaringan, konfigurasikan opsi ini:

Nilai

Metode konektivitas Public access

Izinkan akses publik dari layanan dan sumber daya Azure dalam Azure ke kluster ini Enabled
Tambahkan aturan firewall untuk perangkat klien Anda saat ini untuk memberikan akses ke kluster dengan memilih + Tambahkan alamat IP klien saat ini.

Petunjuk / Saran

Di banyak lingkungan perusahaan, alamat IP komputer pengembang disembunyikan karena VPN atau pengaturan jaringan perusahaan lainnya. Dalam kasus ini, Anda dapat mengizinkan akses untuk sementara ke semua alamat IP dengan menambahkan 0.0.0.0 - 255.255.255.255 rentang alamat IP sebagai aturan firewall. Gunakan aturan firewall ini hanya sementara sebagai bagian dari pengujian dan pengembangan koneksi.
Pilih Tinjau + kreasikan.
Tinjau pengaturan yang Anda berikan, kemudian pilih Buat. Perlu waktu beberapa menit untuk membuat kluster tersebut. Tunggu penyebaran sumber daya selesai.
Terakhir, pilih Buka sumber daya untuk menavigasi ke kluster Azure DocumentDB di portal.

	Nilai
Metode konektivitas	`Public access`
Izinkan akses publik dari layanan dan sumber daya Azure dalam Azure ke kluster ini	Enabled

Cuplikan layar memperlihatkan opsi sumber daya goto.

Mendapatkan kredensi kluster

Dapatkan kredensial yang Anda gunakan untuk menyambungkan ke kluster.

Pada halaman kluster, pilih opsi String koneksi di menu sumber daya.
Di bagian String koneksi , salin atau rekam nilai dari bidang String koneksi .

Cuplikan layar memperlihatkan opsi string koneksi.

Penting

String koneksi di portal tidak menyertakan nilai kata sandi. Anda harus mengganti <password> tempat penampung dengan kredensial yang Anda masukkan saat membuat kluster atau memasukkan kata sandi secara interaktif.

Menginisialisasi proyek

Buat proyek Maven baru di direktori Anda saat ini.

Mulai di direktori kosong.
Buka terminal di direktori saat ini.

Buat proyek Maven baru menggunakan arketipe mulai cepat.

mvn archetype:generate -DgroupId=com.example -DartifactId=azure-documentdb-java-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

Navigasikan ke direktori proyek yang dihasilkan.
```
cd azure-documentdb-java-quickstart
```
Bangun proyek untuk memastikan proyek berhasil dibuat.
```
mvn compile
```

Memasang pustaka klien

Perpustakaan klien tersedia melalui Maven, sebagai mongodb-driver-sync artifak.

Tambahkan dependensi driver MongoDB Java ke file Anda pom.xml .

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>5.2.0</version>
</dependency>

Buka dan tinjau file pom.xml untuk memvalidasi bahwa entri dependensi ada.

Impor paket yang diperlukan ke dalam kode aplikasi Anda:

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.ReplaceOptions;
import org.bson.Document;
import org.bson.conversions.Bson;

import java.util.Arrays;
import java.util.List;

Model objek

Nama	Description
`MongoClient`	Jenis yang digunakan untuk menyambungkan ke MongoDB.
`MongoDatabase`	Mewakili database dalam kluster.
`MongoCollection<Document>`	Mewakili koleksi dalam database dalam kluster.

Kode dalam aplikasi ini tersambung ke database bernama adventureworks dan koleksi bernama products. Koleksi products berisi detail seperti nama, kategori, kuantitas, pengidentifikasi unik, dan bendera penjualan untuk setiap produk. Contoh kode di sini melakukan operasi yang paling umum saat bekerja dengan kumpulan.

Mengautentikasi klien

Pertama, sambungkan ke klien menggunakan string koneksi dasar.

Buat metode utama dan siapkan string koneksi. Ganti <your-cluster-name>, <your-username>, dan <your-password> dengan informasi kluster Anda yang sebenarnya.

public class App {
    public static void main(String[] args) {
        // Connection string for Azure DocumentDB cluster
        String connectionString = "mongodb+srv://<your-username>:<your-password>@<your-cluster-name>.global.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000";

Buat klien MongoDB dan verifikasi koneksi.

        // Create a new client and connect to the server
        try (MongoClient mongoClient = MongoClients.create(connectionString)) {

            // Ping the server to verify connection
            MongoDatabase database = mongoClient.getDatabase("admin");
            database.runCommand(new Document("ping", 1));

            System.out.println("Successfully connected and pinged Azure DocumentDB");

Dapatkan koleksi

Sekarang, dapatkan database dan koleksi Anda. Jika database dan koleksi belum ada, gunakan driver untuk membuatnya secara otomatis.

Dapatkan referensi ke database.

            // Get database reference
            MongoDatabase adventureWorksDatabase = mongoClient.getDatabase("adventureworks");
            System.out.println("Connected to database: " + adventureWorksDatabase.getName());

Dapatkan referensi ke koleksi dalam database.

            // Get collection reference
            MongoCollection<Document> productsCollection = adventureWorksDatabase.getCollection("products");
            System.out.println("Connected to collection: products");

Buat dokumen

Kemudian, buat beberapa dokumen baru dalam koleksi Anda. Melakukan operasi upsert pada dokumen untuk memastikan bahwa dokumen tersebut mengganti dokumen yang ada jika dokumen dengan pengidentifikasi unik yang sama sudah ada.

Buat contoh dokumen produk menggunakan kelas Dokumen.

            // Create sample products
            List<Document> products = Arrays.asList(
                new Document("_id", "00000000-0000-0000-0000-000000004018")
                    .append("name", "Windry Mittens")
                    .append("category", "apparel-accessories-gloves-and-mittens")
                    .append("quantity", 121)
                    .append("price", 35.00)
                    .append("sale", false),
                new Document("_id", "00000000-0000-0000-0000-000000004318")
                    .append("name", "Niborio Tent")
                    .append("category", "gear-camp-tents")
                    .append("quantity", 140)
                    .append("price", 420.00)
                    .append("sale", true)
            );

Sisipkan dokumen menggunakan operasi upsert.

            // Insert documents with upsert
            for (Document product : products) {
                Bson filter = Filters.eq("_id", product.getString("_id"));
                ReplaceOptions options = new ReplaceOptions().upsert(true);

                productsCollection.replaceOne(filter, product, options);
                System.out.println("Upserted product: " + product.getString("name"));
            }

Mengambil dokumen

Selanjutnya, lakukan operasi pembacaan titik data untuk mengambil sebuah dokumen tertentu dari koleksi Anda.

Tentukan filter untuk menemukan dokumen tertentu menurut ID.

            // Retrieve a specific document by ID
            Bson filter = Filters.eq("_id", "00000000-0000-0000-0000-000000004018");

Jalankan kueri dan ambil hasilnya.

            Document retrievedProduct = productsCollection.find(filter).first();

            if (retrievedProduct != null) {
                System.out.println("Retrieved product: " + retrievedProduct.getString("name") + 
                                 " - $" + retrievedProduct.getDouble("price"));
            } else {
                System.out.println("Product not found");
            }

Melakukan kueri pada dokumen

Terakhir, kueri beberapa dokumen menggunakan MongoDB Query Language (MQL).

Tentukan kueri untuk menemukan dokumen yang cocok dengan kriteria tertentu.

            // Query for products on sale
            Bson saleFilter = Filters.eq("sale", true);

Lakukan perulangan melalui kursor guna mengambil semua dokumen yang cocok.

            System.out.println("Products on sale:");
            for (Document product : productsCollection.find(saleFilter)) {
                System.out.printf("- %s: $%.2f (Category: %s)%n",
                    product.getString("name"),
                    product.getDouble("price"),
                    product.getString("category"));
            }

        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Menjelajahi data Anda menggunakan Visual Studio Code

Gunakan ekstensi DocumentDB di Visual Studio Code untuk melakukan operasi database inti, termasuk mengkueri, menyisipkan, memperbarui, dan menghapus data.

Buka Visual Studio Code.
Navigasi ke tampilan Ekstensi dan cari istilah DocumentDB. Temukan ekstensi DocumentDB untuk Visual Studio Code .
Pilih tombol Instal untuk ekstensi. Tunggu hingga penginstalan selesai. Muat ulang Visual Studio Code jika diminta.
Navigasikan ke ekstensi DocumentDB dengan memilih ikon terkait di Bilah Aktivitas.
Di panel Koneksi DocumentDB , pilih + Koneksi Baru....
Dalam dialog, pilih Penemuan Layanan lalu Azure DocumentDB - Azure Service Discovery.
Pilih langganan Azure Anda dan kluster Azure DocumentDB yang baru dibuat.

Petunjuk / Saran

Di banyak lingkungan perusahaan, alamat IP komputer pengembang disembunyikan karena VPN atau pengaturan jaringan perusahaan lainnya. Dalam kasus ini, Anda dapat mengizinkan akses untuk sementara ke semua alamat IP dengan menambahkan 0.0.0.0 - 255.255.255.255 rentang alamat IP sebagai aturan firewall. Gunakan aturan firewall ini hanya sementara sebagai bagian dari pengujian dan pengembangan koneksi. Untuk informasi selengkapnya, lihat mengonfigurasi firewall.
Kembali ke panel Koneksi DocumentDB , perluas simpul untuk kluster Anda dan navigasikan ke dokumen dan simpul koleksi yang sudah ada.
Buka menu konteks untuk koleksi lalu pilih DocumentDB Scrapbook > New DocumentDB Scrapbook.
Masukkan perintah MongoDB Query Language (MQL) berikut lalu pilih Jalankan Semua. Perhatikan hasil keluaran dari perintah.
```
db.products.find({
  price: { $gt: 200 },
  sale: true
})
.sort({ price: -1 })
.limit(3)
```

Membersihkan sumber daya

Setelah selesai dengan kluster Azure DocumentDB, Anda dapat menghapus sumber daya Azure yang Anda buat sehingga Anda tidak dikenakan lebih banyak biaya.

Di bilah pencarian portal Azure, cari dan pilih Grup sumber daya.
Dalam daftar, pilih grup sumber daya yang Anda gunakan untuk panduan memulai cepat ini.
Pada halaman grup sumber daya, pilih Hapus grup sumber daya.
Dalam dialog konfirmasi penghapusan, masukkan nama grup sumber daya untuk mengonfirmasi bahwa Anda ingin menghapusnya. Terakhir, pilih Hapus untuk menghapus grup sumber daya secara permanen.

Apa itu Azure DocumentDB?

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-19