รูปแบบ SQL

ก่อนและหลัง

ก่อนหน้านี้:

SELECT u.id,u.name,COUNT(o.id) AS orders FROM users u LEFT JOIN orders o ON o.user_id=u.id WHERE u.created_at>='2024-01-01' GROUP BY u.id,u.name HAVING COUNT(o.id)>5 ORDER BY orders DESC LIMIT 50;

หลังจากนั้น (ใช้จุดค่าก่อนคำสำคัญ เขียนคำสำคัญเป็นตัวพิมพ์ใหญ่ และแทรกช่องว่างสองตำแหน่งเพื่อเริ่มการ indent):

SELECT
    u.id
, u.name
, COUNT(o.id) AS orders
FROM users u
LEFT JOIN orders o
  ON o.user_id = u.id
WHERE u.created_at >= '2024-01-01'
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 5
ORDER BY orders DESC
LIMIT 50;

การเลือกสไตล์ที่สำคัญ

• คำสำคัญที่เขียนตัวพิมพ์ใหญ่เทียบกับตัวพิมพ์เล็ก การใช้ตัวพิมพ์ใหญ่ถือเป็นแนวทางดั้งเดิมและเหมาะสมสำหรับการสแกนโค้ด ในขณะที่การใช้ตัวพิมพ์เล็กให้รูปลักษณ์เรียบร้อยกว่าในโปรแกรมแก้ไขโค้ดสมัยใหม่ที่มีฟังก์ชันเน้นไวยากรณ์
• เครื่องหมายจุลภาคแบบนำหน้า (Leading) เทียบกับแบบตามหลัง (Trailing): เครื่องหมายจุลภาคแบบนำหน้า (, col) ช่วยให้การใส่คำอธิบายเพิ่มเติมในคอลัมน์เดียวทำได้ง่ายขึ้น ในขณะที่เครื่องหมายจุลภาคแบบตามหลัง (col,) มีรูปแบบการอ่านที่เป็นธรรมชาติมากกว่าในข้อความ
• การวางเครื่องหมายจุลภาคใน GROUP BY: โดยทั่วไปควรใช้หนึ่งเครื่องหมายต่อบรรทัดสำหรับประโยคที่ยาว และใช้เครื่องหมายจุลภาคแบบฝัง (inline) สำหรับประโยคที่สั้น
• การจัดรูปแบบการแทรกข้อความ: การใช้ ON บนบรรทัดถัดไป (การแทรกแบบแขวน) เทียบกับการใช้บนบรรทัดเดียวกัน โดยเงื่อนไขที่มีความยาวจะได้รับประโยชน์จากการแทรกแบบแขวน
• คำสั่งค้นหาย่อย: ให้แทรกข้อมูลของคำสั่งค้นหาย่อยทั้งหมดลงในรูปแบบการ indent ไม่ใช่เพียงแค่ส่วนที่อยู่ภายในวงเล็บเปิดเท่านั้น

ข้อควรระวังเฉพาะของแต่ละไดอะเล็กต์

• การใช้เครื่องหมายแบ็กทิก (backticks) ใน MySQL เทียบกับการใช้เครื่องหมายอัญประกาศคู่ (double-quotes) ใน PostgreSQL สำหรับตัวระบุ
• WITH CTEs, MS SQL มีข้อกำหนด ; ก่อนที่จะมี WITH; โปรแกรมจัดรูปแบบข้อมูลจะจัดการกับข้อกำหนดนี้
• ฟังก์ชันของหน้าต่าง, ข้อกำหนดที่มีความยาวมากใน OVER (...) จะได้รับประโยชน์จากการใช้รูปแบบการบรรจุข้อความแบบวนรอบ (line-wrapped) ใน PARTITION BY และ ORDER BY
• BigQuery มีชื่อไฟล์ในรูปแบบ ARRAY_AGG, STRUCT และส่วนท้ายของตาราง (เช่น *_yyyymmdd) ซึ่งตัวแปลงคำศัพท์ (tokenizer) ห้ามทำให้แตก
• Oracle ใช้ไวยากรณ์การเชื่อมข้อมูลแบบ external join รหัส (+) โดยโปรแกรมจัดรูปแบบจะคงไวยากรณ์นี้ไว้ แต่จะระบุว่าเป็นรูปแบบเก่า

สิ่งที่ตัวจัดรูปแบบไม่ทำ

• แก้ไขข้อผิดพลาด, การเชื่อมข้อมูลแบบ JOIN ที่ไม่ถูกต้องจะยังคงไม่ถูกต้องต่อไป
• ขยายข้อมูลในคอลัมน์ SELECT *, รายการในคอลัมน์ไม่ได้ถูกอนุมานจากสเกมา
• ปรับแต่งคำสั่งค้นหา, เพียงแค่เรื่องการจัดวางเท่านั้น ไม่รวมแผนการดำเนินการ
• การเขียนคำสั่งซับควอเรีย (subquery) ใหม่ให้อยู่ในรูปแบบของ CTE (Common Table Expression), เป็นประเด็นที่ต่างออกไป