Cómo formatear consultas SQL

Un SQL desordenado es una de las formas más rápidas de introducir errores. Cuando una consulta está en una sola línea larga sin indentación, es difícil ver qué condiciones se aplican a qué joins, dónde empiezan y acaban las subconsultas, o si la lógica es correcta.

Por qué importa el formateo

• Depuración — una consulta bien formateada hace visibles los errores de lógica. Puedes seguir el flujo de SELECT a WHERE y luego a JOIN sin adivinar.
• Revisión de código — los revisores leen SQL formateado en segundos. Una consulta en una sola línea les obliga a analizarla mentalmente antes.
• Mantenimiento — cuando vuelvas a una consulta meses después, el formateo te dice qué hace a primera vista.
• Colaboración — un formateo coherente en un equipo significa que todos leen SQL de la misma forma.

Cómo formatear SQL

1. Pega tu SQL — introduce una consulta minificada o desordenada en el formateador. Gestiona SELECT, INSERT, UPDATE, DELETE, CREATE TABLE, así como consultas complejas con subconsultas y joins.
2. Configura las opciones — elige el tamaño de indentación y si las palabras clave deben ir en mayúsculas. Estos ajustes se corresponden con la guía de estilo de tu proyecto.
3. Copia el resultado — el SQL formateado está listo para volver a pegarse en tu editor, tu cliente de base de datos o tu documentación.

Cómo es un buen formateo

Una consulta como select u.name, o.total from users u join orders o on u.id = o.user_id where o.total > 100 and u.active = 1 order by o.total desc se convierte en:

SELECT
  u.name,
  o.total
FROM users u
JOIN orders o
  ON u.id = o.user_id
WHERE o.total > 100
  AND u.active = 1
ORDER BY o.total DESC

Cada cláusula empieza en su propia línea. Las condiciones están indentadas bajo su cláusula padre. Los joins y sus condiciones ON están claramente emparejados.

Consejos

• Formatea antes de confirmar — pasa tu SQL por un formateador antes de añadirlo al control de versiones. Así los diffs quedan limpios y las revisiones se centran en la lógica, no en el estilo.
• Usa un uso de mayúsculas coherente para las palabras clave — elige mayúsculas o minúsculas y mantén esa elección en todo tu proyecto. Los estilos mezclados hacen las consultas difíciles de leer.
• Divide las consultas complejas — si una consulta sigue siendo difícil de leer incluso formateada, divídela en CTE (Common Table Expressions) o vistas. El formateo no puede corregir una lógica fundamentalmente compleja.
• Comprueba el resaltado de sintaxis — un buen formateador ofrece un resaltado que distingue palabras clave, cadenas y números, lo que ayuda a detectar erratas.