SQL Sorgu Biçimlendirici (SQL Formatter)

Karmaşık ve tek satırda yazılmış SQL sorgularını girintili, büyük/küçük anahtar kelimeli ve okunabilir standart yapıya kavuşturun.

Metodoloji ve Yerel Veri Güvenliği: Bu geliştirici aracında işlenen kaynak kodlar, şifreleme/hash çıktıları, JSON/SQL verileri ve yapılandırma parametreleri RFC ve W3C standartlarına uygun olarak yerel tarayıcınızda üretilir; dış sunuculara aktarılmaz. Hesaplama standartlarımız için Hakkımızda & Metodoloji ve Kullanım Şartları sayfalarımızı inceleyebilirsiniz.

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, LIMIT gibi 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 ...) veya EXISTS (...) 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 -- yorum bulunan bir sorguyu yorumları silmeden tek satıra (Minify) çevirirseniz, -- işaretinden sonra gelen tüm WHERE koş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.

Sıkça Sorulan Sorular

SQL Sorgu Biçimlendirici (SQL Formatter) hakkında merak edilenler

Hayır. SQL dili boşluklara ve satır sonlarına duyarsızdır (whitespace-insensitive). Biçimlendirme işlemi tırnak içindeki metin verilerine dokunmadan yalnızca komutların girintilerini ve harf büyüklüklerini düzenlediği için sorgu sonucu %100 aynı kalır.
Tümünü Gör →