Formateador SQL

Acerca de Formateador SQL

Este formateador no es un analizador sintáctico de SQL. Divide el texto en tokens, palabras clave, identificadores, números, cadenas, comentarios y signos, y aplica reglas de salto de línea: una línea nueva para cada cláusula como SELECT, FROM, WHERE, JOIN o GROUP BY, las palabras clave conocidas en mayúsculas, un elemento por línea en la lista del SELECT y una línea por cada AND/OR del WHERE. Las cadenas entre comillas simples y los comentarios no se tocan.

Al no analizar la consulta, no sabe si es válida y no conoce todos los dialectos. A continuación se indica qué sintaxis propia de MySQL, PostgreSQL y SQL Server conserva intacta y qué problemas no se arreglan con sangría.

Qué sintaxis de cada dialecto reconoce

En SQL estándar las comillas simples delimitan cadenas y las dobles delimitan identificadores, y una comilla dentro de una cadena se duplica: 'It''s'. La herramienta entiende eso, los identificadores con acento grave de MySQL, como `id`, y las características de dialecto siguientes, que mantiene como un solo token.

• Las cadenas de MySQL con barra invertida, como 'It\'s', se conservan tal cual. Si al leer las barras como escape la cadena quedara sin cerrar, la herramienta vuelve a la regla estándar ('').
• El comentario de línea # de MySQL se reconoce. Al minificar se elimina como cualquier otro comentario, así que la línea siguiente no queda absorbida. Los operadores #>, #>> y #- de PostgreSQL se tratan como operadores, no como comentarios.
• Los operadores ->>, ->, @>, <@, || y el :: de PostgreSQL se mantienen enteros; :: se escribe sin espacios, como en created_at::date. Los cuerpos entre $$ ... $$ o $tag$ ... $tag$ se tratan como cadenas y no se tocan.
• Los signos pegados a una cadena conservan su espaciado original: array['a'] queda igual.
• Los identificadores entre corchetes de SQL Server, como [order id], se conservan tal cual, espacios incluidos.
• Al minificar se eliminan los comentarios -- y /* */, pero se conservan las pistas del optimizador (/*+ ... */) y los comentarios ejecutables /*! ... */ de MySQL, porque cambian cómo se ejecuta la consulta.

Lo que el formato no puede arreglar

La trampa clásica es la precedencia. AND se evalúa antes que OR, así que a = 1 OR b = 2 AND c = 3 significa a = 1 OR (b = 2 AND c = 3). El formateador coloca AND y OR a la misma profundidad, lo que invita a leer las tres condiciones como equivalentes. Si querías (a = 1 OR b = 2) AND c = 3, tienes que poner los paréntesis tú.

Lo mismo pasa con un LEFT JOIN filtrado en el WHERE. En el primer ejemplo, la condición sobre o.created_at se aplica después de la unión; para los usuarios sin pedidos o.created_at es NULL, la comparación no es verdadera y esas filas desaparecen. La consulta se comporta en silencio como un INNER JOIN. Para conservar a los usuarios sin pedidos, mueve la condición a la cláusula ON. Un buen formato ayuda a verlo, pero la herramienta no lo señala.

Del mismo modo, col = NULL da 'desconocido' y nunca selecciona filas; hace falta IS NULL. Una consulta con ese error es SQL válido antes y después de formatearla.

Qué cambia la herramienta y qué no

• Solo pasan a mayúsculas las palabras de su lista: SELECT, FROM, LEFT JOIN, GROUP BY, CASE, AS, etc. Los nombres de funciones y tipos como count, coalesce o date quedan como los escribiste.
• El ancho de sangría se fija en espacios. Las subconsultas se sangran un nivel más por cada paréntesis.
• Minificar reduce los espacios a uno y elimina los comentarios (salvo las pistas /*+ */ y los /*! */). Los espacios repetidos dentro de cadenas, como 'x y', se conservan.

Ejemplos

Cómo se usa

1. Pega tu SQL. Separa las sentencias con punto y coma.
2. Elige el ancho de sangría y pulsa Formatear o Minificar.
3. Compara la salida con el original antes de usarla.

Preguntas frecuentes