Menghubungkan aplikasi ke database

Salin host, port, user, dan password, atau pakai string koneksi siap pakai dengan TLS.

Semua informasi untuk terhubung ada di tab Koneksi di panel database. Panduan ini menjelaskan arti setiap data koneksi, cara memakai string koneksi siap pakai, cara kerja TLS, dan langkah pemecahan masalah bila aplikasi gagal terhubung.

Data koneksi

Data	Keterangan
Host	Alamat server, contohnya namaku.db.id1.nivelva.app.
Port	Port khusus untuk database kamu.
Database	Nama database bawaan, misalnya defaultdb.
Username	User database.
Password	Klik ikon mata untuk melihat, atau ikon salin untuk langsung menyalin.

Setiap baris punya tombol salin, jadi kamu tidak perlu mengetik ulang. Mengetik ulang sering menyebabkan salah huruf, terutama pada password acak.

Port setiap database berbeda dan bukan port bawaan seperti 5432 untuk PostgreSQL atau 3306 untuk MySQL. Selalu pakai port yang tertera di panel.

String koneksi siap pakai

Di bawah data koneksi ada pilihan format. Pilih yang sesuai, lalu klik salin:

• URI: satu baris untuk hampir semua framework, misalnya postgresql://dbuser:PASSWORD@host:port/defaultdb?sslmode=require.
• Perintah CLI (misalnya psql): untuk terhubung langsung dari terminal.
• .env: variabel environment, tinggal tempel ke file .env aplikasi.
• JDBC: untuk aplikasi Java.

Password di string koneksi disamarkan di layar. Saat kamu mengklik tombol salin, password asli ikut tersalin.

Contoh pemakaian

Laravel (.env): salin format .env, lalu tempel ke file .env proyek Laravel. Pastikan nilai host, port, database, username, dan password sama dengan panel.

Node.js dengan Prisma: salin format URI lalu isi ke variabel DATABASE_URL. Pastikan URI berisi sslmode=require.

Terminal: salin perintah CLI, jalankan di terminal komputermu, lalu masukkan password bila diminta.

Koneksi wajib TLS

Semua koneksi wajib terenkripsi. Koneksi tanpa TLS otomatis ditolak. TLS melindungi data dan password agar tidak bisa dibaca selama perjalanan dari aplikasi ke database.

• Untuk sebagian besar aplikasi, sslmode=require atau opsi ssl: true sudah cukup.
• Untuk verifikasi penuh, klik Unduh CA, simpan file nivelva-ca.pem, lalu pakai sslmode=verify-full dengan file tersebut. Mode ini memastikan aplikasi benar-benar terhubung ke server Nivelva, bukan ke server lain yang menyamar.

Sertifikat server diperbarui otomatis sebelum masa berlakunya habis. Tanggal berlakunya tampil di bagian Koneksi wajib TLS.

Bagian Driver aplikasi di tab yang sama berisi contoh pengaturan untuk driver populer seperti Node pg, Prisma, dan Django.

Tidak bisa terhubung?

Periksa satu per satu:

1. TLS belum aktif di aplikasi. Pesan error biasanya menyebut SSL atau encryption. Tambahkan sslmode=require atau opsi SSL di driver.
2. Allowlist IP. Bila allowlist di tab Keamanan diisi, IP server aplikasimu harus ada di daftar. Lihat Mengamankan database.
3. Port salah. Pastikan port sesuai panel, bukan port bawaan.
4. Password salah. Salin ulang dengan tombol salin. Bila password baru saja diganti, perbarui di aplikasi.
5. Database ditangguhkan. Cek status layanan. Bila ada faktur terlambat, bayar dulu.
6. Storage penuh. Database tetap menerima koneksi tetapi menjadi read-only. Lihat Storage, performa, dan naik paket.

Menyimpan kredensial dengan aman

• Simpan password di file .env atau secret manager, bukan langsung di kode.
• Jangan masukkan file .env ke repository publik seperti GitHub.
• Bila password pernah terlanjur dibagikan, segera ganti lewat tab Keamanan.

Menguji koneksi sebelum memasang di aplikasi

Sebelum mengubah konfigurasi aplikasi, uji dulu koneksi dari komputer atau server yang sama dengan aplikasimu. Salin perintah CLI dari panel lalu jalankan di terminal. Bila berhasil masuk, berarti host, port, password, TLS, dan allowlist sudah benar, dan masalah apa pun di aplikasi berasal dari pengaturan aplikasinya. Bila gagal, pesan error di terminal biasanya lebih jelas daripada pesan error di aplikasi.

Jumlah koneksi

Setiap paket punya batas jumlah koneksi bersamaan. Aplikasi web yang membuka koneksi baru untuk setiap permintaan bisa cepat mencapai batas ini saat ramai. Gunakan connection pooling, yaitu pengaturan agar aplikasi memakai ulang koneksi yang sudah terbuka. Sebagian besar framework modern sudah menyediakannya, cukup atur jumlah maksimal koneksi di bawah batas paket.

Tanya jawab

Apakah alamat host bisa berubah? Tidak. Host dan port tetap sama selama layanan aktif, termasuk saat naik paket atau menambah storage.

Bisakah terhubung dari aplikasi GUI seperti DBeaver atau TablePlus? Bisa. Isi host, port, database, username, dan password dari panel, lalu aktifkan opsi SSL atau TLS di pengaturan koneksi aplikasinya.