SQL-formatter

Hoe het werkt

Queries komen als één lange regel uit logs, ORM's en van collega's, en de eerste stap om er iets van te begrijpen is altijd ze uit te leggen. Ze daarvoor in een website plakken is hoe productiequeries, met tabelnamen, kolomnamen en soms letterlijke klantgegevens in een WHERE-clausule, op de server van iemand anders belanden.

Dialecten doen ertoe

SQL is een familie en geen enkele taal. PostgreSQL, MySQL, T-SQL, PL/SQL, BigQuery en Spark hebben elk syntaxis die de anderen afwijzen, en een formatter met het verkeerde dialect verminkt een query of weigert hem. Standaard-SQL past bij de meeste gewone queries; schakel om als de jouwe syntaxis van een specifieke leverancier gebruikt.

Het maakt alleen op

Er wordt niets uitgevoerd, er wordt geen contact gemaakt met een database en de betekenis van de query verandert nooit, alleen de witruimte en het hoofdlettergebruik van trefwoorden. Een formatter die je query wijzigt, zou gevaarlijk zijn.

Hoofdlettergebruik van trefwoorden

Trefwoorden in hoofdletters tegenover identifiers in kleine letters is de gevestigde conventie en maakt de structuur scanbaar. Behouden wat je typte is er voor teams wiens stijlgids iets anders voorschrijft.

Waarom dit lokaal draait

Een query beschrijft je schema en vaak ook je gegevens. Er is geen reden dat die je machine moet verlaten om te worden ingesprongen.