Formatear SQL cuando la consulta llega en una sola línea
Alguien pega en el chat una consulta de 600 caracteres sin un solo salto de línea. Este formateador la reparte en bloques con sangría para que puedas leer el WHERE y los JOIN. Conoce 20 dialectos, entre ellos SQL estándar, PostgreSQL, MySQL, BigQuery y T-SQL.
Pasos para ordenar una consulta
- Pega la consulta en SQL de entrada. El ejemplo trae un
SELECTcon joins y subconsulta, unINSERTy unUPDATE. - Elige el Dialecto. Por defecto es SQL estándar.
- Ajusta las mayúsculas, la sangría y el resto de opciones. Cada cambio vuelve a formatear.
- Al escribir, el formateo se lanza tras unos 300 ms de pausa. El botón Formatear lo hace al instante.
- Pulsa Copiar o Descargar .sql para guardar el archivo
formatted.sql.
Cuando el dialecto no coincide
El SQL estándar no entiende el cast de PostgreSQL a::int ni nombres como [dbo].[orders] de T-SQL. En ese caso aparece un error de análisis con la línea y la columna. Con el dialecto correcto, el mismo texto se formatea sin problema.
Parámetros ?, $1, :name y @name
Las consultas preparadas llevan marcadores. Si el error señala uno de ellos, abre Estilo de parámetros y elige el que usa tu controlador. Todos acepta los cuatro. Los marcadores se quedan en el texto y no se sustituyen por valores.
Opciones de diseño
Las palabras clave salen en mayúsculas, en minúsculas o como las escribiste. La sangría es de 2 espacios, 4 espacios o una tabulación. El ancho de expresión (50, 80 o 120 caracteres) fija cuánto puede medir en una línea una expresión entre paréntesis. Entre consultas van 1 o 2 líneas en blanco. Puedes quitar los espacios alrededor de los operadores (a=b) y colocar AND y OR al principio o al final de la línea.
Lo que no hace
Cambia espacios en blanco y las mayúsculas de las palabras clave. No ejecuta el SQL, no conoce tus tablas y no dice si la consulta es correcta. Los comentarios se conservan y el texto entre comillas no se toca. Para dejar un bloque igual, enciérralo entre /* sql-formatter-disable */ y /* sql-formatter-enable */. La biblioteca no admite procedimientos almacenados ni otro delimitador que ;. Una entrada de más de 2.000.000 de caracteres se rechaza con un aviso.
Adónde va tu SQL
A ningún sitio. La biblioteca forma parte del código de la página y se ejecuta en el navegador. Al formatear no se envía ninguna petición, y puedes comprobarlo en el panel de red. Copiar usa el portapapeles y la descarga crea un archivo en tu equipo.