यह पृष्ठ Dev Tools Suite में SQL को फ़ॉर्मेट और minify करने की प्रामाणिक गाइड है। पढ़ते समय ऊपर का SQL Formatter उपयोग करें या नीचे किसी अनुभाग पर जाएँ। सारा पार्सिंग और फ़ॉर्मेटिंग ब्राउज़र में sql-formatter से चलता है — क्वेरी, स्कीमा नाम और नमूना डेटा कभी सर्वर पर नहीं जाते।

SQL Formatter मनुष्यों के लिए बहु-पंक्ति SQL को beautify करता है और परिवहन के लिए minify करता है। यह स्वचालित रूप से कीवर्ड बड़े अक्षरों में करता है (SELECT, FROM, WHERE), खंड-जागरूक इंडेंट लगाता है, और sql-formatter लाइब्रेरी की बोली-विशिष्ट व्याकरण का पालन करता है — वही इंजन जो कई IDE एक्सटेंशन और CLI फ़ॉर्मेटर उपयोग करते हैं।

आपको क्या मिलता है

• सममित दोहरा-पैन वर्कस्पेस: बाएँ SQL इनपुट, दाएँ फ़ॉर्मेट या minify आउटपुट
• 13 बोली पार्सर: कोर रिलेशनल, क्लाउड वेयरहाउस, बिग डेटा, एंटरप्राइज़
• Beautify और Minify मोड, लाइव ऑटो-फ़ॉर्मेट (डिबाउंस) और स्पष्ट Process बटन
• पैनल हेडर में बोली चयनकर्ता और Strip comments — अतिरिक्त पंक्ति नहीं
• बड़े SELECT ट्री के लिए संकुचित फ़ॉर्मेट आउटपुट (Beautify)
• बोली पार्सर इनपुट न पढ़ पाए तो पंक्ति/स्तंभ संकेत के साथ पार्स त्रुटि
• वैकल्पिक URL साझाकरण: ?mode=minify&dialect=postgresql मोड और बोली रखता है

इस टूल का उपयोग कब करें

• लॉग, BI या ORM से ad-hoc SQL चिपकाया और समीक्षा से पहले पठनीय इंडेंट चाहिए
• ऐप कोड में SQL एम्बेड करना है और एक-पंक्ति minify स्ट्रिंग चाहिए
• PostgreSQL, Snowflake, BigQuery, Spark या Oracle पर बोली कीवर्ड पहचान चाहिए
• कमिट या शिप से पहले ब्लॉक और लाइन टिप्पणियाँ हटानी हैं

क्या न अपेक्षा करें

• सिमेंटिक मान्यता — फ़ॉर्मेट सफलता का मतलब सर्वर पर चलना नहीं
• स्वचालित क्वेरी प्लानिंग, प्रदर्शन lint या स्कीमा-जागरूक रीराइट
• चुनी बोली द्वारा न कवर हर विदेशी विस्तार का पूर्ण संरक्षण
• सर्वर-साइड EXPLAIN या निष्पादन — केवल लेआउट और व्हाइटस्पेस टूल

नियंत्रण SQL QUERY पैनल हेडर में हैं ताकि इनपुट और आउटपुट एडिटर समान ऊँचाई रखें। टूलबार के नीचे अलग विकल्प पंक्ति नहीं।

कीबोर्ड शॉर्टकट

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — वर्कस्पेस साफ़ करें

हमेशा वह बोली चुनें जहाँ क्वेरी चलेगी। पार्सर प्रति बोली अलग कीवर्ड सूची, फ़ंक्शन नाम और टिप्पणी नियम उपयोग करता है। सामान्य ANSI स्निपेट के लिए Standard SQL सुरक्षित डिफ़ॉल्ट है।

Cassandra CQL समर्थित नहीं — sql-formatter बोली सेट का हिस्सा नहीं। Cassandra के लिए CQL-विशिष्ट फ़ॉर्मेटर उपयोग करें।

Beautify और Minify एक ही बोली चयनकर्ता और Strip comments साझा करते हैं पर अलग आउटपुट आकार देते हैं।

उदाहरण

इनपुट: select id, name from users where active = 1 — Beautify इंडेंटेड पंक्तियाँ SELECT/FROM/WHERE बड़े अक्षरों में देता है। Strip बंद Minify एक पंक्ति: select id, name from users where active = 1।

1. साइडबार Formatters से SQL Formatter खोलें।
2. बाएँ एडिटर में SQL चिपकाएँ, सत्र टूलबार से .sql अपलोड करें, या खाली स्थिति पर फ़ाइल खींचें।
3. अपने DB से मेल खाती बोली चुनें (जैसे Snowflake वर्कशीट के लिए snowflake)।
4. यदि -- या /* */ टिप्पणियाँ आउटपुट में न चाहिए तो Strip comments चेक करें।
5. पठनीय SQL के लिए Beautify, कॉम्पैक्ट एक पंक्ति के लिए Minify।
6. दाएँ आउटपुट देखें। पार्स त्रुटि बैनर ठीक करें — संपादन के बाद बंद करने क्लिक करें।
7. कॉपी, डाउनलोड, या आउटपुट वापस इनपुट में स्वैप करके फिर चलाएँ।
8. सहकर्मियों के लिए ?dialect=bigquery&mode=minify लिंक साझा करें।

Flyway, Liquibase और ORM माइग्रेशन फ़ाइलें तब आसानी से समीक्षा होती हैं जब SELECT सूची, JOIN और WHERE सुसंगत पंक्तियों पर टूटें।

कार्यप्रवाह

1. माइग्रेशन लक्ष्य के अनुसार postgresql, transactsql, mysql या sqlite सेट करें।
2. जनरेटेड diff या ORM आउटपुट से कच्चा माइग्रेशन SQL चिपकाएँ।
3. यदि इनलाइन टिप्पणियाँ इरादा दर्शाती हैं तो Strip बंद पर Beautify।
4. PR से पहले फ़ॉर्मेट SQL माइग्रेशन फ़ाइल में वापस कॉपी करें।

सुझाव

फ़ॉर्मेटिंग लाइव स्कीमा के विरुद्ध मान्य नहीं करती। सौंदर्य परिवर्तन के बाद स्टेजिंग DB पर माइग्रेशन चलाएँ।

एनालिटिक्स इंजीनियर अक्सर Snowflake, BigQuery या Redshift कंसोल से असंगत केस और संकुचित पंक्तियों वाला SQL कॉपी करते हैं।

Snowflake / BigQuery / Redshift

• वेयरहाउस फ़ंक्शन सही पार्स हों इसलिए Beautify से पहले snowflake, bigquery या redshift चुनें।
• -- सत्र नोट वाले नोटबुक से निर्यात पर Strip comments उपयोग करें।
• बहुत चौड़ी SELECT सूची पर Beautify के बाद Expand all / Collapse all उपयोग करें।

Spark / Trino / Hive

• Databricks नोटबुक और Spark SQL पाइपलाइन के लिए spark।
• कैटलॉग में Presto-संगत संघीय क्वेरी के लिए trino।
• विरासत HiveQL के लिए hive — कवरेज sql-formatter Hive नियमों का पालन करती है।

ऐप कोड अक्सर SQL को टेम्पलेट स्ट्रिंग के रूप में रखता है। Minify JavaScript, Python या Go में एक पंक्ति के लिए बाइट और एस्केप कम करता है।

1. पठनीय SQL संस्करण इनपुट पैनल में चिपकाएँ।
2. यदि डेवलपर्स ने डिबग नोट छोड़े हैं तो Strip comments सक्षम करें।
3. Minify मोड पर स्विच करें।
4. एक-पंक्ति आउटपुट स्ट्रिंग लिटरल में कॉपी करें (भाषा में उद्धरण एस्केप ध्यान दें)।

स्रोत में पठनीय पर रनटाइम में कॉम्पैक्ट चाहिए तो beautify संस्करण दस्तावेज़ में रखें, केवल बिल्ड आर्टिफ़ैक्ट minify करें।

समीक्षा से पहले SQL सामान्यीकृत करें ताकि diff तर्क पर केंद्रित हो, व्हाइटस्पेस शोर पर नहीं।

• जब सहकर्मी टिकट में एक-पंक्ति SQL चिपकाए तो तुलना के दोनों पक्ष beautify करें।
• सुसंगत शैली के लिए बड़े कीवर्ड — Beautify में स्वचालित।
• दो संस्करण फ़ॉर्मेट के बाद अर्थपूर्ण क्वेरी diff के लिए Text Diff में पाइप करें।

Strip comments Beautify और Minify दोनों पर लागू होता है। सक्षम होने पर उपकरण फ़ॉर्मेट से पहले टिप्पणियाँ हटाता है जहाँ बोली-जागरूक नियम लागू हैं।

जब Strip बंद (Minify)

Minify अभी भी एक पंक्ति में व्हाइटस्पेस संकुचित करता है पर टिप्पणी पाठ रखता है। जब टिप्पणियाँ क्वेरी के साथ जानी चाहिए तब उपयोग करें।

पार्सर विफल होने पर लाल बैनर Parse error पंक्ति और स्तंभ संख्या दिखाता है। उपलब्ध हो तो इनपुट एडिटर त्रुटि पंक्ति हाइलाइट करता है।

सामान्य सुधार

1. गलत बोली — वास्तविक इंजन पर स्विच करें (जैसे Oracle पैकेज के लिए plsql, Standard SQL नहीं)।
2. बंद न हुई स्ट्रिंग या कोष्ठक — रिपोर्ट पंक्ति के पास उद्धरण और कोष्ठक संतुलित करें।
3. ट्रेलिंग कॉमा या अधूरा खंड — SELECT सूची और CTE पूरे करें।
4. गैर-SQL चिपकाया — क्वेरी के चारों ओर shell या JSON रैपर हटाएँ।
5. सामान्य मोड में बोली-विशिष्ट सिंटैक्स — विक्रेता बोली आज़माएँ या असमर्थित विस्तार सरल करें।

यदि वैध क्वेरी फिर विफल हो तो sql-formatter पार्सर उस संस्करण को कवर न कर सकता। अपस्ट्रीम रिपोर्ट करें या सरल उपसमुच्चय मैन्युअल फ़ॉर्मेट करें।

SQL Formatter 100% आपके ब्राउज़र में चलता है। sql-formatter लाइब्रेरी गतिशील लोड होती है; मुख्य थ्रेड JavaScript में फ़ॉर्मेटिंग।

• कोई क्वेरी टेक्स्ट Dev Tools Suite सर्वर को नहीं भेजा जाता
• इनपुट, आउटपुट, बोली और Strip comments प्राथमिकता localStorage में रह सकती है
• URL क्वेरी (?dialect=, ?mode=) केवल सेटिंग दर्शाती है — SQL बॉडी नहीं
• प्रोडक्शन डेटा या PII के बाद वर्कस्पेस साफ़ करें (Ctrl/Cmd+L)

• Beautify से पहले बोली निष्पादन वातावरण से मिलाएँ — फ़ॉर्मेट सफलता ≠ रनटाइम सफलता
• मनुष्यों के लिए Beautify, मशीनों के लिए Minify
• व्यापार नियम टिप्पणियों में हों तो Strip बंद; निर्यात और एम्बेड के लिए चालू
• डॉलर-उद्धृत स्ट्रिंग या विदेशी लिटरल पर minify आउटपुट स्टेजिंग पर सत्यापित करें
• बड़े स्क्रिप्ट के लिए चैट ऐप में चिपकाने के बजाय सत्र इतिहास और फ़ाइल अपलोड
• एक ही रिपोर्ट क्वेरी के दो फ़ॉर्मेट संस्करण तुलना पर Text Diff संयोजन