Formateador de SQL

Consultas que se pueden volver a leer

El SQL se convierte enseguida en líneas ilegibles: una consulta impresa por un ORM, copiada de un registro, escrita por un compañero con prisa o comprimida por una herramienta en una sola línea. Leerla, revisarla o depurarla es mucho más fácil cuando cada cláusula tiene su línea, las uniones y condiciones tienen sangría y las palabras clave destacan. Este formateador reorganiza la disposición de una consulta sin cambiar lo que hace.

Qué hace el formato

• Pone SELECT, FROM, WHERE, GROUP BY, ORDER BY y las demás cláusulas principales en líneas separadas.
• Lista las columnas seleccionadas una por línea y da sangría a uniones, condiciones, subconsultas y expresiones CASE para que se vea el anidamiento.
• Pone varias sentencias separadas por punto y coma una tras otra, con una línea en blanco entre ellas.
• Deja las cadenas, los identificadores entrecomillados, los comentarios y los números exactamente como los escribiste.

Elige el dialecto

SQL es una familia de lenguajes más que uno solo. Cada base de datos añade sus propias palabras clave, funciones, maneras de entrecomillar nombres y marcadores de parámetros. Elegir el dialecto correcto, entre SQL estándar, MySQL, MariaDB, PostgreSQL, SQLite, SQL Server, Oracle y BigQuery, ayuda al formateador a reconocerlos, por ejemplo las comillas invertidas de MySQL, los corchetes de SQL Server o la conversión con doble dos puntos de PostgreSQL.

Mayúsculas de las palabras clave y sangría

La mayoría de guías de estilo escriben las palabras clave en mayúsculas para que destaquen de los nombres de tablas y columnas, y algunos equipos prefieren minúsculas. Puedes convertir las palabras clave a cualquiera de las dos o dejarlas como están escritas. La sangría puede ser de dos o cuatro espacios o un tabulador, para ajustarse a la convención de tu equipo.

Lo que no hace

El formateador no comprueba que el SQL sea correcto para tu base de datos, que las tablas existan ni que la consulta vaya a ejecutarse. Solo cambia la disposición. La sintaxis poco habitual o las extensiones de un fabricante pueden quedar a veces con una disposición que no elegirías, o dar un error que puedes resolver eligiendo otro dialecto. No optimiza consultas ni las reescribe.