Convenciones de Formato SQL: Escribir Consultas Legibles

Por Que Formatear tus Consultas SQL

Una consulta SQL en una sola linea funciona perfectamente para el motor de base de datos. Pero para los humanos que deben leerla, depurarla y modificarla, es una pesadilla. El formateo transforma un bloque de texto opaco en un documento estructurado y comprensible.

En un equipo, las convenciones de formateo compartidas reducen el tiempo de revision de codigo y disminuyen los riesgos de errores al modificar.

Reglas de Indentacion

• Palabras clave principales al inicio de linea: SELECT, FROM, WHERE, JOIN, GROUP BY, ORDER BY y HAVING comienzan cada uno una nueva linea.
• Columnas indentadas: Las columnas seleccionadas y condiciones se indentan un nivel bajo su palabra clave padre.
• Subconsultas: Cada nivel de anidacion agrega un nivel de indentacion.
• Comas: Dos escuelas: coma al final o al inicio de linea. La coma al inicio facilita comentar columnas individuales.

Convenciones de Mayusculas

• Palabras clave en mayusculas: SELECT, FROM, WHERE. Convencion tradicional que distingue la sintaxis SQL de nombres de tablas.
• Palabras clave en minusculas: Mas moderno, mas rapido de escribir. Los editores actuales colorean la sintaxis.

Para nombres de tablas y columnas, prefiere snake_case (nombre_usuario).

Joins y Alias

• Tipo de join explicito: Escribe siempre INNER JOIN, LEFT JOIN. No uses la sintaxis implicita con coma en el FROM.
• Condicion ON en su propia linea: Coloca el ON en una linea indentada bajo el JOIN.
• Alias significativos: Usa alias cortos pero descriptivos. u para users, o para orders. Evita t1, t2.

Comentarios y Documentacion

• Comentario de bloque al inicio: Explica el proposito de la consulta, no su mecanica.
• Comentario en condiciones complejas: Si una clausula WHERE usa logica de negocio no obvia, explica por que existe.
• Comentario en numeros magicos: WHERE status = 3 no dice nada. Agrega un comentario.

Herramientas de Formato Automatico

Nuestro formateador SQL automatiza el proceso. Pega tu consulta y obtiene una version formateada con un clic. Soporta dialectos SQL comunes (MySQL, PostgreSQL, SQL Server).