Formatador SQL

Com formatar una consulta SQL

1. Enganxa una o diverses consultes, o fes clic a Obre un fitxer per carregar un fitxer .sql (fins a 10 MB).
2. Tria el Dialecte de la teva base de dades, per exemple PostgreSQL, MySQL o SQL Server (T-SQL).
3. Tria com s’escriuen les Paraules clau (MAJÚSCULES, minúscules o Mantén-les tal com estan) i el Sagnat.
4. Marca Sense espais al voltant dels operadors si prefereixes a=b+1 a a = b + 1.
5. Fes clic a Formata l’SQL i després copia o baixa el resultat. Si canvies una opció, la consulta es torna a formatar.

La consulta només es reformata com a text. No s’executa mai ni s’envia a cap base de dades ni a cap servidor.

Què fa el formatador

L’eina utilitza la biblioteca de codi obert sql-formatter. Divideix cada sentència en clàusules i posa cada paraula clau de clàusula (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) en una línia pròpia, amb el contingut de la clàusula sagnat a sota. Les columnes d’una llista SELECT es col·loquen una per línia, les condicions AND i OR comencen línies noves, i les subconsultes i les expressions CASE se sanguen segons el nivell d’imbricació. Les expressions curtes entre parèntesis es mantenen en una sola línia. Diverses sentències separades per punts i coma es mantenen separades per una línia en blanc.

Només canvien els espais en blanc i les majúscules i minúscules. Els literals de cadena, els identificadors entre cometes i els comentaris es mantenen exactament, de manera que la consulta formatada retorna el mateix resultat que l’original.

Per què importa el dialecte

Les bases de dades SQL comparteixen el llenguatge bàsic però difereixen en els detalls, i un formatador els ha de conèixer per llegir bé la consulta:

• els identificadors es posen entre "cometes dobles" a l’SQL estàndard i a PostgreSQL, entre `accents oberts` a MySQL, MariaDB i BigQuery, i entre [claudàtors] a SQL Server;
• operadors com ->> i les conversions :: de PostgreSQL, o l’accés per ruta amb : de Snowflake, només existeixen en alguns dialectes;
• els marcadors de paràmetres difereixen: ?, $1, :nom o @nom;
• cada dialecte té les seves pròpies paraules reservades i funcions, que l’opció Paraules clau canvia.

Si apareix «No s’ha pogut analitzar la consulta», comprova primer que el dialecte seleccionat coincideix amb la teva base de dades. L’error mostra la línia i la columna on s’ha aturat l’anàlisi. SQL estàndard és l’opció més restrictiva; tria la teva base de dades real sempre que sigui possible.

Consells sobre majúscules i estil

Les paraules clau en majúscula continuen sent la convenció més habitual perquè separen el llenguatge dels noms de taules i columnes d’un cop d’ull. Les minúscules són populars en equips que les troben més fàcils de llegir, i Mantén-les tal com estan deixa intacta la teva elecció. Els noms de taules, columnes i funcions no es canvien mai: només les paraules clau reservades segueixen l’opció. En fitxers llargs, un format coherent també fa molt més fàcil revisar les diferències entre versions.