Home / Artikel / Web Development
Web Development

Database Migration Tanpa Drama: Cara Mengubah Skema MySQL dengan Aman

Perubahan kecil pada tabel bisa berdampak besar ketika website sudah dipakai banyak orang. Dengan strategi migration yang bertahap, teruji, dan sadar risiko, perubahan skema MySQL tidak harus menjadi sumber downtime ata…

Database Migration Tanpa Drama: Cara Mengubah Skema MySQL dengan Aman

Menambah kolom, mengganti nama field, atau membuat indeks baru terdengar seperti pekerjaan sederhana. Namun, ketika tabel sudah berisi jutaan baris dan aplikasi terus menerima transaksi, satu perintah ALTER TABLE yang tidak direncanakan bisa membuat halaman lambat, request menumpuk, bahkan deployment gagal.

Di sinilah database migration penting. Migration bukan sekadar kumpulan file SQL, melainkan cara terstruktur untuk mencatat, menguji, dan menerapkan perubahan struktur database. Tujuannya bukan membuat perubahan bebas risiko—itu hampir tidak mungkin—melainkan membuat risikonya terlihat dan bisa dikendalikan.

Mengapa perubahan skema sering mengejutkan?

Aplikasi dan database memiliki hubungan yang lebih erat daripada yang sering kita sadari. Kode aplikasi mengharapkan kolom tertentu tersedia, tipe datanya sesuai, dan indeks bekerja dengan cara yang diperkirakan. Jika struktur database berubah lebih dulu atau terlalu cepat, versi aplikasi lama dapat gagal membaca data.

Masalah lain muncul dari ukuran tabel. Menambahkan satu kolom pada tabel kecil mungkin selesai hampir seketika. Pada tabel besar, operasi tertentu dapat membutuhkan waktu, ruang disk, atau lock. Lock adalah mekanisme yang membatasi akses sementara agar perubahan struktur tetap konsisten.

MySQL modern memiliki Online DDL, yaitu kemampuan menjalankan sebagian perubahan struktur dengan gangguan lebih kecil terhadap operasi baca-tulis. Namun, fitur ini bukan jaminan bahwa semua perubahan aman dilakukan kapan saja. Dokumentasi MySQL menjelaskan bahwa dukungan instant, in-place, dan copy berbeda-beda bergantung pada jenis operasi, storage engine, dan kondisi tabel. Lihat dokumentasi Online DDL MySQL sebelum menjalankan perubahan di produksi.

Bedakan perubahan yang kompatibel dan yang berisiko

Langkah pertama adalah mengelompokkan migration berdasarkan dampaknya terhadap versi aplikasi yang sedang berjalan.

Perubahan yang biasanya lebih kompatibel

  • Menambahkan kolom baru yang boleh bernilai NULL.
  • Menambahkan indeks sekunder setelah menguji beban dan ruang disk.
  • Menambahkan tabel baru yang belum langsung dipakai oleh versi aplikasi lama.
  • Menambahkan nilai enum atau status baru dengan rencana fallback yang jelas.

Perubahan ini relatif aman karena aplikasi lama masih dapat bekerja tanpa mengetahui kolom atau tabel baru. Tetap saja, istilah “relatif aman” bukan berarti boleh dilewati dari pengujian.

Perubahan yang membutuhkan tahapan

  • Mengganti nama kolom yang masih dipakai banyak bagian aplikasi.
  • Mengubah tipe data, misalnya dari INT ke BIGINT.
  • Mengubah kolom dari boleh kosong menjadi NOT NULL.
  • Menghapus kolom atau tabel yang mungkin masih dibaca oleh versi aplikasi lama.

Perubahan seperti ini sebaiknya tidak dilakukan dalam satu langkah besar. Gunakan pola expand-and-contract: perluas struktur terlebih dahulu, pindahkan penggunaan aplikasi secara bertahap, lalu bersihkan struktur lama setelah dipastikan tidak lagi dipakai.

Contoh pola expand-and-contract

Misalnya, aplikasi lama menyimpan nama lengkap pelanggan dalam kolom name. Anda ingin memisahkannya menjadi first_name dan last_name.

  1. Expand: tambahkan kolom baru yang masih boleh kosong.
  2. Backfill: isi data lama ke kolom baru secara bertahap, bukan dalam satu query raksasa.
  3. Dual write: untuk sementara, aplikasi menulis ke kolom lama dan baru.
  4. Switch read: ubah pembacaan aplikasi agar menggunakan kolom baru.
  5. Contract: setelah semua versi aplikasi lama tidak aktif, hapus kolom lama.

Contoh migration awalnya dapat terlihat seperti berikut:

ALTER TABLE customers
  ADD COLUMN first_name VARCHAR(100) NULL,
  ADD COLUMN last_name VARCHAR(100) NULL,
  ALGORITHM=INSTANT;

Jangan menambahkan ALGORITHM=INSTANT hanya karena terlihat lebih cepat. Klausa tersebut membuat operasi gagal jika MySQL tidak dapat menjalankannya dengan algoritma instant. Dalam konteks tertentu, kegagalan cepat lebih baik daripada server diam-diam melakukan operasi yang jauh lebih berat.

Jangan mengandalkan rollback sebagai tombol undo

Rollback migration sering disalahpahami sebagai cara mengembalikan database persis seperti sebelum perubahan. Untuk perubahan data besar, hal itu tidak selalu benar. Jika sebuah migration menghapus kolom, data yang ikut terhapus tidak otomatis kembali hanya karena file rollback dijalankan.

Selain itu, DDL pada MySQL memiliki aturan transaksi tersendiri. MySQL mendukung atomic DDL untuk banyak operasi pada InnoDB, tetapi atomic bukan berarti semua DDL dapat digabung ke dalam transaksi aplikasi lalu dibatalkan sesuka hati. Dokumentasi resminya menegaskan bahwa perintah DDL dapat mengakhiri transaksi aktif secara implisit. Karena itu, backup dan rencana pemulihan tetap diperlukan.

Anggap rollback sebagai skrip pemulihan struktur, bukan pengganti backup. Sebelum migration berisiko, pastikan Anda tahu cara memulihkan database, berapa lama prosesnya, dan siapa yang bertanggung jawab mengambil keputusan jika deployment harus dihentikan.

Uji migration seperti menguji fitur

Migration perlu diuji pada database yang ukurannya mendekati kondisi produksi. Pengujian pada tabel berisi seratus baris tidak akan menunjukkan perilaku yang sama dengan tabel berisi puluhan juta baris.

  • Jalankan migration pada salinan struktur dan data yang representatif.
  • Catat durasi, penggunaan CPU, I/O, ruang disk, dan dampaknya terhadap query lain.
  • Periksa metadata lock dan transaksi panjang yang mungkin menahan proses.
  • Uji aplikasi versi lama dan versi baru selama masa transisi.
  • Pastikan migration dapat dijalankan ulang dengan aman atau memiliki pemeriksaan kondisi yang jelas.

MySQL juga menjelaskan bahwa Online DDL tetap dapat menunggu transaksi yang memegang metadata lock. Jadi, meskipun sebuah operasi disebut online, transaksi yang terbengkalai atau koneksi yang tidak menutup dengan benar tetap bisa menghambat tahap akhir perubahan.

Praktik yang bisa dilakukan sekarang

Jika proyek Anda belum memiliki kebiasaan migration yang rapi, mulai dari aturan sederhana berikut:

  1. Simpan migration di version control bersama kode aplikasi.
  2. Gunakan nama file yang menjelaskan urutan dan tujuan perubahan.
  3. Hindari migration yang terlalu banyak melakukan hal berbeda sekaligus.
  4. Tambahkan pemeriksaan setelah migration, misalnya jumlah baris atau keberadaan indeks.
  5. Jadwalkan migration besar pada periode beban rendah, tetapi tetap siapkan pemantauan.
  6. Jangan hapus kolom lama pada deployment yang sama ketika kode aplikasi baru pertama kali berhenti menggunakannya.

Untuk operasi yang bisa dilakukan online, migration terpisah sering lebih mudah diuji dan dipantau. MySQL sendiri mencatat bahwa operasi online dapat dipisah menjadi beberapa perintah agar lebih mudah dirawat, selama tidak ada alasan kuat untuk menjalankannya sebagai satu kelompok.

Intinya

Database migration yang baik bukan yang paling singkat, melainkan yang paling mudah dipahami ketika terjadi masalah. Pisahkan perubahan struktur dari perpindahan data, beri waktu bagi aplikasi lama dan baru untuk hidup berdampingan, dan perlakukan setiap migration besar sebagai perubahan produksi yang perlu observabilitas.

Dengan pendekatan ini, perubahan skema tidak lagi menjadi ritual “jalankan SQL lalu berharap”. Anda memiliki jejak perubahan, rencana pemulihan, serta tahapan yang membuat database bisa berkembang tanpa memaksa seluruh aplikasi berhenti sekaligus.

Sumber & bacaan lebih lanjut

– Rio Yotto @rioyotto