Cómo escribir y formatear consultas SQL legibles

Por qué importa el formato
Una consulta analítica de ochenta líneas que llega en un solo bloque cuesta más de revisar. Las cláusulas alineadas muestran la estructura y facilitan detectar condiciones de unión ausentes, filtros inesperados y productos cartesianos. Separar columnas en líneas también hace más pequeños y claros los cambios en Git.
1. Una cláusula por línea
Coloca SELECT, FROM, JOIN, WHERE, GROUP BY, HAVING, ORDER BY y LIMIT en líneas propias. Aplica sangría a las columnas, las condiciones de unión y los predicados. Alinea AND y OR de forma que se pueda seguir la lógica verticalmente y conserva los paréntesis necesarios.
2. Convenciones de estilo
| Convención | Elección frecuente | Motivo |
|---|---|---|
| Palabras clave | Mayúsculas | Distinguen cláusulas de identificadores. |
| Sangría | 2 o 4 espacios | El ancho de tabulador puede variar por editor. |
| Alias | AS explícito cuando el dialecto lo admite | Facilita leer los nombres derivados. |
| Uniones | INNER o LEFT explícito | Deja clara la relación que se pretende. |
| Fin de sentencia | Punto y coma | Separa sentencias en scripts y migraciones. |
3. Comas al principio o al final
Con comas finales, añadir una columna al final suele obligar a editar también la línea anterior. Con comas iniciales, cada elemento a partir del segundo se puede añadir en una línea independiente. Configura una opción común y aplícala automáticamente.
Comas finales
SELECT
id,
email,
created_at
FROM usersComas iniciales
SELECT
id
, email
, created_at
FROM users4. Diferencias entre dialectos
Selecciona el motor de destino antes de formatear. Las comillas, la paginación y algunos operadores cambian según el dialecto.
| Operación | MySQL | PostgreSQL | SQL Server |
|---|---|---|---|
| Identificador delimitado | Comillas invertidas | Comillas dobles | Corchetes |
| Límite de filas | LIMIT 10 | LIMIT 10 | TOP 10 u OFFSET/FETCH |
| Concatenación típica | CONCAT() | || | + |
Consulta la documentación de MySQL, PostgreSQL y SQL Server para las reglas de identificadores.
5. La misma consulta antes y después
Antes
select u.id,u.email,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.created_at>='2026-01-01' and u.status='active' group by u.id,u.email having count(o.id)>3 order by orders desc limit 50;Después
SELECT
u.id,
u.email,
COUNT(o.id) AS orders
FROM users AS u
LEFT JOIN orders AS o
ON o.user_id = u.id
WHERE u.created_at >= '2026-01-01'
AND u.status = 'active'
GROUP BY
u.id,
u.email
HAVING COUNT(o.id) > 3
ORDER BY orders DESC
LIMIT 50;La condición ON se lee junto a LEFT JOIN y los dos filtros se distinguen dentro de WHERE. La cláusula HAVING queda separada del filtro de filas previo a la agrupación.
6. Editor, CI y navegador
Configura el editor para formatear al guardar. Añade una comprobación en CI para aplicar el mismo estilo con independencia del equipo de cada persona. Si solo quieres ordenar una consulta que has copiado de un registro, el formateador SQL permite revisarla en el navegador. Un formateador no repara errores de lógica ni verifica el plan de ejecución.
7. Preguntas frecuentes
¿Es mejor escribir las palabras clave en mayúsculas?+
Elige una convención para el equipo y aplícala automáticamente. Las reglas de mayúsculas de los identificadores dependen del motor y de si se escriben entre comillas.
¿El formato cambia el rendimiento de la consulta?+
El beneficio está en la revisión. Una unión sin condición o un filtro en el lugar equivocado sí puede cambiar la corrección y el rendimiento. Revisa literales, identificadores y comentarios cuando uses un formateador.
¿Cómo doy formato a SQL sin compartir la consulta?+
Una consulta puede contener nombres internos y valores de filtros. Revisa dónde se procesa antes de pegar código de producción.
¿Cómo organizo muchas columnas y uniones?+
Los alias coherentes ayudan a seguir las relaciones. Si la consulta sigue siendo difícil de leer, considera separar etapas con expresiones de tabla comunes (CTE) y comprobar el plan de ejecución.
Da formato a SQL en tu navegador
Elige el dialecto y la sangría para revisar la consulta sin subirla a un servidor.