Format SQL

Sebelum dan sesudah

Sebelumnya:

SELECT u.id,u.name,COUNT(o.id) AS orders FROM users u LEFT JOIN orders o ON o.user_id=u.id WHERE u.created_at>='2024-01-01' GROUP BY u.id,u.name HAVING COUNT(o.id)>5 ORDER BY orders DESC LIMIT 50;

Setelah (koma utama, kata kunci dalam huruf kapital, penjelajaran dua spasi):

SELECT
    u.id
  , u.name
  , COUNT(o.id) AS orders
FROM users u
LEFT JOIN orders o
  ON o.user_id = u.id
WHERE u.created_at >= '2024-01-01'
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 5
ORDER BY orders DESC
LIMIT 50;

Pilihan gaya yang penting

• Kata kunci huruf besar versus huruf kecil. Huruf besar merupakan pilihan tradisional yang mudah dipindai secara visual; sedangkan huruf kecil terlihat lebih rapi dalam editor kode modern yang menyediakan penyorotan sintaksis.
• Koma awal vs koma akhir: Koma awal ( , col) memudahkan penambahan komentar pada satu kolom saja, sedangkan koma akhir (col,) terasa lebih alami dalam teks.
• Penempatan koma dalam GROUP BY: Umumnya satu koma per baris untuk klausa panjang, dan koma disisipkan langsung ke dalam teks untuk klausa pendek.
• Indentasi JOIN: menempatkan ON pada baris berikutnya (indentasi menggantung) dibandingkan pada baris yang sama. Kondisi yang panjang lebih cocok dengan indentasi menggantung.
• Subquery: Ketik seluruh isi subquery secara lengkap, bukan hanya bagian awal yang ditandai dengan tanda kurung.

Perangkap khas dialek

• Tanda backtick MySQL dibandingkan dengan tanda kutip ganda PostgreSQL untuk pengidentifikasi.
• WITH CTEs, MS SQL memiliki persyaratan ; sebelum WITH; pemformat mengelolanya.
• Fungsi jendela: Klausa panjang OVER (...) mendapat manfaat dari penulisan PARTITION BY dan ORDER BY yang dipecah ke beberapa baris.
• BigQuery memiliki ARRAY_AGG, STRUCT, serta sufiks nama tabel (*_yyyymmdd) yang tidak boleh dirusak oleh tokenizer.
• Oracle menggunakan sintaks join eksternal (+); pemformat mempertahankannya namun menandainya sebagai sintaks lama.

Apa yang tidak dilakukan oleh pemformat

• Perbaiki bug: kombinasi JOIN yang tidak valid tetap tidak valid.
• Ekspansi SELECT *, daftar kolom tidak ditentukan berdasarkan skema.
• Optimalkan kueri, hanya untuk tata letak, bukan untuk rencana eksekusi.
• Tulis ulang subquery menjadi CTE: ini merupakan persoalan yang berbeda.