Topik ini menjelaskan cara menghubungkan ke instans ApsaraDB for MongoDB melalui Internet publik.
Prasyarat
-
Alamat IP publik klien lokal Anda.
-
Anda telah menambahkan alamat IP publik klien lokal Anda ke daftar izin (allowlist) instans.
Langkah 1: Ajukan string koneksi publik
-
Buka halaman Replica Set Instances atau Sharded Cluster Instances. Pada bilah navigasi atas, pilih kelompok sumber daya dan Wilayah yang diinginkan, lalu klik ID instans target.
-
Pada panel navigasi kiri halaman detail instans, klik Database Connections.
-
Pada bagian Public IP Connection, klik Apply for Public IP.
-
Pada kotak dialog Apply for Public IP, klik Confirm.
-
Tunggu hingga status instans berubah dari Establishing Network Connection menjadi Running. Setelah itu, Anda dapat melihat string koneksi publik instans tersebut.
Catatan-
Instans tetap berjalan normal selama statusnya Establishing Network Connection.
-
String koneksi hanya terlihat setelah Anda mengonfigurasi allowlist.
-
Gunakan ConnectionStringURI untuk koneksi berdaya tahan tinggi (high-availability).
-
Langkah 2: Hubungkan ke instans
Contoh ini menggunakan MongoDB Shell (mongosh) untuk menghubungkan ke instans.
ConnectionStringURI (Direkomendasikan)
Perintah:
mongo "<ConnectionStringURI>"
Parameter:
|
Parameter |
Deskripsi |
|
|
ConnectionStringURI untuk instans Anda, tersedia di Konsol ApsaraDB for MongoDB. Catatan
Sebagai praktik keamanan terbaik, jangan menghubungkan ke database menggunakan akun root. Buat akun database di Data Management (DMS) sebelum melakukan koneksi. Saat menghubungkan, ganti |
Contoh:
mongo "mongodb://test:PassWord**@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/testdb?replicaSet=mgset-6108****"
String koneksi single-node
Perintah:
mongo --host <host> --port <port> -u <username> -p --authenticationDatabase <authenticationDatabase>
Parameter:
|
Parameter |
Deskripsi |
|
|
Connection Address dan Port node, tersedia di Konsol ApsaraDB for MongoDB. Contoh: |
|
|
Nama akun database. Catatan
Sebagai praktik keamanan terbaik, jangan gunakan akun root untuk menghubungkan ke database. Buat akun database di Data Management (DMS) sebelum melakukan koneksi. |
|
|
Database yang digunakan untuk mengotentikasi akun database yang ditentukan. Penting
Agar otentikasi berhasil, akun database harus diautentikasi terhadap database tempat akun tersebut dibuat. |
Contoh:
Contoh berikut mengasumsikan akun database adalah test dan database otentikasinya adalah testdb.
mongo --host dds-bp19f409d7512****.mongodb.rds.aliyuncs.com --port 3717 -u test -p --authenticationDatabase testdb
Pada prompt Enter password:, masukkan password akun database lalu tekan Enter.