SQL Sorgu Biçimlendirici (SQL Formatter & Beautifier) ve Okunabilirlik Standartları
İlişkisel veritabanı yönetim sistemlerinde (MySQL, MariaDB, PostgreSQL, Microsoft SQL Server / T-SQL, Oracle PL/SQL ve SQLite) ORM araçları (Doctrine, Hibernate, Eloquent, Entity Framework) veya raporlama yazılımları tarafından üretilen karmaşık SQL sorguları genellikle binlerce karakter uzunluğunda tek bir satır halinde loglanır. İç içe geçmiş alt sorgular (Subqueries), çoklu tablo birleştirmeleri (LEFT/INNER JOIN), ortak tablo ifadeleri (CTE - WITH) ve koşullu CASE WHEN blokları içeren bu sorguların tek satırda okunması ve performans/mantık hatasının bulunması neredeyse imkansızdır.
SQL Sorgu Biçimlendirici (SQL Prettifier), ham SQL dizgesini sözcüksel analizden (Lexical Tokenization) geçirerek SQL anahtar kelimelerini, tablo/sütun tanımlayıcılarını, operatörleri ve parantez derinliklerini ayrıştırır ve endüstri standardı girintileme kurallarıyla yeniden yapılandırır.
Profesyonel SQL Yazım ve Biçimlendirme Kuralları (SQL Style Guide)
Simon Holywell ve uluslararası veri mühendisliği topluluklarının benimsediği temiz SQL biçimlendirme ilkeleri şunlardır:
- Anahtar Kelime Büyük Harf Standardı (UPPERCASE Keywords):
SELECT, FROM, INNER JOIN, WHERE, GROUP BY, HAVING, ORDER BY, LIMITgibi ayrılmış SQL komutları büyük harfle, tablo ve sütun adları ise küçük harfle (snake_case) yazılarak görsel ayrım sağlanır. - Ana Yan Cümle Kırılımları (Root Clause Newlines): Her ana sorgu bloğu yeni bir satırdan başlar ve alt koşullar (
AND,OR,ON) 2 veya 4 boşluk içeriden hizalanır. - Alt Sorgu (Subquery) Parantez Hiyerarşisi:
IN (SELECT ...)veyaEXISTS (...)içindeki her parantez katmanı kendi girinti (indentation) seviyesini bir kademe artırır. - Tek Satıra Sıkıştırma (SQL Minify): Uygulama kodunun içine veya ortam değişkenlerine gömülecek sorgulardaki tüm yorumlar (
--ve/* */) ve fazla boşluklar temizlenerek tek satıra indirgenir.
SQL Lehçeleri (Dialects) ve Biçimlendirme Karşılaştırma Tablosu
Farklı veritabanı motorlarında kullanılan tırnak/kaçış işaretleri ve sorgu sınırlama sözdizimi farkları aşağıdaki tabloda özetlenmiştir:
| Veritabanı Motoru (Dialect) | Tablo/Sütun Kaçış İşareti | Satır Sınırlama Komutu | Metin Birleştirme Operatörü |
|---|---|---|---|
| MySQL / MariaDB | Backtick (`tablo_adi`) |
LIMIT 10 OFFSET 20 |
CONCAT(a, b) |
| PostgreSQL | Çift Tırnak ("tablo_adi") |
LIMIT 10 OFFSET 20 |
a || b veya CONCAT() |
| MS SQL Server (T-SQL) | Köşeli Parantez ([tablo_adi]) |
SELECT TOP 10 ... / OFFSET FETCH |
a + b veya CONCAT() |
| Oracle (PL/SQL) | Çift Tırnak ("TABLO_ADI") |
FETCH FIRST 10 ROWS ONLY |
a || b |
Somut Örnek Dönüşüm Senaryosu
Ham ve Karmaşık Tek Satır Sorgu Girdisi:
select u.id, u.ad_soyad, count(s.id) as siparis_sayisi, sum(s.toplam_tutar) as ciro from kullanicilar u inner join siparisler s on s.kullanici_id = u.id where u.durum = 1 and s.tarih >= '2026-01-01' group by u.id, u.ad_soyad having sum(s.toplam_tutar) > 5000 order by ciro desc limit 25;
Biçimlendirme Sonrası Yapısal Çıktı: Sorgu biçimlendirici çalıştırıldığında SELECT altındaki 4 sütun alt alta hizalanır; FROM, INNER JOIN ... ON, WHERE ... AND, GROUP BY, HAVING, ORDER BY ve LIMIT blokları büyük harfe çevrilip kendi satırlarına ayrılarak sorgunun mantıksal akışı tek bakışta okunabilir hale gelir.
Sık Yapılan Hatalar ve Uzman İpuçları
- String İçindeki Kelimelerin Bozulmaması: Basit bir metin değiştirici
WHERE aciklama = 'select paketi'sorgusundaki tırnak içi'select'kelimesini de büyütüp veriyi bozabilir. Sözcüksel (Lexer tabanlı) biçimlendiricimiz tek ve çift tırnak içindeki sabit metinlere (String Literals) kesinlikle dokunmaz. - Tek Satır Yorum (
--) Sonrası Minify Tuzağı: İçinde-- yorumbulunan bir sorguyu yorumları silmeden tek satıra (Minify) çevirirseniz,--işaretinden sonra gelen tümWHEREkoşulu yorum satırına dönüşüp devre dışı kalır! Bu nedenle sıkıştırma modunda önce yorum satırları güvenle temizlenir.