SQL es famoso por escribirse una vez con prisa y leerse muchas veces bajo presión. Un formato consistente es una de las formas más económicas de hacer que las consultas sean revisables, depurables y compartibles. Esta guía explica por qué importa el formato, las convenciones detrás de la capitalización de palabras clave y cuándo recurrir a la minimización.
Las consultas legibles mejoran los code reviews
Una consulta comprimida en una sola línea oculta su propia estructura. Cuando cada cláusula — SELECT, FROM, cada JOIN, WHERE, GROUP BY — comienza en su propia línea, un revisor puede ver de un vistazo qué tablas están unidas, con qué claves y qué filtros se aplican. Sangrar la lista de selección y las condiciones de unión añade una segunda capa de estructura: puedes recorrer las columnas sin analizar toda la sentencia. El resultado son menos errores no detectados (una condición de unión olvidada es obvia cuando ON aparece en su propia línea sangrada) y revisiones más rápidas. Dado que este formateador solo reorganiza el espacio en blanco y la capitalización, el significado de tu consulta nunca cambia — es puramente cosmético, que es exactamente lo que quieres en un diff.
Convenciones de capitalización de palabras clave
La convención de larga data es escribir las palabras clave SQL en MAYÚSCULAS y los identificadores (tablas, columnas, alias) en minúsculas o mayúsculas mixtas. El contraste hace que el andamiaje del lenguaje resalte frente a tu esquema. Algunos equipos prefieren SQL completamente en minúsculas para un aspecto más suave, y unos pocos usan palabras clave Capitalizadas. No hay una única opción correcta — lo que importa es la coherencia en todo un código base, que es precisamente por qué un formateador que aplica una sola regla en todas partes es tan útil. Esta herramienta solo re-capitaliza las palabras clave reconocidas; los nombres de tus tablas y columnas conservan la capitalización que ya tienen, y nada dentro de un literal de cadena o comentario se modifica jamás.
Cuándo minimizar
Minimizar — contraer una consulta a una sola línea — es lo opuesto a embellecer, y tiene su lugar. Cuando una consulta debe vivir dentro del código fuente de una aplicación como constante de cadena, dentro de un valor de configuración JSON o YAML, o en un comando de shell de una línea, los saltos de línea estorban. Minimizar los elimina manteniendo intacto el contenido de cada literal de cadena, de modo que la consulta sigue ejecutándose de forma idéntica. Una advertencia que la herramienta gestiona por ti: los comentarios de una sola línea (--) no pueden sobrevivir en una consulta de una línea porque comentarían todo lo que les sigue, por lo que minimizar los elimina. Si necesitas la versión legible de vuelta, simplemente pega la consulta minimizada en la pestaña Embellecer.
Un formateador no es un validador
Vale la pena aclarar los límites. Esta herramienta formatea texto — no se conecta a una base de datos, no ejecuta tu consulta ni comprueba que sea SQL válido. Si pegas algo que no puede analizar completamente, igualmente aplica el mejor espaciado posible y marca el resultado como un formato parcial en lugar de fallar. Eso lo hace seguro y rápido para el uso diario, pero aún debes ejecutar tu consulta en una base de datos real (o un linter) para confirmar su corrección. Piensa en el formateo como el primer paso, el más económico, para escribir SQL limpio, no como la última palabra sobre si funciona.