Tool overview
SQL Biçimlendirici nedir?
SQL Biçimlendirici, anahtar kelime büyük/küçük harfiyle SQL sorgularını biçimlendirin, güzelleştirin ve küçültün yardımcı olan bir araçtır.
Neden SQL Biçimlendirici kullanmalısınız?
anahtar kelime büyük/küçük harfiyle SQL sorgularını biçimlendirin, güzelleştirin ve küçültün ihtiyacınız olduğunda okunabilirliği ve hızı artırır; veriler sunucuya gönderilmez.
Temel özellikler
İstemci tarafı gizlilik, anında sonuç ve tek tıkla kopyalama. Anahtar kelime büyük/küçük harfiyle SQL sorgularını biçimlendirin, güzelleştirin ve küçültün
Nasıl kullanılır
Yukarıdaki araçtan doğru sonuçlar almak için bu adımları izleyin.
- SQL'i sol panele yapıştırın, .sql yükleyin veya boş duruma sürükleyin.
- Başlık açılır menüsünden lehçe seçin (13 seçenek: Postgres, Snowflake, BigQuery, Spark, Oracle PL/SQL vb.).
- Çıktıdan önce -- ve /* */ kaldırmak için Strip comments'i işaretleyin; girintili SQL için Beautify, tek satır için Minify.
- Biçimlendirilmiş SQL'i migrasyonlara, ORM'lere, ambar çalışma sayfalarına, gömülü dizelere veya belgelere kopyalayın.
SQL Formatter referansı
Lehçe listesi, çalışma alanı denetimleri, Beautify vs Minify davranışı, kullanım senaryoları ve yorum kaldırma kuralları.
SQL Formatter kılavuzu — buradan başlayın
Bu sayfa Dev Tools Suite'te SQL biçimlendirme ve minify için kanonik kılavuzdur. Okurken yukarıdaki etkileşimli SQL Formatter'ı kullanın veya aşağıdaki bölüme atlayın. Tüm ayrıştırma ve biçimlendirme tarayıcıda sql-formatter ile çalışır — sorgular, şema adları ve örnek veriler asla sunucuya yüklenmez.
SQL Formatter ne yapar
SQL Formatter çok satırlı SQL'i insanlar için güzelleştirir, taşıma için minify eder. Anahtar kelimeleri otomatik büyük harfe çevirir (SELECT, FROM, WHERE), cümle bilinçli girinti uygular ve sql-formatter kütüphanesinin lehçe dil bilgisine uyar — birçok IDE eklentisi ve CLI biçimlendiricisiyle aynı motor.
Ne elde edersiniz
- Simetrik çift bölmeli alan: solda SQL sorgusu, sağda biçimlendirilmiş veya minify çıktı
- Çekirdek ilişkisel, bulut ambarları, büyük veri ve kurumsal gruplu 13 lehçe ayrıştırıcı
- Beautify ve Minify modları, canlı otomatik biçim (debounce) ve açık Process düğmesi
- Panel başlığında lehçe seçici ve Strip comments — ekstra satır yok
- Büyük SELECT ağaçları için katlanabilir çıktı (Beautify)
- Lehçe ayrıştırıcı okuyamadığında satır/sütun ipuçlu ayrıştırma hataları
- İsteğe bağlı URL: ?mode=minify&dialect=postgresql mod ve lehçeyi korur
Bu aracı şu durumlarda kullanın
- Log, BI veya ORM'den ad-hoc SQL yapıştırıp incelemeden önce okunabilir girinti gerekiyor
- Uygulama koduna SQL gömüp tek satırlık minify dize istiyorsunuz
- PostgreSQL, Snowflake, BigQuery, Spark veya Oracle'da lehçe anahtar kelimelerinin tanınması gerekiyor
- Commit veya gönderimden önce blok ve satır yorumlarını kaldırmak istiyorsunuz
Beklemeyin
- Anlamsal doğrulama — biçimlendirme başarısı sunucuda çalışmayı garanti etmez
- Otomatik sorgu planlama, performans lint veya şema bilinçli yeniden yazım
- Seçilen lehçenin kapsamadığı her egzotik uzantının mükemmel korunması
- Sunucu tarafı EXPLAIN veya yürütme — yalnızca düzen ve boşluk aracı
Çalışma alanı düzeni ve başlık denetimleri
Denetimler SQL QUERY panel başlığındadır; giriş ve çıkış düzenleyicileri aynı yükseklikte kalır. Araç çubuğu altında ayrı seçenek satırı yoktur.
Başlık denetimleri (sol panel)
| Denetim | Konum | İşlev |
|---|---|---|
| Dialect dropdown | Başlık, mod sekmelerinin solunda | sql-formatter dil ayrıştırıcısını seçer (çekirdek, bulut, büyük veri, kurumsal) |
| Strip comments | Başlık onay kutusu | İşaretliyse Beautify veya Minify öncesi --, /* */ ve lehçe yorumlarını kaldırır |
| Beautify / Minify | Başlık mod sekmeleri | Beautify girinti ve büyük anahtar kelimeler; Minify boşlukları daraltır |
| Process | Başlık birincil düğme | Hemen yeniden biçimlendirir (Ctrl/Cmd+Enter da). Giriş veya seçenek değişince ~350ms sonra otomatik |
| Swap | Orta ayırıcı | Çıktıyı girişe taşır ve geçerli modla yeniden işler |
Klavye kısayolları
- Ctrl/Cmd+Enter — Process
- Ctrl/Cmd+L — Çalışma alanını temizle
Desteklenen SQL lehçeleri (13 ayrıştırıcı)
Her zaman sorgunun çalışacağı ortamla eşleşen lehçeyi seçin. Ayrıştırıcı lehçe başına farklı anahtar kelime listeleri, işlev adları ve yorum kuralları kullanır. Genel ANSI parçaları için Standard SQL güvenli varsayılandır.
Desteklenen lehçeler
| Grup | Lehçe | sql-formatter id | Tipik kullanım |
|---|---|---|---|
| Çekirdek | Standard SQL | sql | Genel ANSI sorguları |
| Çekirdek | PostgreSQL | postgresql | Postgres, Supabase, Cockroach (yakl.) |
| Çekirdek | T-SQL / SQL Server | transactsql | Microsoft SQL Server, Azure SQL |
| Çekirdek | MySQL / MariaDB | mysql | MySQL, MariaDB (# yorumlar) |
| Çekirdek | SQLite | sqlite | SQLite, mobil/yerel DB |
| Bulut | Snowflake | snowflake | Snowflake çalışma sayfaları, Snowflake üzerinde dbt |
| Bulut | Google BigQuery | bigquery | BigQuery konsolu, zamanlanmış sorgular |
| Bulut | Amazon Redshift | redshift | Redshift, Postgres uyumlu ambar SQL |
| Büyük veri | Spark SQL | spark | Databricks, Spark SQL defterleri |
| Büyük veri | Trino / Presto | trino | Trino, Presto, federatif sorgu motorları |
| Büyük veri | Apache Hive | hive | HiveQL, eski Hadoop |
| Kurumsal | Oracle PL/SQL | plsql | Oracle Database prosedürleri ve SQL*Plus betikleri |
| Kurumsal | IBM DB2 | db2 | Db2 LUW ve kurumsal ambarlar |
Cassandra CQL desteklenmez — sql-formatter lehçe kümesinde yok. Cassandra için CQL özel biçimlendirici kullanın.
Beautify vs Minify — hangi mod
Beautify ve Minify aynı lehçe seçicisi ve Strip comments'i paylaşır ancak farklı çıktı şekilleri üretir.
Mod karşılaştırması
| Beautify | Minify | |
|---|---|---|
| Çıktı şekli | Çok satır, girintili | Tek satır (boşluk daraltılmış) |
| Anahtar kelimeler | Büyük harf (SELECT, FROM, …) | Yorum kaldırma dışında orijinal büyük/küçük |
| Yorumlar (Strip off) | Biçimlendirmeden önce kaldırılır | Yalnızca boşluk daraltılır |
| Yorumlar (Strip on) | Kaldırılır | Kaldırılır |
| En uygun | Belgeler, migrasyonlar, kod incelemesi | Gömülü dizeler, loglar, yük boyutu |
| Çıktı görünümü | Büyük sorgular için katlanabilir ağaç | Düz metin çıktı |
Örnek
Girdi: select id, name from users where active = 1 — Beautify girintili satırlar ve SELECT/FROM/WHERE büyük harf verir. Strip kapalı Minify tek satır: select id, name from users where active = 1.
Adım adım: tarayıcıda SQL biçimlendirme
- Kenar çubuktan Formatters altında SQL Formatter'ı açın.
- Soldaki düzenleyiciye SQL yapıştırın, oturum araç çubuğundan .sql yükleyin veya boş duruma sürükleyin.
- Veritabanınıza uygun lehçeyi seçin (ör. Snowflake sayfası için snowflake).
- Çıktıda istenmeyen -- veya /* */ varsa Strip comments'i işaretleyin.
- Okunabilir SQL için Beautify, kompakt tek satır için Minify.
- Sağdaki çıktıyı kontrol edin. Ayrıştırma hata başlığını düzeltin — düzenledikten sonra kapatın.
- Kopyalayın, indirin veya çıktıyı girişe takas edip tekrar çalıştırın.
- Aynı ayarlar için ?dialect=bigquery&mode=minify bağlantısını paylaşın.
Kullanım: migrasyon dosyaları ve ORM'ler
Flyway, Liquibase ve ORM migrasyon dosyaları SELECT listeleri, JOIN ve WHERE tutarlı satırlara bölündüğünde daha kolay incelenir.
İş akışı
- Migrasyon hedefine göre postgresql, transactsql, mysql veya sqlite ayarlayın.
- Üretilen diff veya ORM çıktısından ham migrasyon SQL'ini yapıştırın.
- Satır içi yorumlar niyeti belgeliyorsa Strip kapalı Beautify.
- PR öncesi biçimlendirilmiş SQL'i migrasyon dosyasına geri kopyalayın.
İpucu
Biçimlendirme canlı şemayı doğrulamaz. Kozmetik değişikliklerden sonra staging veritabanında migrasyon çalıştırın.
Kullanım: Snowflake, BigQuery ve Spark SQL
Analitik mühendisler sıkça Snowflake, BigQuery veya Redshift konsollarından tutarsız büyük/küçük harf ve sıkışmış satırlı SQL kopyalar.
Snowflake / BigQuery / Redshift
- Ambar işlevlerinin doğru ayrışması için Beautify öncesi snowflake, bigquery veya redshift seçin.
- -- oturum notları olan defterden dışa aktarırken Strip comments kullanın.
- Çok geniş SELECT listelerinde Beautify sonrası Expand all / Collapse all kullanın.
Spark / Trino / Hive
- Databricks defterleri ve Spark SQL için spark.
- Kataloglar arası Presto uyumlu federatif sorgular için trino.
- Eski HiveQL için hive — kapsam sql-formatter Hive kurallarını izler.
Kullanım: gömülü dizeler için SQL minify
Uygulama kodu SQL'i genelde şablon dizesi olarak saklar. Minify JavaScript, Python veya Go'da tek satır için bayt ve kaçış azaltır.
- Okunabilir SQL sürümünü giriş paneline yapıştırın.
- Geliştiriciler hata ayıklama notu bıraktıysa Strip comments'i etkinleştirin.
- Minify moduna geçin.
- Tek satır çıktıyı dize literal'ine kopyalayın (dilde tırnak kaçışına dikkat).
Kaynakta okunabilir, çalışma zamanında kompakt gerekiyorsa beautify sürümünü belgelerde tutun, yalnızca derleme çıktısını minify edin.
Kullanım: PR ve kod incelemesi temizliği
İncelemeden önce SQL'i normalleştirin; diff'ler mantığa odaklansın, boşluk gürültüsüne değil.
- Meslektaş tek satırlık SQL yapıştırdığında karşılaştırmanın her iki tarafını beautify edin.
- Tutarlı stil için büyük anahtar kelimeler — Beautify otomatik uygular.
- İki sürümü biçimlendirdikten sonra anlamsal sorgu diff'i için Text Diff'e aktarın.
Strip comments — lehçeye göre davranış
Strip comments Beautify ve Minify'a uygulanır. Etkinleştirildiğinde, uygulandığı yerlerde lehçe kurallarıyla yorumları biçimlendirmeden önce kaldırır.
Yorum kaldırma davranışı
| Sözdizimi | Strip açıkken işlenir |
|---|---|
| -- satır yorumları | Evet (boşlukla değiştirilir, sonra normalleştirilir) |
| /* blok yorumları */ | Evet |
| MySQL # yorumları | Lehçe mysql iken evet |
| PostgreSQL $$ dolar tırnakları | Korunur — $$…$$ içi yorum sayılmaz |
| Redshift dolar tırnakları | PostgreSQL lehçesiyle aynı koruma |
Strip kapalıyken (Minify)
Minify yine tek satıra boşluk daraltır ancak yorum metnini tutar. Yorumlar sorguyla gitmeli olduğunda kullanın.
Düzeltme: ayrıştırma hataları ve satır ipuçları
Ayrıştırıcı başarısız olunca kırmızı başlık satır ve sütunlu Parse error gösterir. Mümkünse giriş düzenleyicisi hata satırını vurgular.
Yaygın düzeltmeler
- Yanlış lehçe — gerçek motorunuza geçin (Oracle paketleri için plsql, Standard SQL değil).
- Kapanmamış dize veya parantez — bildirilen satır civarında tırnak ve parantezleri dengeleyin.
- Sondaki virgül veya eksik cümle — SELECT listeleri ve CTE'leri tamamlayın.
- SQL olmayan yapıştırma — sorgu etrafındaki shell veya JSON sarmalayıcılarını kaldırın.
- Genel modda lehçeye özel sözdizimi — satıcı lehçesini deneyin veya desteklenmeyen uzantıları sadeleştirin.
Geçerli sorgu hâlâ başarısızsa sql-formatter o sözdizimi varyantını kapsamıyor olabilir. Upstream bildirin veya basitleştirilmiş alt küme elle biçimlendirin.
Gizlilik — sorgular tarayıcınızda kalır
SQL Formatter %100 tarayıcınızda çalışır. sql-formatter kütüphanesi dinamik yüklenir; biçimlendirme ana iş parçacığında JavaScript'te yapılır.
- Sorgu metni Dev Tools Suite sunucularına gönderilmez
- Giriş, çıkış, lehçe ve Strip comments tercihi cihazınızda localStorage'da kalabilir
- URL sorguları (?dialect=, ?mode=) yalnızca ayarları yansıtır — SQL gövdesi içermez
- Üretim verisi veya PII sonrası çalışma alanını temizleyin (Ctrl/Cmd+L)
SQL biçimlendirme en iyi uygulamaları
- Beautify öncesi lehçeyi yürütme ortamıyla eşleştirin — biçim başarısı ≠ çalışma zamanı başarısı
- İnsanlar için Beautify, makineler için Minify
- Yorumlar iş kurallarını belgeliyorsa Strip kapalı; dışa aktarma ve gömme için açık
- Dolar tırnakları veya egzotik literal içeren minify çıktısını staging'de doğrulayın
- Büyük betikler için tırnakları değiştiren sohbet uygulamaları yerine oturum geçmişi ve dosya yükleme
- Aynı rapor sorgusunun iki biçimlendirilmiş sürümünü karşılaştırırken Text Diff ile birleştirin
Sık sorulan sorular
Yaygın hata ayıklama sorunları ve veri gizliliği hakkında genişletilebilir yanıtlar.
İlgili araçlar
Bu aracı tamamlayan diğer ilgili yardımcı programları keşfedin.
Resmi belgeler ve referanslar
Bu yardımcı program için yetkili özellikler ve platform belgeleri.