Lección 5

Formateo SQL y legibilidad

Formatea SQL largo de logs, ORMs y revisiones para que la estructura sea visible.

El SQL largo es difícil de revisar cuando se copia de logs o lo genera un ORM:

select u.id,u.email,o.total,case when o.total>100 then 'vip customer' else 'standard customer' end as segment from users u join orders o on o.user_id=u.id where o.created_at>='2026-01-01' and o.status in ('paid','refunded') order by o.created_at desc;

Formatear no hace correcta la consulta, pero expone la estructura:

  • Las columnas seleccionadas se convierten en una lista.
  • Los bloques de join se hacen visibles.
  • Las ramas CASE se vuelven legibles.
  • Los filtros se pueden escanear uno a uno.
  • La ordenación y los límites son más fáciles de detectar.

Hábitos útiles de formateo

Para depuración de aplicaciones, prefiere consistencia sobre gusto personal:

  • Pon las cláusulas principales en líneas separadas.
  • Indenta expresiones anidadas y ramas CASE.
  • Mantén las condiciones de join cerca de sus joins.
  • Usa mayúsculas/minúsculas de palabras clave de forma consistente dentro del proyecto.
  • Evita reformatear consultas no relacionadas en un pull request salvo que el cambio sea intencional.

Minificar tiene un propósito distinto

Minificar SQL elimina espacios en blanco y comentarios innecesarios para fragmentos compactos. Es útil en archivos de configuración, ejemplos copiados o tests donde una sola línea es más fácil de incrustar.

No minifiques SQL que los humanos necesiten revisar durante un incidente. Usa formateo legible mientras depuras.

Conclusión clave

El formateo es una herramienta de pensamiento. Convierte una cadena densa en una estructura que puedes inspeccionar, discutir y cambiar con seguridad.

Abre el Formateador SQL y compara Formatear vs Minificar en la misma consulta para ver qué versión encaja con revisión o incrustación.

Volver al resumen del curso