View source for Linux : MariaDB Dasar (Cara Kerja Database Server)

'''MariaDB''' adalah database server yang paling sering kamu temui di server Debian dan Ubuntu. Halaman ini membahas '''cara kerjanya''', bukan sekadar daftar perintah instalasi.

== 🎯 Tujuan ==
Setelah membaca dan mencoba halaman ini, kamu bisa:
* menjelaskan beda '''server''' dan '''client''' di MariaDB;
* menentukan kapan koneksi lewat ''socket'' dan kapan lewat ''port'' 3306;
* membedakan '''user sistem operasi''' dan '''akun MariaDB''';
* membuat akun aplikasi dengan hak seperlunya, bukan memakai root;
* memilih '''dump''' sebagai cara backup, bukan menyalin folder data.

== 📍 Konteks nyata ==
Bayangkan koperasi sekolah. Ada lemari besi berisi buku besar, ada petugas loket, dan ada jam layanan.

Kamu tidak membuka lemari besi sendiri. Kamu menulis di formulir, menyerahkannya ke petugas, lalu petugas yang mencatat ke buku besar dan mengembalikan jawabannya.

MariaDB bekerja persis begitu. Aplikasi (PHP, Python, aplikasi kasir) adalah pengunjung loket. <code>mariadbd</code> adalah petugasnya. Folder <code>/var/lib/mysql</code> adalah lemari besinya.

* '''Aplikasi tidak pernah menyentuh file nilai.''' Ia hanya mengirim pertanyaan SQL ke server.
* '''Server yang memutuskan boleh atau tidak.''' Bukan aplikasi, bukan file konfigurasi PHP.
* '''Lemari besi dipegang satu petugas.''' Kalau kamu salin sendiri saat loket buka, isinya bisa setengah jadi.

🔥 '''Kasus nyata:''' Sebuah SMK punya aplikasi nilai berbasis PHP. Suatu sore admin menyalin folder <code>/var/lib/mysql</code> ke flashdisk sebagai "backup", padahal server sedang melayani input nilai. Arsipnya terlihat rapi, sekitar 400 MB. Dua bulan kemudian arsip itu dicoba dipulihkan dan InnoDB menolak membukanya, karena salinan diambil di tengah transaksi. Nilai satu kelas harus direkap manual dari kertas.

== 🧠 Konsep singkat ==
=== 🔹 Satu paket, dua program ===
Paket <code>mariadb-server</code> memasang '''server''': <code>mariadbd</code>. Paket klien memasang '''client''': <code>mariadb</code>.

Nama <code>mysqld</code> dan <code>mysql</code> masih ada sebagai symlink supaya skrip lama tetap jalan. Mengutip manpage Debian: <code>mysqld</code> sekarang adalah symlink ke <code>mariadbd</code>.

Server yang memegang data, aturan, dan riwayat transaksi. Client hanya mengirim pertanyaan dan menampilkan jawaban. Karena itu client bisa dimatikan kapan saja tanpa merusak data.

=== 🔹 Dua loket: socket dan port ===
Ada dua pintu masuk ke server yang sama:

* '''Socket''' — file <code>/run/mysqld/mysqld.sock</code>. Hanya untuk proses di mesin itu. Cepat, tidak lewat jaringan.
* '''TCP''' — port <code>3306</code>. Bisa dari mesin lain, tergantung <code>bind-address</code>.

Di Debian dan Ubuntu, <code>/etc/mysql/mariadb.conf.d/50-server.cnf</code> berisi <code>bind-address = 127.0.0.1</code>. Artinya port 3306 hanya menerima sambungan dari mesin itu sendiri.

📊 '''Angka penting:''' port bawaan <code>3306</code>, socket <code>/run/mysqld/mysqld.sock</code>, datadir <code>/var/lib/mysql</code>, dan <code>bind-address</code> bawaan <code>127.0.0.1</code>.

Client memilih pintu secara otomatis. Kalau kamu menulis <code>-h localhost</code>, client memakai socket. Kalau menulis <code>-h 127.0.0.1</code>, client memakai TCP. Dua-duanya menuju server yang sama, tetapi jejaknya berbeda.

=== 🔹 Tiga lapis yang harus lolos ===
Kegagalan koneksi database hampir selalu salah satu dari tiga lapis ini:

# '''Proses hidup dan mendengar.''' Ada proses <code>mariadbd</code>, ada file socket atau port yang listen.
# '''Akun MariaDB cocok.''' Nama user dan alamat asal cocok dengan akun yang terdaftar.
# '''Hak cukup.''' Akun itu punya izin pada database dan tabel yang dituju.

Aturannya: '''berhenti di lapis pertama yang gagal'''. Jangan mengubah hak akses kalau servernya saja belum jalan.

=== 🔹 Dua nama yang sering tertukar ===
MariaDB menyimpan akun sebagai pasangan <code>user@host</code>. Titik koma terpenting: <code>'app'@'localhost'</code> dan <code>'app'@'%'</code> adalah '''dua akun berbeda''', bukan satu akun dengan dua izin.

{| class="wikitable"
! Fungsi !! Arti !! Contoh hasil
|-
| <code>USER()</code> || nama yang dikirim client || <code>app_nilai@localhost</code>
|-
| <code>CURRENT_USER()</code> || akun yang benar-benar dipakai server || <code>app_nilai@localhost</code>
|-
| <code>SHOW GRANTS</code> || hak milik akun yang sedang aktif || daftar GRANT
|}

Kalau dua nilai itu berbeda, artinya server mencocokkan permintaanmu ke akun lain. Itu petunjuk pertama saat muncul pesan "Access denied" yang membingungkan.

Aturan pencocokan host: yang '''paling spesifik menang'''. Alamat persis lebih kuat daripada wildcard, dan <code>%</code> paling lemah.

{| class="wikitable"
! Pola host !! Untuk apa !! Catatan
|-
| <code>localhost</code> || aplikasi di mesin yang sama || lewat socket
|-
| <code>127.0.0.1</code> || aplikasi di mesin yang sama || lewat TCP
|-
| <code>192.168.100.%</code> || aplikasi di LAN || wildcard satu segmen
|-
| <code>%</code> || semua alamat || hindari bila tidak perlu
|}

=== 🔹 Di mana datanya benar-benar tinggal ===
Semua database dan tabel disimpan di '''datadir''', biasanya <code>/var/lib/mysql</code>, dimiliki user <code>mysql</code>. Di dalamnya ada <code>ibdata1</code>, file <code>.ibd</code> per tabel, dan berkas log.

Ini bukan dokumen yang bisa dibuka dengan Word atau Notepad. Isinya struktur biner yang hanya masuk akal bagi server. Karena itu "backup" versi salin folder bukan sekadar kurang rapi, tetapi sering tidak bisa dipakai.

=== 🔹 InnoDB dan arti transaksi ===
Storage engine bawaan MariaDB adalah '''InnoDB'''. Ia yang mengurus transaksi, kunci per baris, dan pemulihan setelah listrik padam lewat redo log.

Transaksi berarti sekumpulan perubahan dianggap satu paket: semua berhasil, atau semua dibatalkan. Kalau server mati di tengah jalan, InnoDB memutar ulang log untuk menyelesaikan atau membatalkan paket itu.

Karena itu:
* Menyalin file saat server hidup bisa menangkap paket yang setengah selesai.
* Backup yang benar memakai alat yang '''meminta potret konsisten''' ke server, bukan mencuri file di belakangnya.

== 🧩 Istilah penting ==
{| class="wikitable"
! Istilah !! Arti sederhana !! Analogi
|-
| Instance || satu proses server yang mengelola satu datadir || satu petugas, satu lemari
|-
| datadir || folder induk semua data || lemari besi
|-
| Socket || jalur komunikasi lokal berbentuk file || loket dalam gedung
|-
| bind-address || alamat yang boleh dihubungi lewat TCP || pintu mana yang dibuka
|-
| user@host || akun beserta alamat asal yang diizinkan || kartu anggota + lokasi
|-
| Privilege || hak baca, tulis, ubah, hapus || tingkat akses kunci
|-
| Storage engine || mesin penyimpanan tabel || rak kayu atau rak besi
|-
| Transaksi || paket perubahan all-or-nothing || setoran tunai sekali hitung
|-
| Dump || berkas SQL berisi struktur dan isi || fotokopi buku besar
|-
| Consistent snapshot || potret data pada satu titik waktu || foto, bukan video
|}

Istilah lain yang akan kamu temui: <code>max_connections</code> (jumlah sambungan bersamaan, bawaan 151), <code>max_allowed_packet</code> (ukuran kiriman terbesar, bawaan 16 MB), dan <code>tmpdir</code> (folder kerja sementara saat mengolah query besar).

== 🔧 Praktik: menyiapkan database untuk aplikasi sekolah ==
Latihan ini memakai VM Debian atau Ubuntu, '''bukan server produksi'''. Pakai aplikasi nilai sekolah sebagai contoh supaya konteksnya terasa.

# '''Potret keadaan awal.''' Catat versi, layanan, dan jalur:<syntaxhighlight lang="text">
systemctl status mariadb --no-pager | head -5
mariadb --version
ss -lntp | grep 3306
ls -ld /var/lib/mysql
</syntaxhighlight>
# '''Baca identitas server yang sebenarnya.''' Jangan menebak dari file konfigurasi saja:<syntaxhighlight lang="text">
sudo mariadb -e "SELECT @@version, @@port, @@socket, @@datadir, @@bind_address;"
</syntaxhighlight>Hasilnya adalah gabungan konfigurasi default dan isi <code>mariadb.conf.d</code>.
# '''Buktikan dua lapis identitas.''' Jalankan sebagai user OS biasa, lalu bandingkan:<syntaxhighlight lang="text">
whoami
sudo -u www-data mariadb -e "SELECT USER(), CURRENT_USER();"
</syntaxhighlight>Baris pertama menjawab "siapa OS-nya", baris kedua menjawab "akun MariaDB mana yang dipakai".
# '''Buat database dan akun aplikasi.''' Akun khusus, bukan root:<syntaxhighlight lang="text">
sudo mariadb <<'SQL'
CREATE DATABASE nilai_smk
  CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'app_nilai'@'localhost' IDENTIFIED BY 'GantiDenganSandiPanjang';
GRANT SELECT, INSERT, UPDATE, DELETE ON nilai_smk.* TO 'app_nilai'@'localhost';
SQL
</syntaxhighlight><code>utf8mb4</code> penting agar nama siswa dengan karakter khusus tidak rusak.
# '''Uji dari sudut pandang aplikasi.''' Masuk sebagai <code>app_nilai</code>, buat tabel, lalu coba hapus database:<syntaxhighlight lang="text">
mariadb -u app_nilai -p nilai_smk -e "
CREATE TABLE siswa (id INT PRIMARY KEY AUTO_INCREMENT, nama VARCHAR(80));
INSERT INTO siswa (nama) VALUES ('Rina'), ('Bagas');"
mariadb -u app_nilai -p -e "DROP DATABASE nilai_smk;"
</syntaxhighlight>Perintah terakhir '''harus ditolak'''. Pesannya kurang lebih <code>Access denied ... to database 'nilai_smk'</code>. Itu tanda hak sudah benar.
# '''Bandingkan socket dan TCP.''' Perhatikan akun mana yang tercatat di masing-masing jalur:<syntaxhighlight lang="text">
sudo mariadb -e "SELECT USER(), CURRENT_USER();"
sudo mariadb -h 127.0.0.1 -e "SELECT USER(), CURRENT_USER();"
</syntaxhighlight>Jangan berasumsi. Baca hasilnya, lalu cocokkan dengan <code>SHOW GRANTS</code>.
# '''Periksa engine tabel.''' Pastikan tabel baru benar-benar InnoDB:<syntaxhighlight lang="text">
sudo mariadb -e "SHOW ENGINES\G" | grep -E "InnoDB|DEFAULT"
sudo mariadb -e "SELECT TABLE_NAME, ENGINE FROM information_schema.TABLES
  WHERE TABLE_SCHEMA='nilai_smk';"
</syntaxhighlight>
# '''Ambil dump yang konsisten.''' Opsi <code>--single-transaction</code> membuat potret tanpa mengunci tabel InnoDB:<syntaxhighlight lang="text">
sudo mkdir -p /srv/backup-db
sudo mariadb-dump --single-transaction --routines --events \
  nilai_smk > /srv/backup-db/nilai-$(date +%F).sql
head -20 /srv/backup-db/nilai-$(date +%F).sql
</syntaxhighlight>
# '''Restore ke database uji, bukan ke aslinya.''' Ini kebiasaan yang membedakan admin rapi dan admin panik:<syntaxhighlight lang="text">
sudo mariadb -e "CREATE DATABASE nilai_uji"
sudo mariadb nilai_uji < /srv/backup-db/nilai-$(date +%F).sql
sudo mariadb -e "SELECT COUNT(*) FROM nilai_uji.siswa;"
</syntaxhighlight>Jumlah barisnya harus sama dengan database asal.
# '''Bandingkan dengan cara yang salah.''' Coba salin datadir saat server hidup, lalu lihat hasilnya:<syntaxhighlight lang="text">
sudo cp -a /var/lib/mysql /srv/backup-db/salinan-datadir
ls -l /srv/backup-db/salinan-datadir | head
</syntaxhighlight>Ukurannya bisa besar, tetapi isinya tidak dijamin konsisten. Simpan sebagai pembanding, lalu hapus.

💡 '''Tips:''' Beri nama akun sesuai aplikasinya, misalnya <code>app_nilai</code>, <code>app_kasir</code>, <code>app_absensi</code>. Saat ada masalah, kamu langsung tahu aplikasi mana yang harus diperiksa.

⚠️ '''Hati-hati:''' <code>FLUSH PRIVILEGES</code> '''tidak wajib''' setelah <code>CREATE USER</code> atau <code>GRANT</code>. Perintah itu hanya perlu kalau kamu mengubah tabel hak akses secara langsung dengan <code>INSERT</code> atau <code>UPDATE</code>.

== 🏭 Dipakai di dunia kerja ==
* '''Sekolah:''' aplikasi ujian berbasis komputer dan e-rapor menyimpan soal serta nilai di MariaDB. Akun aplikasi wajib terbatas, karena satu salah <code>GRANT</code> bisa membuat nilai satu angkatan bisa dihapus dari halaman web.
* '''Kantor:''' aplikasi kasir dan stok distributor memakai satu database untuk beberapa cabang. <code>bind-address</code> dan akun per cabang menentukan siapa boleh masuk dari mana.
* '''Klinik dan puskesmas:''' rekap kunjungan dan stok obat disimpan di database. Data ini termasuk data pribadi, jadi akses dan backup-nya diatur ketat.
* '''ISP dan warnet:''' aplikasi billing mencatat sesi dan pembayaran pelanggan. Server yang tumbang berarti transaksi tidak tercatat, jadi backup dan uji restore masuk rutinitas.
* '''Industri:''' mesin produksi mengirim data ke database untuk laporan harian. Beban tulis tinggi menuntut pemahaman transaksi dan index, bukan hanya perintah SELECT.
* '''Hosting dan pengembang aplikasi:''' banyak aplikasi PHP, Laravel, dan WordPress memakai MariaDB. Kemampuan membaca pesan error dan hak akses mempercepat pekerjaan sehari-hari.

== ✅ Verifikasi ==
{| class="wikitable"
! Yang dicek !! Perintah !! Hasil yang benar
|-
| Layanan hidup || <code>systemctl is-active mariadb</code> || <code>active</code>
|-
| Port dan socket || <code>ss -lntp &#124; grep 3306</code> || listen di 127.0.0.1:3306
|-
| Identitas server || <code>SELECT @@datadir, @@socket;</code> || jalur sesuai kenyataan
|-
| Akun terpakai || <code>SELECT CURRENT_USER();</code> || akun yang kamu buat
|-
| Hak akun || <code>SHOW GRANTS FOR 'app_nilai'@'localhost';</code> || hanya SELECT, INSERT, UPDATE, DELETE
|-
| Uji tolak hak || <code>DROP DATABASE nilai_smk;</code> || <code>ERROR 1044</code>
|-
| Engine tabel || <code>SELECT ENGINE FROM information_schema.TABLES ...</code> || <code>InnoDB</code>
|-
| Isi dump || <code>grep -c "CREATE TABLE" file.sql</code> || jumlah tabel sesuai
|}

🧪 '''Uji cepat:''' satu baris untuk memastikan server benar-benar melayani, bukan hanya prosesnya ada.
<syntaxhighlight lang="text">
mariadb -e "SELECT 1 AS hidup, NOW() AS waktu_server;"
</syntaxhighlight>

== ⚠️ Kesalahan umum & troubleshooting ==
{| class="wikitable"
! Gejala !! Penyebab !! Perbaikan
|-
| <code>Can't connect ... socket</code> || layanan mati atau socket beda jalur || cek <code>systemctl status</code> dan <code>@@socket</code>
|-
| <code>Connection refused</code> ke 127.0.0.1 || hanya socket yang aktif || periksa <code>bind-address</code> dan <code>skip-networking</code>
|-
| <code>Access denied for user</code> || sandi salah atau akun beda host || baca <code>CURRENT_USER()</code>, cek <code>SHOW GRANTS</code>
|-
| <code>Host ... is not allowed</code> || tidak ada akun untuk alamat asal || buat akun <code>@</code> yang tepat
|-
| <code>ERROR 1044</code> || akun ada, hak kurang || tambah <code>GRANT</code> seperlunya
|-
| <code>Unknown database</code> || nama salah atau belum dibuat || <code>SHOW DATABASES;</code>
|-
| <code>Too many connections</code> || sambungan menumpuk || tutup koneksi aplikasi, cek <code>max_connections</code>
|-
| <code>No space left on device</code> || disk penuh || cek <code>df -h</code>, bersihkan log dan dump lama
|-
| <code>Table ... is marked as crashed</code> || server mati keras saat menulis || hentikan layanan, periksa dengan alat recovery InnoDB
|-
| <code>Can't create/write to file</code> || <code>tmpdir</code> penuh atau izin salah || cek ruang dan pemilik folder
|}

⚠️ '''Hati-hati:''' pesan "Access denied" tidak selalu berarti sandi salah. Di banyak kasus, sandi benar tetapi server mencocokkan ke akun lain karena alamat asalnya berbeda.

🔥 '''Kasus nyata:''' Sebuah kantor distributor memindahkan aplikasi kasir ke server baru. Aplikasi menulis <code>localhost</code>, tetapi pustaka kliennya menerjemahkan itu ke TCP.

Akun yang dibuat hanya <code>'kasir'@'localhost'</code>, sehingga koneksi ditolak setiap pagi selama tiga hari. Tim menuduh jaringan, padahal penyebabnya satu baris pola host. Solusinya bukan memberi <code>'%'</code>, tetapi membuat akun untuk alamat yang benar-benar dipakai.

== 🔐 Catatan keamanan & etika ==
* '''Jangan pakai root untuk aplikasi.''' Akun aplikasi cukup SELECT, INSERT, UPDATE, DELETE pada satu database. Root hanya untuk pekerjaan administrasi di mesin itu.
* '''Biarkan <code>bind-address</code> tetap 127.0.0.1''' kalau tidak ada aplikasi dari mesin lain. Membukanya ke <code>0.0.0.0</code> tanpa firewall sama dengan menaruh loket di pinggir jalan.
* '''Sandi di file konfigurasi''' harus dibaca hanya oleh pemiliknya. File <code>.env</code> dengan mode 644 dan isi sandi database adalah kebocoran yang menunggu waktu.
* '''Dump berisi data pribadi.''' Nilai, nomor telepon, dan riwayat pembayaran ada di dalamnya. Simpan dengan izin ketat, jangan di folder web yang bisa diunduh, dan jangan dikirim ke grup chat.
* '''Autentikasi <code>unix_socket</code>''' tidak memakai sandi; kekuatannya adalah keamanan user OS. Dokumentasi resmi menegaskan: siapa pun yang bisa menjadi user OS itu bisa masuk. Jadi jagalah <code>sudo</code> dan akun sistem.
* '''Etika:''' data nilai, pasien, dan pelanggan bukan bahan latihan. Uji di VM sendiri, dan jangan pernah mencoba memulihkan dump produksi ke server orang lain tanpa izin.

📊 '''Angka penting:''' di instalasi baru paket Debian dan Ubuntu, <code>root@localhost</code> dibuat memakai plugin <code>unix_socket</code>. Kalau seseorang pernah menjalankan <code>mysql_secure_installation</code>, plugin itu bisa berubah menjadi autentikasi sandi. Karena itu selalu periksa, jangan mengandalkan asumsi.

== 📌 Kesimpulan ==
MariaDB adalah '''layanan''', bukan aplikasi yang dibuka: satu proses memegang datadir, dan semua permintaan lewat loket socket atau port 3306.

Kunci memahami masalahnya ada tiga lapis: proses, akun <code>user@host</code>, lalu hak. Berhenti di lapis pertama yang gagal, dan baca <code>CURRENT_USER()</code> sebelum menebak.

Backup yang sah adalah dump yang pernah direstore, bukan folder yang berhasil disalin.

Langkah berikutnya: ambil satu database latihan, buat akun aplikasi dengan hak terbatas, lalu buktikan dump-nya bisa dipulihkan ke database uji.

== 🔗 Materi terkait ==
* [[Linux : Manajemen Paket dan Repositori Debian]] — cara memasang dan memeriksa paket <code>mariadb-server</code>.
* [[Linux : Membuat Service Sendiri dengan systemd]] — memahami mengapa <code>mariadb.service</code> bisa gagal start.
* [[Linux : Log dan journalctl untuk Troubleshooting]] — membaca jejak kegagalan layanan database.
* [[Linux : Backup Otomatis dengan rsync, tar, dan cron]] — menjadwalkan dump dan menyimpan salinannya.
* [[Linux : Praktikum Uji Restore dan Verifikasi Arsip Backup]] — membuktikan arsip benar-benar bisa dipulihkan.
* [[Linux : Nginx Dasar dan Virtual Host]] — memasang aplikasi web yang akan berbicara ke database ini.
* [[Debian : Database Server]] dan [[Shell Scripting : Mariadb dan PhpMyAdmin]] — panduan instalasi dan skrip pemasangan.

== 📚 Referensi ==
* MariaDB Documentation — ''Authentication Plugin - Unix Socket''.
* MariaDB Documentation — ''Differences in MariaDB in Debian (and Ubuntu)''.
* MariaDB Documentation — ''mariadb-dump''.
* Debian Manpages bookworm — <code>mariadbd(8)</code>, <code>mariadb(1)</code>, <code>mariadb-dump(1)</code>.
* Berkas konfigurasi <code>/etc/mysql/mariadb.conf.d/50-server.cnf</code> pada MariaDB 10.11 (Ubuntu 24.04), diperiksa langsung: <code>bind-address = 127.0.0.1</code>, <code>socket = /run/mysqld/mysqld.sock</code>, <code>datadir = /var/lib/mysql</code>, engine bawaan <code>InnoDB</code>.

[[Category:TKJ]]
[[Category:Linux]]
[[Category:Server]]
[[Category:Database]]