SQL biçimlendirici/güzelleştirici

SQL biçimlendirici/güzelleştirici, SQL kodunu daha okunaklı ve tutarlı bir düzende yeniden sunan ücretsiz bir araçtır.

SQL biçimlendirme neleri değiştirir?

SQL biçimlendirme, sorgunun yan tümcelerini, ifadelerini ve iç içe geçmiş yapılarını daha kolay takip edilecek şekilde düzenler. Genellikle SELECT listeleri, JOIN yan tümceleri, WHERE koşulları, alt sorgular ve CASE ifadeleri gibi öğelere satır sonları ve girintiler ekler.

Biçimlendirme, sorgunun amaçlanan sonucunu değiştirmemelidir. Ancak SQL lehçeleri birbirinden farklıdır ve yalnızca biçimlendirmeye bakarak bir ifadenin anlamını koruduğu kanıtlanamaz. Oluşturulan SQL'i üretim verileri üzerinde çalıştırmadan önce gözden geçir. Özellikle sağlayıcıya özgü operatörler, yordamsal uzantılar veya alışılmadık tırnak içine alma kuralları kullanılıyorsa daha dikkatli ol.

Biçimlendirici; başkalarının yazdığı sorguları okurken, oluşturulmuş SQL'i incelerken, uzun bir ifadede hata ayıklarken veya kodu bir pull request için hazırlarken kullanışlıdır. Tutarlı düzen, ilgisiz boşluk farklarını azalttığı için değişiklikleri karşılaştırmayı da kolaylaştırır.

SQL biçimlendirici nasıl kullanılır?

İfadeyi SQL alanına yapıştır veya yaz, ardından biçimlendirilmiş sürümü Beautified SQL alanında görmek için gönder. Girdi, işlenmek üzere HTTPS üzerinden sunucuya iletilir ve saklanmaz.

1. Koruman gereken ortak tablo ifadeleri dahil olmak üzere ifadenin tamamını kopyala. Sonuçtaki yorumları ve varsa sondaki noktalı virgülü kontrol et.
2. Mümkünse birbirinden kopuk parçaları biçimlendirmek yerine ifadenin tamamını SQL alanına gir.
3. Sonucu Beautified SQL alanında incele. İç içe geçmiş ifadelere ve kullanılan SQL lehçesine özgü söz dizimine özellikle dikkat et.
4. Biçimlendirilmiş ifadeyi kullanıma almadan önce uygun bir geliştirme veya hazırlık ortamında çalıştır.

Hassas veritabanı işlemlerinde sorgu metnini sunucu tabanlı herhangi bir araca göndermeden önce kuruluşunun politikasını kontrol et. Sorguyu anlamak için gerekmiyorsa parolaları, erişim belirteçlerini, kişisel verileri ve gizli sabit değerleri kaldır.

Güzelleştirilmiş SQL nasıl okunmalı?

Sonucu okurken yeni düzeni ifadenin geçerli olduğunun kanıtı olarak görme. Bunun yerine girintileri ve yan tümce sınırlarını takip et. Üst düzey SELECT, FROM, WHERE, GROUP BY ve ORDER BY bölümlerinin her biri ayrı bir satıra veya girinti düzeyine yerleştirildiğinde bunları ayırt etmek genellikle kolaylaşır.

• Girintili alt sorgular, iç sorgudan elde edilen sonucun dış ifade tarafından nerede kullanıldığını gösterir.
• Hizalanmış koşullar, AND ile OR arasındaki önceliği incelemeyi kolaylaştırır. Bununla birlikte, varsayılan olarak AND, OR'dan önce değerlendirilir ve mantıksal gruplamayı yine parantezler belirler.
• Ayrı JOIN yan tümceleri, her ON koşulunun hangi tabloya ait olduğunu görmeye yardımcı olur.
• Genişletilmiş SELECT listeleri, eksik virgüllerin, yinelenen sütunların ve belirsiz takma adların fark edilmesini kolaylaştırır.
• Açıkça görülen CASE dalları, inceleme yapanların WHEN, THEN, ELSE ve END anahtar kelimelerini eşleştirmesine yardımcı olur.

Tırnak içindeki dizeler, sayılar, noktalama işaretleri ve yorumlar SQL'de anlam taşır. Bu nedenle bunların yalnızca görünümle ilgili olduğunu varsayma, tek tek incele. Aksanlı veya Latin alfabesi dışındaki karakterler, veritabanına ve kullanılan karakter kodlamasına bağlı olarak dize sabitlerinde ve tırnak içine alınmış tanımlayıcılarda geçerli olabilir.

Küçük biçimlendirme örnekleri

Şu sıkıştırılmış girdiyi ele alalım.

Girdi: SELECT id,name FROM customers WHERE active=1 ORDER BY name;

Okunaklı bir biçimlendirilmiş sürüm şöyle sunulabilir.

Çıktı: SELECT id, name

FROM customers

WHERE active = 1

ORDER BY name;

JOIN içeren bir sorguda girintinin yararı daha belirgin olur.

Girdi: SELECT o.id,c.name FROM orders o JOIN customers c ON c.id=o.customer_id WHERE o.total>100;

Okunaklı bir çıktıda SELECT, FROM, JOIN, ON ve WHERE ayrı satırlara yerleştirilebilir; o.total > 100 karşılaştırması ise korunur. Büyük-küçük harf kullanımı, boşluklar ve satır yerleşimi biçimlendirme kurallarına göre değişebilir. Bu nedenle örnekleri, garanti edilen sabit bir yazım standardı olarak değil, olası düzenler olarak değerlendir.

Biçimlendirme SQL hatalarını bulabilir mi?

Hayır. SQL'i güzelleştirmek, onu bir veritabanı ayrıştırıcısıyla doğrulamakla aynı şey değildir. Bu aracın belirtilen çıktısı biçimlendirilmiş SQL'dir. Dolayısıyla araç bir söz dizimi denetleyicisi, şema denetleyicisi veya yürütme planlayıcısı olarak görülmemelidir.

Yine de daha açık bir düzen, inceleme sırasında olası hataları görünür hâle getirebilir. SELECT listesindeki eksik virgül, eşleşmeyen parantezler, kapatılmamış tırnaklı bir dize, amaçlanan koşulu bulunmayan bir JOIN veya yanlış gruplanmış AND ya da OR ifadesi bunlara örnektir. Ayrıca tırnak içine alınmadan tanımlayıcı olarak kullanılan ayrılmış bir kelimenin fark edilmesini de kolaylaştırabilir.

Bazı sorunlar hedef veritabanı olmadan kesin olarak belirlenemez. PostgreSQL tarafından kabul edilen bir ifadenin Microsoft SQL Server, MySQL, Oracle Database veya SQLite için değiştirilmesi gerekebilir. Eksik tabloların, bilinmeyen sütunların, uyumsuz veri türlerinin ve izin hatalarının teşhisi genellikle veritabanı motorunu veya kullanılan lehçeyi tanıyan bir geliştirme aracını gerektirir.

SQL'i biçimlendirmek hangi durumlarda gereksizdir?

SQL zaten tutarlı biçimde düzenlenmişse veya yalnızca bir makine tarafından kullanılacaksa biçimlendirme genellikle gereksizdir. Otomatik oluşturulan sorguları yeniden biçimlendirmek, onları üreten sistemi iyileştirmeden kaynak kontrolünde gereksiz ve kalabalık değişikliklere yol açabilir.

Şu durumlarda da biçimlendirme doğru adım olmayabilir:

• Bir geçiş dosyası imzalanmış, sağlama toplamı alınmış veya başka bir yöntemle bayt bayt karşılaştırılıyor.
• Küçültülmüş ya da sıkıştırılmış bir sorgu, boyuta duyarlı bir yapıya gömülü ve kimsenin sorguyu incelemesi gerekmiyor.
• Asıl amaç okunabilirlik değil; doğrulama, yürütme planı analizi veya performans ayarı.
• Sorgu, kuruluş politikasının sunucu tabanlı bir hizmete gönderilmesine izin vermediği gizli değerler içeriyor.

Depodaki tüm dosyalarda tekrarlanabilir biçimlendirme yapmak için kullanılan SQL lehçesini tanıyan bir komut satırı biçimlendiricisi daha uygun olabilir. Böylece yapılandırması da kodla birlikte depoya kaydedilebilir. SQL içeren yapılandırılmış API yüklerinde, çevredeki JSON verisini incelemek için JSON doğrulayıcı & güzelleştirici kullanılabilir. Ancak SQL'in yine SQL'e özel bir araçla işlenmesi gerekir.

Sıkça sorulan sorular

SQL'i biçimlendirmek NULL davranışını değiştirir mi?

Boşluklar ve girintiler, SQL'in üç değerli mantığını veya NULL davranışını değiştirmez. Yine de genellikle IS NULL kullanılması gereken column = NULL gibi ifadeleri kontrol et. Biçimlendirici bu anlamsal hatayı düzeltmez.

Birden fazla SQL ifadesini aynı anda biçimlendirebilir miyim?

Birden fazla SQL ifadesini aynı anda biçimlendirme desteği belgelenmemiştir. Her ifadeyi ayrı ayrı biçimlendir.

Girdide yorum bırakmak güvenli mi?

Çalıştırılabilir SQL hassas sabit değerler içermese bile yorumlarda destek kaydı referansları, dahili ana makine adları, müşteri bilgileri veya operasyon notları bulunabilir. Metni sunucuya göndermeden önce hem satır yorumlarını hem de blok yorumlarını gözden geçir.

SQL anahtar kelimeleri büyük mü yoksa küçük harfle mi yazılmalı?

Birçok veritabanı motoru tırnak içine alınmamış anahtar kelimelerde büyük-küçük harf ayrımı yapmadığından iki yazım biçimi de genellikle kabul edilir. Deponun kullandığı kurala uy. Bazı veritabanları tırnak içine alınmış tanımlayıcıların harf biçimini koruduğu veya bunlarda büyük-küçük harf ayrımı yaptığı için dikkatli ol.

Biçimlendirilmiş sorguyu çalıştırmadan önce neleri kontrol etmeliyim?

Hedef veritabanının SQL lehçesini doğrula, WHERE ve JOIN koşullarını incele, ayrıca UPDATE, DELETE ve şema değiştiren ifadelerin işlem sınırlarını kontrol et. Riskli sorguları önce bir geliştirme veya hazırlık veritabanında, tercihen temsili veriler ve uygun yedeklerle çalıştır.