RUANG BACA DIGITAL BERBAHASA INDONESIA Dikelola PT. PENA DESA MEDIA

Memindahkan data MySQL ke JSON tanpa kehilangan hubungan data

Langkah ekspor, validasi ID, relasi, UTF-8, dan konsistensi data saat beralih dari database MySQL ke berkas JSON.

Ilustrasi editorial untuk memperkenalkan topik, bukan dokumentasi pengujian.

Pastikan JSON memang cocok untuk beban Anda

Koleksi panduan yang dibaca berkali-kali tetapi jarang diperbarui bisa cocok disimpan sebagai berkas. Sebaliknya, pembayaran, banyak penulis aktif, atau antrean yang ditulis bersamaan memerlukan pengelolaan transaksi dan akses yang lebih kuat. Menghapus MySQL hanya untuk menghilangkan konfigurasi koneksi dapat memindahkan kompleksitas ke kode yang lebih sulit dirawat.

Hitung ukuran yang dibaca pada tiap permintaan, bukan hanya ukuran arsip ZIP. Memuat seluruh koleksi ke memori untuk menampilkan satu judul dapat menghabiskan sumber daya. Pisahkan indeks ringan dari isi panjang bila pola akses memang membutuhkannya.

Tetapkan bentuk data sebelum mengekspor

Tulis nama kolom, tipe nilai, kunci unik, serta hubungan antarentitas. Jangan mengubah ID berdasarkan nomor urut hasil ekspor; tautan dan tabel lain mungkin sudah bergantung pada ID lama. Jika sebuah nilai terlihat seperti angka tetapi sebenarnya kode, pertahankan sebagai teks.

{
  "id": "00017",
  "category_id": "3",
  "title": "Contoh judul",
  "body": "Teks dengan titik koma; dan (kurung)."
}

Contoh ini sengaja memakai ID string untuk mempertahankan nol awal. Di proyek lain ID numerik bisa lebih tepat. Yang penting adalah kesepakatan tipe yang konsisten, bukan mengubah semua nilai secara otomatis berdasarkan penampilannya.

Ambil data dari pembaca yang memahami sumbernya

Jika database sumber masih tersedia, ekspor melalui query atau fasilitas database, lalu encode struktur hasilnya menjadi JSON. Jika yang tersedia hanya dump SQL, pulihkan dump pada database uji yang kompatibel dan terpisah sebelum mengambil data. Jangan menjalankan dump dari sumber tidak tepercaya pada database produksi.

Dump SQL dapat memuat beberapa baris dalam satu INSERT, string dengan tanda kutip, escape, dan titik koma di dalam isi. Menghitung statement INSERT bukan menghitung baris data. Dokumentasi mysqldump menerangkan bentuk keluaran dan pilihan ekspor yang memengaruhi isinya [1].

Parser khusus hanya layak dipakai jika tata bahasa yang didukung dinyatakan jelas dan diuji dengan contoh sulit. Satu file yang berhasil diproses bukan bukti bahwa parser mendukung seluruh variasi dump MySQL.

Rekonsiliasi jumlah, ID, dan relasi

SELECT COUNT(*) AS total FROM articles;
SELECT category_id, COUNT(*) AS total
FROM articles
GROUP BY category_id;
SELECT id, COUNT(*) AS total
FROM articles
GROUP BY id
HAVING COUNT(*) > 1;

Query di atas adalah contoh baca pada tabel uji bernama articles. Sesuaikan nama tabel tanpa merangkai input pengguna langsung ke SQL. Bandingkan hasilnya dengan jumlah objek JSON, jumlah ID unik, dan distribusi kategori. Dua keluaran dengan jumlah yang sama masih dapat memuat baris yang berbeda.

Periksa juga relasi yang kehilangan induk. Setiap category_id yang wajib memiliki kategori harus ditemukan pada daftar kategori, bukan hanya lolos karena tipenya benar. Untuk melihat pemeriksaan dasar di browser, gunakan pemeriksa JSON lokal.

Tangani encoding dan angka dengan sengaja

Pastikan jalur ekspor menggunakan UTF-8. Uji teks Arab, emoji, tanda kutip, baris baru, dan string kosong. Jangan diam-diam mengganti isi yang tidak valid dengan karakter pengganti tanpa mencatatnya; untuk arsip naskah, perubahan satu karakter bisa penting.

Di PHP, json_decode dapat diberi JSON_THROW_ON_ERROR agar kegagalan tidak bercampur dengan nilai null yang sah. JSON_BIGINT_AS_STRING membantu mempertahankan bilangan bulat yang tidak muat pada integer PHP [2]. Ini tetap tidak mengembalikan presisi yang sudah hilang pada langkah sebelumnya.

$data = json_decode(
    $json,
    true,
    512,
    JSON_THROW_ON_ERROR | JSON_BIGINT_AS_STRING
);

Cuplikan ini memerlukan PHP yang mendukung opsi tersebut dan penanganan exception di pemanggil. Ia hanya tahap decoding, bukan validator skema atau pembanding terhadap database.

Terbitkan salinan baru hanya setelah hasilnya cocok

Simpan hasil ekspor sebagai versi baru, jangan langsung menimpa berkas aktif. Baca kembali berkas yang sudah ditulis, jalankan pemeriksaan, lalu arahkan pembaca ke versi yang lulus. Bila ada banyak penulis bersamaan, gunakan strategi penguncian atau penyimpanan transaksional yang memang dirancang untuk kondisi itu.

Catat jumlah sumber, jumlah keluaran, aturan transformasi, serta sampel yang diperiksa. Pertahankan backup sumber sampai pemulihan benar-benar diuji. Tujuan migrasi bukan sekadar menghasilkan file JSON, melainkan menjaga arti data ketika cara penyimpanannya berubah.

Latihan referensi kategori: jumlah cocok, hubungan belum tentu

Berikut contoh buatan yang dapat dijalankan dengan Python 3 tanpa database. Kedua artikel memiliki ID unik. Namun salah satunya merujuk ke kategori yang tidak tersedia; pemeriksa jumlah dan ID saja tidak akan mendeteksi hal ini.

categories = [{"id": "c1"}, {"id": "c2"}]
articles = [
    {"id": "001", "category_id": "c1"},
    {"id": "002", "category_id": "c9"},
]
valid_categories = {row["id"] for row in categories}
orphans = [row["id"] for row in articles
           if row["category_id"] not in valid_categories]
print("Relasi kategori tidak ditemukan:", len(orphans))

Hasil yang diharapkan adalah Relasi kategori tidak ditemukan: 1. Kasus ini berbeda dari ID artikel yang hilang: hubungan antardata yang rusak tetap membutuhkan pemeriksaan tersendiri. Bandingkan dengan catatan migrasi sumber sebelum memutuskan file ekspor siap dipakai.

Kode ini demonstrasi dua daftar kecil, bukan parser dump SQL dan bukan validator seluruh skema. Pada database sebenarnya periksa juga relasi opsional, nilai null, indeks, jumlah per kategori, serta kebijakan penghapusan yang berlaku.

BACAAN LANJUTAN

Rujukan untuk memeriksa konsepnya

Dokumentasi resmi dan standar di bawah membantu pembaca meninjau istilah serta langkah teknis. Tautan ini bukan klaim bahwa setiap contoh dalam artikel telah diuji di semua perangkat atau hosting.

Menemukan langkah yang kurang jelas?

Laporkan bagian artikel yang perlu diperbaiki agar redaksi dapat memeriksa informasi dan sumbernya.

Kirim koreksi ke redaksi