Formateador de SQL: reglas para ordenar consultas

Contenido
Un formateador de SQL es lo que te muestra un SQL que estaba todo pegado en una sola línea larga, abriéndolo por cláusulas. Este artículo explica las reglas: "cómo" ordena las consultas ese formateador. Es justo lo que necesitas si pierdes tiempo leyendo con la vista, una y otra vez, esa consulta de una sola línea que copiaste de un log o de la salida de un ORM.
Lo esencial, primero: el formateador no cambia el significado de la consulta. Solo ajusta espacios, saltos de línea y las mayúsculas y minúsculas de las palabras clave.
Resumen ① Solo pasan a mayúsculas las palabras que están en la lista predefinida de palabras clave de SQL; los nombres de tablas y columnas y las cadenas entre comillas conservan las mayúsculas y minúsculas del original. ② Cada cláusula principal como SELECT, FROM, WHERE, JOIN, GROUP BY u ORDER BY empieza en una línea nueva, y las condiciones AND, OR y ON, los elementos que siguen a una coma y las subconsultas se sangran un nivel. ③ Lo único que cambia son espacios, saltos de línea y mayúsculas y minúsculas de las palabras clave, así que el significado de ejecución de la consulta es el mismo.
Por qué cuesta leer una consulta pegada en una sola línea
Los logs de las aplicaciones, las consultas que imprime el ORM, las consultas pegadas en un chat como Slack o WhatsApp: casi siempre vienen seguidas en una sola línea, sin saltos. Algo como select a,b,c from t1 join t2 on ... where ... and ... order by ....
En esa forma no ves dónde empiezan los elementos del SELECT ni dónde está la cláusula de condiciones. Para contar cuántas condiciones hay después del WHERE tienes que recorrer la cadena de izquierda a derecha hasta el final.
Y si hay subconsultas, se mezcla todo: no distingues si lo que hay dentro de los paréntesis es otro SELECT o una simple llamada a una función. Ese esfuerzo de redibujar los límites mentalmente cada vez es lo que cansa.
Reglas para ordenar a mano, sin herramientas
Lo que hace el formateador es repetir reglas mecánicas ya definidas. Por eso puedes hacer exactamente lo mismo a mano, sin herramienta. El orden es este.
1. Poner en mayúsculas solo las palabras clave. Sube a mayúsculas únicamente las palabras reservadas como SELECT, FROM, WHERE, JOIN, AND, ON, GROUP BY u ORDER BY. No toques los nombres de tablas, los nombres de columnas, los argumentos de funciones ni las cadenas entre comillas.
2. Cambiar de línea en cada cláusula principal. Empieza en una línea nueva cada vez que aparezca SELECT, FROM, WHERE, HAVING, LIMIT, GROUP BY u ORDER BY, y también la familia de JOIN (LEFT JOIN, INNER JOIN, etc.).
3. Sangrar un nivel las condiciones y los elementos. Las condiciones que empiezan por AND, OR u ON y los elementos del SELECT que siguen a una coma van un escalón más adentro que la cláusula.
4. Sangrar más los paréntesis de subconsulta y dejar pegados los de función. Si dentro de los paréntesis hay otro SELECT, sangra ese contenido un nivel más. En cambio, los paréntesis de una llamada a función como COUNT(*) se quedan pegados al nombre.
Aplica estas cuatro reglas a la consulta de una línea de abajo.
select o.id, o.total, u.name from orders o join users u on u.id = o.user_id where o.total > 1000 and u.status = 'active' order by o.total desc;
Si la ajustas según las reglas, queda así (con sangría de 2 espacios).
SELECT o.id,
o.total,
u.name
FROM orders o
JOIN users u
ON u.id = o.user_id
WHERE o.total > 1000
AND u.status = 'active'
ORDER BY o.total DESC;
Hay varios detalles que conviene comprobar aquí. La cadena 'active' no pasó a mayúsculas, y los alias o y u y los nombres de columna siguen en minúsculas tal como estaban. Lo que subió a mayúsculas son solo palabras reservadas: SELECT, FROM, JOIN, ON, WHERE, AND, ORDER BY, DESC.
A mano también se puede, pero cuando se acumulan diez condiciones o se anidan subconsultas, contar la profundidad de los paréntesis ya se vuelve molesto. Compruébalo con nuestra herramienta.
Solo tienes que pegar la consulta: las palabras reservadas pasan a mayúsculas y cada cláusula empieza en una línea nueva. Funciona en el navegador, sin instalar nada ni registrarte.

Cómo leer el resultado ya ordenado
Al mirar el resultado ordenado, recuerda esto: "solo cambió la forma". Que ahora haya varias líneas no significa que la consulta sea distinta.
Una línea sangrada un nivel pertenece a la cláusula que tiene justo encima. El AND sangrado bajo el WHERE es una condición adicional de ese WHERE, y el SELECT que aparece más adentro después de un paréntesis de apertura es una subconsulta.
Los paréntesis de subconsulta aumentan un nivel la profundidad, pero los de llamada a función quedan pegados, así que con solo seguir la profundidad de la sangría distingues a simple vista "si este paréntesis es una consulta interna o una función simple".
En la pantalla se muestran dos valores junto al resultado: el número de líneas de salida y el tamaño de salida (en bytes). Estas cifras solo indican la longitud del texto después de ordenarlo y no tienen ninguna relación con el rendimiento de la consulta ni con el número de filas que procesa.
Errores de interpretación frecuentes
El error más común es creer que "ordenar cambia el resultado de la consulta". El formateo solo cambia espacios, saltos de línea y mayúsculas y minúsculas de las palabras clave, así que el significado que lee la base de datos es el mismo.
También conviene tener en cuenta una limitación. SQL tiene detalles de sintaxis distintos en cada dialecto (MySQL, PostgreSQL, Oracle, etc.), y las construcciones especiales que no están en la lista de palabras clave que conoce el formateador no se reconocen como cláusulas, así que el resultado puede quedar pegado de forma extraña. Es decir, esta herramienta sirve como referencia para mejorar la legibilidad.
| Error de interpretación frecuente | Comportamiento real |
|---|---|
| Ordenar cambia el resultado de la consulta | Solo cambian espacios, saltos de línea y mayúsculas y minúsculas de las palabras clave, así que el significado de ejecución es el mismo |
| Todas las palabras que pasan a mayúsculas son reservadas | Solo se ponen en mayúsculas las palabras que están en la lista de palabras clave predefinida |
| Los nombres de columnas y tablas también se unifican en mayúsculas | Los identificadores y las cadenas entre comillas mantienen las mayúsculas y minúsculas originales |
| Todos los paréntesis crean sangría | Solo los paréntesis de subconsulta se sangran; los de llamada a función quedan pegados al nombre |
| Cambiar la sangría cambia la consulta | 2 espacios, 4 espacios o tabulador solo cambian el espacio en blanco visible; el significado es el mismo |
En resumen
- Las mayúsculas se aplican solo a la lista de palabras clave definida, y los nombres de tablas y columnas y las cadenas entre comillas conservan el original.
- Cada cláusula principal como SELECT, FROM, WHERE, JOIN, GROUP BY u ORDER BY empieza en una línea nueva, y las condiciones AND, OR y ON y los elementos que siguen a una coma se escriben un nivel más adentro.
- Los paréntesis de subconsulta aumentan la sangría, pero los de llamada a función quedan pegados al nombre, así que solo con mirar la profundidad puedes distinguirlos.
- Los comentarios y las cadenas se conservan tal cual, y las distintas sentencias separadas por punto y coma se ordenan cada una por su lado.
- Lo único que cambia es la forma, así que el significado de ejecución es el mismo, y cambiar la unidad de sangría (2 o 4 espacios, tabulador) no altera el sentido.
Solo tienes que pegar la consulta: las palabras reservadas pasan a mayúsculas y cada cláusula empieza en una línea nueva. Funciona en el navegador, sin instalar nada ni registrarte.
Preguntas frecuentes
¿Si ordeno la consulta cambia el resultado de la ejecución?
No. Como el formateo solo ajusta espacios, saltos de línea y mayúsculas y minúsculas de las palabras clave, el significado de la consulta que interpreta la base de datos sigue igual. Eso sí, las construcciones especiales de cada dialecto pueden quedar mal ordenadas, así que conviene verlo como una herramienta de referencia para mejorar la legibilidad.
¿Los nombres de columnas o las cadenas también pasan a mayúsculas?
No. Las mayúsculas se aplican solo a las palabras que están en la lista predefinida de palabras clave como SELECT, FROM, WHERE o JOIN. Los nombres de tablas y columnas, los argumentos de funciones y los literales de cadena entre comillas mantienen las mayúsculas y minúsculas originales. Si desactivas la casilla de mayúsculas en palabras clave, las palabras reservadas también se quedan como estaban.
¿Puedo ordenar varias sentencias a la vez?
Sí. Ordena por separado cada una de las sentencias separadas por punto y coma (;). Cada sentencia se corta en el punto y coma y se le aplican los saltos de línea por cláusula de forma independiente. Los comentarios (-- , /* */) y el contenido dentro de las cadenas se conservan tal cual durante el proceso de ordenación.
¿Qué cambia si paso la sangría de 2 a 4 espacios?
Solo cambia el ancho del espacio en blanco delante de las líneas sangradas. Puedes elegir entre 2 espacios, 4 espacios o tabulador, y con cualquiera de ellos la posición de los saltos de línea y el significado de la consulta son los mismos. Al cambiar la configuración, el resultado se vuelve a calcular al instante, sin necesidad de pulsar un botón de ejecutar.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano