نکات کلیدی
- 01PostgreSQL، MySQL، SQLite، BigQuery و SQL استاندارد را با کلیدواژههای آگاه لهجه پشتیبانی میکند.
- 02مورد کلیدواژه (بزرگ، کوچک یا حفظ) و تورفتگی (2 فضا، 4 فضا یا برگ) را انتخاب کنید.
- 03کاملاً در مرورگر شما اجرا میشود — queriesهای با دادههای حساس هرگز دستگاه شما را ترک نمیکنند.
- 04ابزار فقط متن را دوبارهشکل میدهد؛ queryها را اجرا نمیکند یا به هیچ پایگاهداده متصل نمیشود.
چرا SQL را قبل از اشتراکگذاری قالببندی کنیم؟
SQL غیرقالببندی شده واقعاً سخت است. SELECT listsها به یک خط خورد میخورند، تورفتگی نامتسق در subqueriesها و کلیدواژههای mixed-case همه بررسیهای کد و dibuggingها را کند میکنند. یک query بهدرستی قالببندی شده شرطهای JOIN، clauses WHERE و ساختار CTE را فوری خوانایی میسازد.
قالببندی حتی برای اشتراکگذاری queryها در یک تیم با یک guide سبک مهمتر میشود — کلیدواژههای بزرگ، تورفتگی چهار فضا، یک clause در هر خط. فرمتکننده SQL Handytool این سبک را بهطور مسلسل بر روی همه چیزی که شما جا میدهید تقویت میکند، خواه یک query دو خطی یا یک query تحلیلی 200 خطی با CTEs و window functions متعدد باشد.
نحوه قالببندی SQL Query
- 01
SQL خود را جا دهید
هر statement SQL را در پنل ورودی جا دهید — SELECT، INSERT، UPDATE، DELETE، CREATE یا زنجیره CTE کامل. هیچ حد اندازهای فراتر از حافظه موجود مرورگر شما نیست.
- 02
لهجه را انتخاب کنید
PostgreSQL، MySQL، SQLite، BigQuery یا Standard SQL را از کشویی انتخاب کنید. لهجه تعیین میکند که کلمات محفوظ و syntax خاص فروشنده مانند RETURNING یا STRUCT چگونه مدیریت میشوند.
- 03
مورد کلیدواژه و indent را تنظیم کنید
برای مورد کلیدواژه بزرگ، کوچک یا حفظ را انتخاب کنید. برای تورفتگی 2 فضا، 4 فضا یا برگ را انتخاب کنید. کلیدواژههای بزرگ با تورفتگی 2 فضا رایجترین سبک در codebases اشتراکگذاری شده است.
- 04
بر روی Format کلیک کنید
خروجی قالببندی شده فوری در پنل سمت راست ظاهر میشود. Clauseها روی خطوط خود جا میشوند، شرطهای JOIN تراز میشوند و subqueriesها نسبت به والدین خود تورفتگی دارند.
- 05
کپی و استفاده کنید
بر روی Copy کلیک کنید تا SQL قالببندی شده را در clipboard کپی کنید. آن را در IDE، یک فایل SQL، توضیح PR یا قطعه مستند جا دهید.
برای استفاده با الگوهای Query تولید امن
کتابخانه sql-formatter کاملاً در مرورگر شما اجرا میشود. هیچ چیزی برای سرور ارسال نمیشود — هیچ متن query، نامهای جدول، دادههای نمونه نیست. این آن را برای قالببندی queryهایی که schema names واقعی یا مقادیر نمونه را از پایگاهداده staging ارجاع میدهند امن میکند.
یک کار فرمتکننده انجام نمیدهد SQL شما را اجرا میکند. این یک ابزار تبدیل متن است. میتوانید بهطور ایمن queryهایی را جا دهید که جداول را drop یا سطرها را حذف میکنند — ابزار آنها را متن ساده میدیند و بدون اجرای هیچ statement آنها را دوباره شکل میدهند.
سؤالات متداول SQL Formatter
کدام لهجههای SQL این فرمتکننده پشتیبانی میکند؟
SQL استاندارد، PostgreSQL، MySQL، SQLite و BigQuery. هر لهجه syntax خاص فروشنده مانند clause RETURNING PostgreSQL، شناسههای backtick MySQL و نوع STRUCT BigQuery را بهدرستی مدیریت میکند.
آیا فرمتکننده query من را اجرا میکند؟
نه. فقط متن query را دوباره شکل میدهد. به هیچ پایگاهداده متصل نمیشود، نامهای ستون را تأیید نمیکند یا statementها را اجرا نمیکند.
آیا SQL من برای هیچ سرور آپلود میشود؟
نه. کتابخانه sql-formatter در مرورگر شما اجرا میشود. متن query شما در دستگاه شما میماند.
چرا stored procedure یا PL/pgSQL blockام به طریق عجیبی قالببندی شده است؟
SQL رویهای blocks (PL/pgSQL، BEGIN…END blocks، DECLARE sections) خارج از آنچه grammar فرمتکننده پوشش میدهند است. Snippetهای کوچکتر SELECT یا DML را از آن blocksها بهطور جداگانه قالببندی کنید.
بهترین مورد کلیدواژه برای یک codebase اشتراکگذاری شده چیست؟
کلیدواژههای بزرگ رایجترین اصطلاح است — آنها SQL ساختار را از نامهای شناسه بصری جدا میکنند. تورفتگی 2 فضا یا 4 فضا موضوع ترجیح تیم است.