Cara memformat kueri SQL

SQL yang berantakan adalah salah satu cara tercepat untuk memperkenalkan bug. Ketika kueri berada pada satu baris panjang tanpa indentasi, sulit untuk melihat kondisi mana yang berlaku untuk join mana, di mana subkueri dimulai dan berakhir, atau apakah logikanya benar.

Mengapa pemformatan penting

• Debugging — kueri yang diformat dengan baik membuat kesalahan logika terlihat. Anda dapat mengikuti aliran dari SELECT ke WHERE lalu ke JOIN tanpa menebak.
• Tinjauan kode — peninjau membaca SQL yang diformat dalam hitungan detik. Kueri satu baris memaksa mereka untuk menganalisisnya secara mental terlebih dahulu.
• Pemeliharaan — ketika Anda kembali ke kueri berbulan-bulan kemudian, pemformatan memberi tahu Anda apa yang dilakukannya sekilas.
• Kolaborasi — pemformatan yang konsisten dalam tim berarti semua orang membaca SQL dengan cara yang sama.

Cara memformat SQL

1. Tempel SQL Anda — masukkan kueri yang diperkecil atau berantakan ke pemformat. Menangani SELECT, INSERT, UPDATE, DELETE, CREATE TABLE, serta kueri kompleks dengan subkueri dan join.
2. Konfigurasikan opsi — pilih ukuran indentasi dan apakah kata kunci harus dalam huruf besar. Pengaturan ini sesuai dengan panduan gaya proyek Anda.
3. Salin hasilnya — SQL yang diformat siap untuk ditempel kembali ke editor, klien basis data, atau dokumentasi Anda.

Seperti apa pemformatan yang baik

Kueri seperti select u.name, o.total from users u join orders o on u.id = o.user_id where o.total > 100 and u.active = 1 order by o.total desc menjadi:

SELECT
  u.name,
  o.total
FROM users u
JOIN orders o
  ON u.id = o.user_id
WHERE o.total > 100
  AND u.active = 1
ORDER BY o.total DESC

Setiap klausa dimulai pada barisnya sendiri. Kondisi diindentasi di bawah klausa induknya. Join dan kondisi ON-nya dipasangkan dengan jelas.

Tips

• Format sebelum melakukan commit — jalankan SQL Anda melalui pemformat sebelum menambahkannya ke kontrol versi. Ini menjaga diff tetap bersih dan memfokuskan tinjauan pada logika, bukan gaya.
• Gunakan kapitalisasi kata kunci yang konsisten — pilih huruf besar atau huruf kecil dan tetap pada itu di seluruh proyek Anda. Gaya campuran membuat kueri sulit dibaca.
• Pisahkan kueri yang kompleks — jika kueri tetap sulit dibaca bahkan setelah diformat, pisahkan menjadi CTE (Common Table Expressions) atau view. Pemformatan tidak dapat memperbaiki logika yang secara fundamental kompleks.
• Periksa penyorotan sintaks — pemformat yang baik menyediakan penyorotan yang membedakan kata kunci, string, dan angka, yang membantu menemukan kesalahan ketik.