Kursus MariaDB / Memeriksa Pengaturan Server, Mode SQL, Zona Waktu, dan Log
Periksa konfigurasi MariaDB pada tiga tingkat: berkas opsi, nilai global saat server berjalan, dan nilai sesi koneksi saat ini. Mode SQL dan zona waktu dapat berbeda antarkoneksi, sedangkan log kesalahan serta log kueri lambat mempunyai tujuan dan syarat pencatatan yang berbeda.
Bedakan berkas, GLOBAL, dan SESSION
| Cakupan | Makna | Hal yang perlu dibedakan |
|---|---|---|
| Berkas opsi | Opsi yang dibaca ketika server atau klien dimulai | Berkas aktual, kelompok opsi, urutan pembacaan, dan argumen layanan |
| GLOBAL | Pengaturan server atau nilai awal untuk koneksi baru | Kemampuan diubah saat berjalan dan hak yang diperlukan bergantung pada variabel |
| SESSION | Nilai untuk koneksi saat ini | Koneksi lain dapat berbeda; nilainya berlaku dalam sesi tersebut |
Mengubah nilai awal global tidak selalu memperbarui sesi yang sudah ada. Perubahan sesi juga tidak menunjukkan nilai yang akan bertahan setelah server dimulai ulang. Mulailah dengan kueri pembacaan di bawah. Contoh yang dapat dieksekusi diperiksa pada MariaDB 12.3.3; nama opsi log kueri lambat dalam berkas ditujukan untuk MariaDB 10.11 atau lebih baru.
Latihan event terjadwal menjelaskan pengaruh konteks waktu. Untuk diagnosis kueri, panduan EXPLAIN dan perbandingan rencana membedakan perkiraan rencana dari pengamatan eksekusi.
SELECT VERSION(), @@GLOBAL.sql_mode, @@SESSION.sql_mode,
@@GLOBAL.time_zone, @@SESSION.time_zone, @@system_time_zone;
SHOW GLOBAL VARIABLES WHERE Variable_name IN
('datadir', 'log_error', 'log_output', 'log_slow_query',
'log_slow_query_file', 'log_slow_query_time');
Hak akses atau kebijakan layanan terkelola dapat membatasi informasi yang tersedia. Periksa versi dan nama variabel pada server yang benar-benar terhubung. Referensi variabel sistem MariaDB menjelaskan cakupan serta apakah suatu nilai dapat diubah saat server berjalan.
Temukan berkas opsi yang benar-benar dibaca
Sistem mirip Unix umumnya memakai my.cnf, sedangkan Windows dapat memakai my.ini atau my.cnf. Lokasi tepatnya bergantung pada pemasangan dan argumen layanan. Perintah berikut menunjukkan jalur bawaan serta kelompok opsi program. Gunakan jalur lengkap executable jika tidak tersedia pada PATH.
mariadbd --help --verbose
Baca bagian berkas opsi dan kelompoknya, lalu periksa apakah layanan memberikan --defaults-file tersendiri. Nilai yang dibaca belakangan dapat menimpa nilai sebelumnya. Keluaran dapat mengandung opsi sensitif; jangan membagikan seluruhnya tanpa peninjauan. Aturan resmi berkas opsi menjelaskan cara pembacaannya.
Pada server latihan terpisah, opsi berikut dapat dipakai untuk mengamati konfigurasi persisten. Cadangkan dahulu berkas yang benar-benar dibaca dan catat baris yang diubah. Gunakan kelompok [mariadbd] yang sesuai. Nama opsi dalam berkas tidak memakai awalan -- seperti argumen baris perintah.
[mariadbd]
sql-mode=STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
default-time-zone=+00:00
log-output=FILE
log-slow-query=ON
log-slow-query-time=1
log-slow-query-file=appops-slow.log
Nama berkas log kueri lambat di atas relatif. Setelah server dimulai, periksa direktori data dan jalur berkas yang efektif. Mulai ulang hanya server latihan terisolasi melalui prosedur layanan Windows atau Linux yang berlaku pada pemasangannya. Jika server gagal dimulai, periksa log kesalahan dan pulihkan berkas cadangan. Memulai ulang server produksi bersama bukan bagian dari latihan ini.
Ubah satu mode SQL pada sesi saat ini
Buat tabel latihan yang boleh dibuang dalam appops_lab. Periksa tujuan basis data yang sudah ada serta definisi dan data mode_items sebelum mengulang CREATE.
CREATE DATABASE IF NOT EXISTS appops_lab
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE appops_lab;
CREATE TABLE mode_items (
item_id INT PRIMARY KEY, category_name VARCHAR(20), price INT
) ENGINE=InnoDB;
INSERT INTO mode_items VALUES (1, 'Books', 10), (2, 'Books', 20), (3, 'Tools', 30);
Pada koneksi yang sama, simpan daftar mode saat ini dan tambahkan ONLY_FULL_GROUP_BY tanpa mengosongkan seluruh daftar:
SET @saved_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = CONCAT_WS(',', NULLIF(@saved_mode, ''), 'ONLY_FULL_GROUP_BY');
SELECT category_name, SUM(price) AS total FROM mode_items GROUP BY category_name;
Agregasi yang valid menghasilkan Books, yaitu buku, dengan total 30 dan Tools, yaitu alat, juga 30. Urutan kedua baris tidak dijamin tanpa ORDER BY. Jalankan pernyataan berikut secara terpisah:
SELECT category_name, price FROM mode_items GROUP BY category_name;
ONLY_FULL_GROUP_BY menolak price yang tidak diagregasi dan tidak menjadi kolom pengelompokan. Sesudah kesalahan yang diharapkan ini, jalankan pemulihan pengaturan secara eksplisit:
SET SESSION sql_mode = @saved_mode;
SELECT @@SESSION.sql_mode;
Tentukan hasil yang dibutuhkan lalu perbaiki agregasi atau pengelompokannya, bukan menghapus seluruh mode agar harga sembarang dari suatu grup dapat ditampilkan. Program tersimpan juga mempertahankan mode SQL yang relevan saat dibuat, sehingga nilai dalam berkas opsi saja belum menjelaskan seluruh perilakunya. Lihat referensi SQL_MODE.
Bandingkan TIMESTAMP dan DATETIME pada zona waktu berbeda
Tetap gunakan basis data dan koneksi yang sama. zone_example harus merupakan tabel latihan baru. Jika objek dengan nama itu sudah ada, periksa dahulu sebelum menjalankan blok.
SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE zone_example (id INT PRIMARY KEY, ts TIMESTAMP, dt DATETIME);
INSERT INTO zone_example VALUES (1, '2026-01-01 09:00:00', '2026-01-01 09:00:00');
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = '+00:00';
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = @saved_time_zone;
SELECT pertama menampilkan 2026-01-01 09:00:00 pada kedua kolom. Setelah zona diganti menjadi +00:00, TIMESTAMP menampilkan 2026-01-01 00:00:00, sedangkan DATETIME tetap pada pukul 09:00:00. Hasil ini membedakan konversi zona sesi pada TIMESTAMP dari nilai tanggal dan jam DATETIME. Pernyataan terakhir memulihkan zona waktu sesi semula.
Zona bernama seperti Asia/Seoul bergantung pada tabel zona waktu server. Jika namanya tidak dikenal, periksa pemasangan dan pembaruan tabel tersebut. Offset numerik tetap dan zona geografis tidak selalu mempunyai perilaku waktu musim panas yang sama. Tetapkan pula kebijakan penyimpanan dan tampilan yang konsisten pada aplikasi. Penjelasan time_zone dan system_time_zone pada referensi variabel sistem membedakan cakupannya.
Baca log yang sesuai dengan pertanyaan diagnosis
| Log | Tujuan | Pemeriksaan |
|---|---|---|
| Log kesalahan | Awal, penghentian, kesalahan server, dan peringatan | log_error serta tujuan keluaran layanan atau kontainer |
| Log kueri lambat | Kueri yang memenuhi kondisi pencatatan | Status aktif, ambang waktu, tujuan, filter, dan jumlah minimum baris yang diperiksa |
| Log kueri umum | Pencatatan koneksi dan kueri secara luas | Beban pencatatan dan paparan data sensitif; bukan pilihan untuk selalu diaktifkan tanpa pertimbangan |
Log kueri lambat yang aktif tidak mencatat setiap kueri yang dianggap lambat oleh pengguna. Periksa ambang serta filternya, dan bedakan nilai awal global dari sesi saat ini. Pastikan keluaran memakai FILE atau TABLE. SQL dapat memuat data pribadi, sehingga akses, rotasi, dan masa simpan log perlu dikelola. Ikhtisar resmi log kueri lambat menjelaskan syarat pencatatan serta perubahan nama variabel.
Pada sesi baru di server latihan terisolasi, ambang satu detik dan filter yang sesuai memungkinkan SELECT SLEEP(1.2); dipakai untuk memeriksa tujuan log. Kueri ini sengaja menunggu alih-alih memperlambat pekerjaan bisnis. Jika catatan tidak muncul, periksa status aktif, tujuan, dan filter sebelum terus memperpanjang waktu tunggu.
Pulihkan pengaturan dan pastikan hasilnya
- Catat nilai sesi dan global serta kenali koneksi dan pekerjaan yang dapat terpengaruh.
- Ubah satu kondisi sesi dan amati perbedaannya.
- Cadangkan lalu edit berkas opsi yang sesuai hanya jika perubahan perlu bertahan setelah restart.
- Ikuti prosedur mulai ulang yang ditetapkan dan periksa nilai efektif melalui koneksi baru.
- Jika perlu, pulihkan nilai awal atau berkas cadangan, lalu periksa log kesalahan dan perilaku yang diharapkan.
Untuk menghapus hanya tabel latihan yang boleh dibuang, gunakan DROP TABLE appops_lab.mode_items, appops_lab.zone_example; setelah memeriksa nama serta kebutuhan penyimpanan. Memulihkan berkas, mengembalikan pengaturan sesi, dan menghapus tabel adalah tindakan terpisah. DROP TABLE tidak mengatur ulang konfigurasi server, dan ROLLBACK biasa tidak mengembalikan tabel yang dihapus.




