全部产品
Search
文档中心

ApsaraDB for MongoDB:Hubungkan ke sebuah instans

更新时间:Nov 10, 2025

Setelah membuat instans ApsaraDB for MongoDB, Anda perlu menghubungkannya menggunakan alat klien.

Prasyarat

Prosedur

DMS

  1. Buka halaman instans set replika ApsaraDB for MongoDB atau halaman instans kluster sharded ApsaraDB for MongoDB. Pilih kelompok sumber daya dan wilayah di bagian atas halaman, lalu klik ID instans target.

  2. Di sudut kanan atas halaman, klik Log On To Database.

    • Untuk instans set replika: Dalam daftar drop-down, pilih Primary. Anda akan dialihkan ke Konsol Data Management (DMS).

      Catatan

      Node sekunder hanya mendukung operasi baca. Untuk menulis data, pilih node primer.

    • Untuk instans kluster sharded: Dalam daftar drop-down, pilih node mana saja. Anda akan dialihkan ke konsol DMS.

    • Untuk instans mandiri: Tidak diperlukan pemilihan. Anda akan dialihkan ke konsol DMS.

  3. Dalam kotak dialog Log On To Instance di konsol DMS, masukkan Database Account dan Database Password. Biarkan pengaturan lainnya pada nilai default.

    Catatan

    Jika Anda lupa kata sandi atau tidak menetapkannya saat membuat instans, buka konsol ApsaraDB for MongoDB untuk menyetel ulang kata sandi.

  4. Klik Test Connection. Dalam kotak dialog sukses, klik OK.

  5. Klik Log On.

Catatan

MongoDB Shell

Instal MongoDB Shell pada perangkat lokal atau Instance ECS

MongoDB menyediakan dua alat antarmuka baris perintah (CLI): MongoDB Shell (mongosh) dan mongo shell. Mongo shell adalah alat klien lama, sedangkan MongoDB Shell adalah alat yang ditingkatkan. Topik ini menggunakan MongoDB Shell sebagai contoh.

  1. Pada klien Anda, unduh MongoDB Shell.

  2. Instal mongosh.

Peroleh alamat koneksi

  1. Buka halaman instans set replika ApsaraDB for MongoDB atau halaman instans kluster sharded ApsaraDB for MongoDB. Pilih kelompok sumber daya dan wilayah di bagian atas halaman, lalu klik ID instans target.

  2. Di panel navigasi di sebelah kiri, klik Database Connections.

  3. Di halaman Koneksi Database, peroleh alamat koneksi yang diperlukan.

    Topik ini menggunakan High-availability Connection String URI di bagian Private Connection - VPC sebagai contoh. Untuk terhubung ke instans melalui internet, Anda harus terlebih dahulu meminta titik akhir publik.

    mongodb://root:****@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****

    Ganti root:**** dengan akun database dan kata sandi Anda. Jika Anda lupa kata sandi atau tidak menetapkannya saat membuat instans, buka konsol ApsaraDB for MongoDB untuk menyetel ulang kata sandi.

Hubungkan ke database

Pada klien, jalankan perintah berikut untuk terhubung ke instans MongoDB.

Catatan

Jika Anda menggunakan mongo shell, ganti mongosh dengan mongo dalam perintah tersebut.

mongosh "<High-availability connection string URI>"

Berikut adalah contoh cara menghubungkan ke instans. Akun database adalah root, kata sandinya adalah PassWord123!, dan database otentikasi adalah admin.

mongosh "mongodb://root:PassWord123%21@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****"

Karakter khusus dalam kata sandi string koneksi harus diloloskan. Sebagai contoh, tanda seru (!) dalam kata sandi contoh harus diloloskan menjadi %21. Untuk informasi lebih lanjut, lihat Bagaimana cara memperbaiki kegagalan koneksi yang disebabkan oleh karakter khusus dalam nama pengguna atau kata sandi dari string koneksi?

Kode program

Langkah selanjutnya

Tulis data

Referensi

Hindari menggunakan akun root untuk menghubungkan ke instans dalam lingkungan produksi. Sebaliknya, buat akun database lain dan berikan izin yang diperlukan. Jika Anda menghubungkan ke instans menggunakan akun yang tidak memiliki izin yang diperlukan, Anda tidak dapat melakukan operasi database apa pun. Pesan kesalahan seperti Exception authenticating... akan dikembalikan.