SQL-formaterare

Före och efter

Före:

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;

Efter (inledande komma, versala nyckelord, 2-stegs indentering):

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;

Stilval som spelar roll

• Versala vs gemena nyckelord. VERSALER är traditionellt och lätt att skanna. Gemener är renare i moderna kodredigerare med syntaxmarkering.
• Inledande vs efterföljande kommatecken. Inledande ( , col) gör det lättare att kommentera bort en enskild kolumn. Efterföljande (col,) läses mer naturligt i text.
• Kommaplacering i GROUP BY. Ofta ett per rad för långa satser, inline för korta.
• JOIN-indentering. ON på nästa rad (hängande indentering) vs på samma rad. Långa villkor drar nytta av hängande.
• Subqueries. Indentera hela subquerien, inte bara den inledande parentesen.

Dialektspecifika fallgropar

• MySQL-backticks vs PostgreSQL-dubbelcitat för identifierare.
• WITH-CTE:er, MS SQL har ett krav på ; före WITH; formateraren hanterar det.
• Fönsterfunktioner, långa OVER (...)-satser drar nytta av radbrutna PARTITION BY och ORDER BY.
• BigQuery har ARRAY_AGG, STRUCT och tabellsuffix (*_yyyymmdd) som tokenizern inte får bryta.
• Oracle har (+)-syntax för outer join, formateraren bevarar den men flaggar den som äldre.

Vad formateraren inte gör

• Fixar buggar, en ogiltig JOIN förblir ogiltig.
• Expanderar SELECT *, kolumnlistor härleds inte från schema.
• Optimerar frågor, endast layout, inte exekveringsplaner.
• Skriver om subqueries som CTE:er, en annan fråga.