SQL-formatter

Zo formatteer je een SQL-query

1. Plak een of meer query’s, of klik op Bestand openen om een .sql-bestand te laden (tot 10 MB).
2. Kies het Dialect van je database, bijvoorbeeld PostgreSQL, MySQL of SQL Server (T-SQL).
3. Kies hoe de Sleutelwoorden geschreven worden (HOOFDLETTERS, kleine letters of Zoals getypt) en de Inspringing.
4. Vink Geen spaties rond operatoren aan als je a=b+1 liever hebt dan a = b + 1.
5. Klik op SQL formatteren en kopieer of download daarna het resultaat. Als je een optie wijzigt, wordt de query opnieuw geformatteerd.

De query wordt alleen als tekst opnieuw opgemaakt. Hij wordt nooit uitgevoerd en nooit naar een database of server gestuurd.

Wat de formatter doet

De tool gebruikt de opensourcebibliotheek sql-formatter. Die splitst elke instructie op in clausules en zet elk clausulesleutelwoord (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) op een eigen regel, met de inhoud van de clausule ingesprongen eronder. Kolommen in een SELECT-lijst komen elk op een eigen regel, voorwaarden met AND en OR beginnen op een nieuwe regel, en subquery’s en CASE-expressies springen in per nestingsniveau. Korte expressies tussen haakjes blijven op één regel. Meerdere instructies, gescheiden door puntkomma’s, worden uit elkaar gehouden met een lege regel.

Alleen witruimte en hoofdletters veranderen. Tekenreeksen, identifiers tussen aanhalingstekens en commentaar blijven precies zoals ze waren, dus de geformatteerde query geeft hetzelfde resultaat als het origineel.

Waarom het dialect ertoe doet

SQL-databases delen de kern van de taal, maar verschillen in details, en een formatter moet die kennen om de query goed te lezen:

• identifiers staan tussen "dubbele aanhalingstekens" in standaard-SQL en PostgreSQL, tussen `backticks` in MySQL, MariaDB en BigQuery, en tussen [blokhaken] in SQL Server;
• operatoren zoals ->> en de casts met :: in PostgreSQL, of padtoegang met : in Snowflake, bestaan maar in sommige dialecten;
• parameters worden anders geschreven: ?, $1, :name of @name;
• elk dialect heeft eigen gereserveerde woorden en functies, en die worden door de optie Sleutelwoorden aangepast.

Krijg je de melding “De query kon niet worden gelezen”, controleer dan eerst of het gekozen dialect bij je database past. De fout toont de regel en kolom waar het lezen stopte. Standaard-SQL is de strengste keuze; kies waar mogelijk je echte database.

Hoofdletters en stijltips

Sleutelwoorden in hoofdletters zijn nog altijd de meest gebruikte conventie, omdat ze de taal in één oogopslag onderscheiden van tabel- en kolomnamen. Kleine letters zijn populair in teams die dat prettiger lezen, en Zoals getypt laat je eigen keuze ongemoeid. Namen van tabellen, kolommen en functies worden nooit gewijzigd: alleen gereserveerde sleutelwoorden volgen de optie. Bij lange bestanden maakt een consequente opmaak ook de verschillen tussen versies veel makkelijker te beoordelen.