Herramientas · Software

Formateador y minificador de SQL

Pegue una consulta SQL para darle formato legible: cada cláusula en su línea, columnas y condiciones ordenadas, subconsultas y CASE con sangría y palabras clave en mayúsculas. También puede minificarla. Funciona con SQL estándar, PostgreSQL, MySQL, SQL Server, Oracle y SQLite, y todo ocurre en su navegador.

Consulta SQL

Admite varias sentencias separadas por punto y coma. También puede abrir un archivo .sql (hasta 10 MB). Nada se envía a ningún servidor.

Resultado

Pegue una consulta SQL a la izquierda o cargue el ejemplo para ver el resultado.

Estas herramientas se ejecutan en su navegador y no envían lo que usted escribe a nuestros servidores. Aun así, evite pegar secretos reales (contraseñas, claves privadas, tokens de producción) en cualquier sitio web. Consulte los Términos de uso.

Por qué conviene dar formato al SQL

Una consulta escrita en una sola línea, o con la sangría que dejó cada persona que la tocó, es difícil de leer, de revisar y de comparar. Dar formato al SQL consiste en reorganizar el espacio en blanco (saltos de línea, sangría y espacios) y la capitalización de las palabras clave para que la estructura de la consulta se vea de un vistazo: qué columnas se piden, de qué tablas, con qué uniones y filtros. En SQL el espacio en blanco no tiene significado fuera de las cadenas de texto y los comentarios, por lo que el formato nunca cambia lo que hace la consulta.

Un formato coherente ayuda al code review (las diferencias entre versiones se limitan a lo que realmente cambió), a la depuración (se ve dónde falta una condición o un paréntesis) y al aprendizaje de consultas ajenas, como las que generan los ORM o las herramientas de BI, que suelen salir en una sola línea.

Cómo usar el formateador

  1. Pegue la consulta (o varias, separadas por ;) en el cuadro de entrada, o abra un archivo .sql de hasta 10 MB.
  2. Elija Formatear o Minificar. Al formatear puede escoger cómo se escriben las palabras clave, el tamaño de la sangría y si las comas van al final o al inicio de cada línea.
  3. Copie el resultado o descárguelo como archivo .sql. Si faltan o sobran paréntesis, la herramienta lo avisa.

Qué reglas aplica

ElementoCómo queda
Cláusulas (SELECT, FROM, WHERE, GROUP BY, HAVING, ORDER BY, LIMIT…)Cada una empieza en una línea nueva. Si su contenido es una sola expresión corta, queda en la misma línea (FROM users); si no, las expresiones van debajo, con sangría.
Columnas del SELECTUna por línea, con la coma al final (o al inicio, si lo elige). DISTINCT y TOP n se quedan junto a SELECT.
Uniones (JOIN)Cada unión en su línea, bajo FROM. La condición ON sigue en la misma línea si es corta y, si tiene varias condiciones, pasa a líneas propias con AND y OR.
Condiciones (WHERE, HAVING)Una condición por línea, empezando por AND u OR. El AND de un BETWEEN no parte la condición.
SubconsultasLas cortas se quedan en línea, (SELECT 1 FROM u); las largas se abren en un bloque con sangría y su paréntesis de cierre alineado.
CASECada WHEN y el ELSE en su línea cuando el bloque es largo.
CTE (WITH)Cada expresión de tabla común como un bloque con nombre, AS ( y su consulta con sangría.
INSERT, UPDATE, CREATE TABLELos valores y las columnas, uno por línea; las definiciones de columnas de CREATE TABLE, una por línea.
Listas largasLos IN (…) y los argumentos de funciones largos se reparten en varias líneas por párrafos.
Operadores de conjuntoUNION, INTERSECT y EXCEPT separados por una línea en blanco.
ComentariosSe conservan, en su línea o al final de ella. Los comentarios -- siempre terminan la línea: nunca se les pega código detrás.
Cadenas e identificadores entrecomilladosNo se tocan: ni su texto ni sus mayúsculas.

Ejemplo

Esta consulta, escrita en una sola línea:

select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id and o.status='paid' where u.active=1 and (u.country='CR' or u.country='PA') group by u.id,u.name having count(o.id)>0 order by orders desc limit 10

queda así con las opciones por defecto:

SELECT
  u.id,
  u.name,
  COUNT(o.id) AS orders
FROM
  users u
  LEFT JOIN orders o
    ON o.user_id = u.id
    AND o.status = 'paid'
WHERE
  u.active = 1
  AND (u.country = 'CR' OR u.country = 'PA')
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 0
ORDER BY orders DESC
LIMIT 10

Una consulta con expresiones de tabla comunes y un bloque CASE:

WITH recent AS (
  SELECT
    user_id,
    total
  FROM orders
  WHERE created_at > NOW() - INTERVAL '30 days'
),
big AS (
  SELECT
    user_id,
    SUM(total) AS spent
  FROM recent
  GROUP BY user_id
)
SELECT
  u.name,
  b.spent,
  CASE
    WHEN b.spent > 1000 THEN 'gold'
    WHEN b.spent > 300 THEN 'silver'
    ELSE 'bronze'
  END AS tier
FROM
  users u
  JOIN big b ON b.user_id = u.id
ORDER BY b.spent DESC

Y una inserción con resolución de conflictos (PostgreSQL):

INSERT INTO users (id, name, email)
VALUES
  (1, 'Ana', 'ana@example.com'),
  (2, 'Luis', 'luis@example.com')
ON CONFLICT (id) DO UPDATE SET name = excluded.name
RETURNING id

Con la opción de comas al inicio, las columnas se escriben así, algo habitual en equipos a los que les resulta más fácil comentar una columna sin tocar la anterior:

SELECT
  id
  , name
  , email
FROM users
WHERE active = 1

Opciones de formato

OpciónValoresCuándo usarla
Palabras claveMAYÚSCULAS · minúsculas · sin cambiosLas mayúsculas son la convención más extendida porque distinguen las palabras reservadas de los nombres de tablas y columnas. «Sin cambios» respeta lo que usted escribió.
Sangría2 espacios · 4 espacios · tabulaciónElija la de su equipo o su proyecto.
Comas al inicioSí · NoFacilitan agregar o quitar columnas al final de una lista sin editar la línea anterior y hacen más limpias las diferencias del control de versiones.
MinificarCon o sin comentariosReduce la consulta a una línea para incrustarla en código, en una variable de entorno o en una URL.

Convenciones que hacen más legible el SQL

  • Escriba las uniones de forma explícita con JOIN … ON en lugar de listar tablas separadas por comas y filtrarlas en el WHERE: separa la lógica de unión del filtrado.
  • Use alias cortos y significativos (u para users, o para orders) y califique las columnas con ellos, sobre todo cuando hay más de una tabla.
  • Evite SELECT * en código de producción: nombre las columnas que necesita, para que un cambio de esquema no altere en silencio lo que devuelve la consulta.
  • Prefiera las CTE a las subconsultas anidadas cuando haya varios niveles: dan nombre a cada paso y se leen de arriba abajo.
  • Un estilo, siempre el mismo. Acuerde las convenciones con el equipo (mayúsculas, sangría, posición de las comas) y automatice el formato; la herramienta resuelve la parte mecánica.
  • Comente el porqué, no el qué. Un comentario que explica una regla de negocio vale más que uno que repite lo que ya dice la cláusula.

Cuándo minificar

Minificar elimina los saltos de línea y los espacios que no hacen falta, y opcionalmente los comentarios, sin alterar las cadenas de texto. Es útil cuando la consulta se incrusta en una cadena de código, un archivo de configuración o un registro de una sola línea. No es recomendable para el código que se mantiene a mano: pierde toda su legibilidad. Si necesita volver a leerla, pegue la versión minificada en el formateador y recuperará la estructura (los comentarios eliminados no se pueden recuperar).

Atención con las líneas GO de SQL Server: son un separador de lotes que debe ir solo en su línea, y el minificador las respeta.

Qué no hace

  • No valida el SQL. Da formato a lo que usted escribe, sea correcto o no; no comprueba que las tablas existan ni que la sintaxis sea válida en su base de datos. Si faltan paréntesis, se lo indica, pero no los corrige.
  • No es específico de un dialecto. Reconoce las construcciones comunes de SQL estándar, PostgreSQL, MySQL, SQL Server, Oracle y SQLite. Las extensiones muy particulares se formatean de forma aproximada, siempre sin perder ni cambiar ninguna palabra.
  • El código procedimental (bloques BEGIN … END de PL/SQL o T-SQL, funciones y procedimientos almacenados) se trata como texto continuo: se normalizan los espacios, pero no se reorganiza su lógica.
  • Revise el resultado antes de sustituir código en producción. Aunque la herramienta se ha probado con decenas de miles de entradas para comprobar que conserva cada elemento, un buen hábito es comparar el resultado con la consulta original.

Si necesita comprobar un valor JSON que guarda en una columna, use el validador JSON; para patrones de búsqueda sobre texto, el probador de expresiones regulares.

Preguntas frecuentes

¿El formato cambia lo que hace la consulta?

No. En SQL los espacios y saltos de línea no tienen significado fuera de las cadenas de texto y los comentarios, y la herramienta no modifica ninguno de los dos. Lo único que cambia, si usted lo pide, es la capitalización de las palabras clave, que tampoco afecta a la ejecución.

¿Qué dialectos de SQL admite?

SQL estándar y las construcciones comunes de PostgreSQL, MySQL, SQL Server, Oracle y SQLite: JOIN de todo tipo, CTE, funciones de ventana, CASE, INSERT con varias filas, ON CONFLICT y ON DUPLICATE KEY UPDATE, cadenas con escapes, identificadores entre comillas, comillas invertidas o corchetes. Lo muy específico de un fabricante se formatea de forma aproximada.

¿Por qué mis nombres de tablas o columnas no se escriben en mayúsculas?

Porque solo las palabras clave del lenguaje y las funciones conocidas cambian de capitalización. Los nombres de tablas, columnas y alias se dejan tal como están, porque en algunas bases de datos las mayúsculas y minúsculas de un identificador pueden importar.

¿Qué hace la opción «comas al inicio»?

Coloca la coma al principio de cada línea de una lista (, columna) en lugar de al final. Permite agregar o comentar la última columna sin tocar la anterior y simplifica las diferencias en el control de versiones.

¿Puedo formatear varias consultas a la vez?

Sí. Sepárelas con punto y coma: cada sentencia se formatea por separado y las separa una línea en blanco. En SQL Server también se respetan las líneas GO como separador de lotes.

¿Se envía mi consulta a algún servidor?

No. El formato se hace en su navegador, de modo que puede usar consultas con nombres de tablas o datos internos sin que salgan de su equipo.