Mulai cepat: Membuat kluster Azure DocumentDB dengan menggunakan portal Microsoft Azure

Dalam mulai cepat ini, Anda membuat kluster Azure DocumentDB baru. Kluster ini berisi semua sumber daya MongoDB khas Anda: database, koleksi, dan dokumen. Kluster ini menyediakan titik akhir unik untuk berbagai alat dan driver untuk terhubung ke Azure DocumentDB dan melakukan operasi sehari-hari.

Prerequisites

  • Langganan Azure

    • Jika Anda tidak memiliki langganan Azure, buat akun gratis

Membuat kluster

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

  1. Masuk ke portal Microsoft Azure (https://portal.azure.com).

  2. Pada menu portal Microsoft Azure atau halaman Beranda, pilih Buat sumber daya.

  3. Pada halaman Baru, cari dan pilih Azure DocumentDB.

    Cuplikan layar memperlihatkan pencarian Azure DocumentDB.

  4. Pada halaman Buat kluster Azure DocumentDB dan di dalam bagian Dasar , pilih opsi Konfigurasi di dalam bagian Tingkat kluster .

    Cuplikan layar memperlihatkan opsi Konfigurasikan kluster.

  5. Pada halaman Skala , konfigurasikan opsi ini lalu pilih Simpan untuk mempertahankan perubahan Anda ke tingkat kluster.

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

    Cuplikan layar opsi konfigurasi untuk komputasi dan penyimpanan untuk kluster Azure DocumentDB baru.

  6. Kembali ke bagian Dasar , konfigurasikan opsi berikut:

    Value
    Abonemen 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.

    Tip

    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.

  7. Pilih Berikutnya: Jaringan.

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

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

    Cuplikan layar memperlihatkan konfigurasi jaringan.

    Tip

    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.

  10. Pilih Tinjau + kreasikan.

  11. Tinjau pengaturan yang Anda berikan, kemudian pilih Buat. Perlu waktu beberapa menit untuk membuat kluster tersebut. Tunggu penyebaran sumber daya selesai.

  12. Terakhir, pilih Buka sumber daya untuk menavigasi ke kluster Azure DocumentDB di portal.

Cuplikan layar memperlihatkan opsi sumber daya goto.

Mendapatkan kredensi kluster

Dapatkan kredensial yang Anda gunakan untuk menyambungkan ke kluster.

  1. Pada halaman kluster, pilih opsi String koneksi di menu sumber daya.

  2. Di bagian String koneksi , salin atau rekam nilai dari bidang String koneksi .

Cuplikan layar memperlihatkan opsi string koneksi.

Important

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.

Menyambungkan menggunakan MongoDB Shell dari Mulai Cepat

Untuk menyambungkan langsung ke Azure DocumentDB menggunakan MongoDB Shell, gunakan pengalaman Mulai Cepat yang tersedia di halaman sumber daya di portal Microsoft Azure.

  1. Di halaman sumber daya kluster, pilih Mulai cepat (pratinjau) dari menu navigasi.

  2. Lalu, pilih Buka shell MongoDB.

  3. Tunggu hingga lingkungan MongoDB Shell dimulai.

  4. Setelah lingkungan siap, masukkan Y untuk menerima pemberitahuan.

    Nota

    Jika Anda mengalami masalah saat menyambungkan menggunakan MongoDB Shell setelah menerima pemberitahuan, pastikan Azure Cloud Shell memiliki akses ke kluster Anda.

  5. Sekarang, masukkan kata sandi Anda untuk menyambungkan kluster Anda ke Cloud Shell.

Melakukan kueri pengujian

Verifikasi bahwa Anda berhasil tersambung ke kluster dengan melakukan serangkaian perintah dan kueri pengujian.

  1. Periksa status koneksi Anda dengan menjalankan connectionStatus perintah .

    db.runCommand({connectionStatus: 1})
    
    {
      ...
      ok: 1
    }
    
  2. Cantumkan database di kluster Anda.

    show dbs
    
  3. Beralih ke database tertentu. "Gantikan tempat penampung <database-name> dengan nama database apa pun di kluster Anda."

    use <database-name>
    

    Tip

    Misalnya, jika nama database adalah inventory, maka perintahnya adalah use inventory.

  4. Mencantumkan koleksi dalam database.

    show collections
    
  5. Temukan lima item pertama dalam koleksi tertentu. Ganti placeholder <collection-name> dengan nama koleksi apa pun di kluster Anda.

    db.<collection-name>.find().limit(5)
    

    Tip

    Misalnya, jika nama koleksi adalah equipment, maka perintahnya adalah db.equipment.find().limit(5).

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.

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

    Cuplikan layar memperlihatkan opsi untuk mencari grup sumber daya.

  2. Dalam daftar, pilih grup sumber daya yang Anda gunakan untuk panduan memulai cepat ini.

    Cuplikan layar memperlihatkan grup sumber daya.

  3. Pada halaman grup sumber daya, pilih Hapus grup sumber daya.

  4. 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.

    Cuplikan layar memperlihatkan tombol konfirmasi hapus grup sumber daya.