Panduan Lengkap Setup Database MongoDB
MongoDB adalah salah satu database NoSQL berbasis dokumen yang paling populer digunakan oleh developer saat ini. Berbeda dengan database relasional (SQL) yang menggunakan tabel dan baris, MongoDB menyimpan data dalam format BSON (Binary JSON) yang fleksibel.
Panduan ini akan membahas dua cara utama untuk setup MongoDB: secara Lokal (Self-Hosted) dan menggunakan layanan Cloud (MongoDB Atlas)
Metode 1: Setup MongoDB Cloud via MongoDB Atlas (Sangat Direkomendasikan)
MongoDB Atlas adalah layanan database cloud resmi dari MongoDB. Cara ini sangat cocok untuk tahap produksi (production) karena Anda tidak perlu memikirkan urusan maintenance server.
Langkah 1: Registrasi dan Bikin Cluster
- Buka situs resmi MongoDB Atlas dan buat akun baru.
- Setelah masuk ke dashboard, klik tombol Create untuk membuat cluster baru.
- Pilih opsi M0 (Free Tier) untuk mendapatkan database gratis (kapasitas 512 MB, sangat cukup untuk belajar dan proyek kecil).
- Pilih penyedia cloud (AWS, Google Cloud, atau Azure) dan tentukan region terdekat dari lokasi Anda atau server aplikasi Anda (misalnya: Singapore).
- Klik Create Cluster. Tunggu beberapa menit sampai server selesai disiapkan.
Langkah 2: Konfigurasi Keamanan (Database User & IP Whitelist)
Sebelum database bisa diakses, Anda wajib mengatur hak aksesnya:
- Security Quickstart: Buat Username dan Password untuk database Anda. Simpan kredensial ini baik-baik.
- IP Access List: Masukkan IP Address internet Anda saat ini agar komputer Anda diizinkan mengakses database. Jika ingin aplikasi Anda bisa diakses dari mana saja (misalnya saat dideploy ke hosting/VPS), tambahkan IP
0.0.0.0/0(akses global).
Langkah 3: Mengambil Connection String (URI)
- Di dashboard Atlas, klik tombol Connect pada cluster yang baru dibuat.
- Pilih opsi Drivers (atau Connect your application).
- Pilih bahasa pemrograman atau framework yang Anda gunakan (misalnya: Node.js).
- Salin kode Connection String (URI) yang disediakan. Bentuknya akan seperti ini:
mongodb+srv://username:<password>@cluster0.xxxx.mongodb.net/?retryWrites=true&w=majority - Ganti teks
<password>dengan password user database yang Anda buat di Langkah 2.
Metode 2: Setup MongoDB Lokal (Windows / macOS / Linux)
Jika Anda lebih memilih melakukan pengembangan sepenuhnya secara offline tanpa koneksi internet, Anda bisa menginstal MongoDB langsung di komputer Anda.
Langkah untuk Windows:
- Download installer MongoDB Community Server format .msi di situs resmi MongoDB.
- Jalankan installer, pilih opsi Complete.
- Pastikan centang pada pilihan "Run service as a Network Service user" agar MongoDB otomatis berjalan di latar belakang setiap komputer dinyalakan.
- Centang juga pilihan untuk menginstal MongoDB Compass (GUI resmi MongoDB untuk melihat data secara visual).
- Klik Install sampai selesai.
Langkah untuk macOS (Menggunakan Homebrew):
Buka terminal Anda dan jalankan perintah berikut berurutan:
brew tap mongodb/brew
brew install mongodb-community@7.0
Untuk menjalankan layanannya di latar belakang:
brew services start mongodb-community@7.0
Langkah 3: Menghubungkan Aplikasi ke MongoDB
Setelah database siap (baik cloud maupun lokal), Anda bisa mulai menghubungkannya ke kode aplikasi. Berikut adalah contoh dasar menggunakan Node.js dan library Mongoose.
1. Install Dependensi
npm install mongoose
2. Tulis Kode Koneksi (db.js)
const mongoose = require('mongoose');
// Ganti dengan URI lokal jika pakai MongoDB Lokal: 'mongodb://127.0.0.1:27017/nama_database'
const MONGO_URI = 'mongodb+srv://username:password@cluster0.xxxx.mongodb.net/nama_database';
const connectDB = async () => {
try {
await mongoose.connect(MONGO_URI);
console.log('MongoDB Berhasil Terhubung!');
} catch (error) {
console.error('Gagal terhubung ke MongoDB:', error.message);
process.exit(1);
}
};
module.exports = connectDB;
Tips Tambahan Pengelolaan MongoDB
- Gunakan MongoDB Compass: Jangan lewatkan tool GUI ini. Compass sangat membantu untuk melihat, menambah, mengedit, dan menghapus data tanpa perlu mengetik sintaks query di terminal.
- Gunakan Environment Variables (.env): Jangan pernah menuliskan Connection String atau password database langsung di dalam kode utama. Simpan URI tersebut di file .env dan panggil menggunakan process.env.MONGO_URI demi keamanan data.
