database SQL Formatlayıcı star

Nasıl Çalışır

Tek satıra yazılmış uzun bir SQL sorgusunda yapıyı takip etmek zordur — WHERE cümleciği nerede bitiyor, GROUP BY nerede başlıyor, hangi JOIN hangi tabloya ait? Bu araç ham SQL'i alır ve her ana cümlecik sınırında ayrı satırlara böler: SELECT, FROM, WHERE, tüm JOIN ailesi (INNER JOIN, LEFT JOIN, RIGHT JOIN…), GROUP BY, ORDER BY, HAVING ve UNION. AND/OR ile zincirlenen koşullar ve ON sonrası birleştirme koşulları, ait oldukları cümleciğin bir seviye altında girintilenir; anahtar kelimeler isteğe bağlı olarak büyük harfe çevrilir. select id,name from users where active=1 and role='admin' order by name gibi bir sorgu, SELECT, FROM, WHERE ve ORDER BY'ın her biri kendi satırında başladığı ve AND koşulunun WHERE'in altında girintilendiği bir bloğa dönüşür — aynı bilgi, yalnızca bir kod incelemesinde elle yazılacağı gibi düzenlenmiş olur.

Bu, tam olarak elle yapılması en zor olduğu yerde işe yarar: birkaç tablonun birleştirildiği sorgular, bir WHERE cümleciğinin içine gömülü bir alt sorgu veya çok dallı bir CASE ifadesi. Tutarlı girintileme, eksik bir birleştirme koşulunu veya yanlış yerleştirilmiş bir parantezi karakter karakter okumak yerine tek bakışta fark etmeyi sağlar.

Bilinmesi Gerekenler

Bu bir formatlayıcıdır, doğrulayıcı değildir — yalnızca tanıdığı belirli bir anahtar kelime kümesinin etrafındaki boşluk ve satır sonlarını yeniden düzenler; sorguyu hiçbir zaman bir söz dizimi ağacına ayrıştırmaz ve bir veritabanına karşı hiç çalıştırmaz. Gerçekten lehçe-farkındalıklı bir doğrulayıcı, her SQL varyantı için tam bir ayrıştırıcı gerektirirdi, çünkü MySQL, PostgreSQL, SQL Server ve SQLite; tanımlayıcı tırnaklama, tarih fonksiyonları, hatta hangi ifadelerin geçerli olduğu gibi ayrıntılarda birbirinden ayrılır — bunların herhangi birini doğruluyormuş gibi yapan sığ bir tarayıcı-içi kontrol yalnızca yanlış bir güven verirdi. Biçimlendirilmiş çıktı tuhaf görünüyorsa bu genellikle girdide zaten bir yazım hatası veya dengesiz bir parantez olduğu anlamına gelir; araç bunu işaretlemek yerine etrafında biçimlendirme yapar.

Yalnızca metin düzeni üzerinde çalıştığı için üretim sorgularında çalıştırmak güvenlidir: tanımlayıcılar, dizgi değerleri, sayısal değerler ve operatörler asla yeniden yazılmaz, eklenmez veya kaldırılmaz — yalnızca boşluk ve isteğe bağlı anahtar kelime büyüklüğü değişir. Hiçbir şey hiçbir yere gönderilmez veya çalıştırılmaz; sorgu tarayıcıdan hiç çıkmaz.

Pratik öneri: biçimlendirilmiş sorguyu sürüm kontrolüne (git) eklemeden önce bir kez daha okuyun — düzen netleştiği için, aksi hâlde tek satırda gizli kalan mantık hataları (yanlış tabloya JOIN, unutulmuş bir WHERE koşulu) bu aşamada çok daha kolay fark edilir.