Formateador de SQL

Vuelve a hacer legible tu SQL

El SQL copiado de logs, ORM, herramientas de BI o del mensaje de un colega suele llegar en una sola línea larga: select u.id,u.name,count(o.id) from users u left join orders o on o.user_id=u.id where u.active=1 group by u.id order by 3 desc. El formateador de SQL lo separa en líneas, pone cada cláusula (SELECT, FROM, JOIN, WHERE, GROUP BY, ORDER BY) en su lugar y le agrega sangría para que puedas seguir la lógica.

El SQL legible es más fácil de depurar, revisar y documentar. Detectar una condición de join faltante o un WHERE mal ubicado es mucho más rápido cuando la consulta está bien ordenada.

Funciona con SQL estándar como el que usan MySQL, MariaDB, PostgreSQL, SQLite, SQL Server y otros.

Cómo usar el formateador de SQL

1. Pega tu consulta SQL.
2. Envía para darle formato.
3. Lee o copia el SQL formateado.

Ejemplos

Una consulta de reporte en una línea

Entrada:

select u.id, u.name, count(o.id) as orders from users u left join orders o on o.user_id = u.id where u.active = 1 group by u.id, u.name order by orders desc limit 10

Resultado:

select
  u.id,
  u.name,
  count(o.id) as orders
from
  users u
  left join orders o on o.user_id = u.id
where
  u.active = 1
group by
  u.id,
  u.name
order by
  orders desc
limit
  10

Cada cláusula va en su propia línea y cada columna lleva sangría. Las palabras clave conservan las mayúsculas o minúsculas que escribiste.

Un update

Entrada: UPDATE products SET price = price * 1.1 WHERE category_id IN (3, 7);

Resultado:

UPDATE
  products
SET
  price = price * 1.1
WHERE
  category_id IN (3, 7);

Usos comunes

• Leer consultas capturadas de los logs de la aplicación o de la depuración del ORM.
• Preparar SQL para revisiones de código y pull requests.
• Escribir documentación y tutoriales con ejemplos claros.
• Depurar consultas largas con muchos joins y subconsultas.
• Ordenar consultas antes de guardarlas en una herramienta de BI o un notebook.
• Leer consultas copiadas de los logs de la aplicación, donde suelen estar en una sola línea.

Consejos y cosas que conviene saber

• El formato solo cambia los espacios. No valida el SQL ni cambia los resultados.
• Quita los datos reales de clientes y las contraseñas de las consultas antes de pegarlas en cualquier sitio en línea.
• Elige un estilo único para tu equipo, como palabras clave en mayúsculas y una columna por línea.
• Cambia el estilo de los identificadores con el convertidor de mayúsculas y minúsculas y da formato a resultados JSON con el formateador de JSON.

Casos especiales y limitaciones

• Las palabras clave no se pasan a mayúsculas. Si el estilo de tu equipo las usa en mayúsculas, escríbelas así.
• Varias instrucciones separadas por punto y coma se formatean una después de otra.
• Los comentarios se conservan. Las cadenas y los identificadores entre comillas no se modifican.

Preguntas frecuentes

¿El formato cambia lo que hace mi consulta?

No. Solo cambian los espacios y los saltos de línea, así que la consulta devuelve los mismos resultados.

¿Qué dialectos de SQL se admiten?

Las palabras clave de SQL estándar que usan MySQL, PostgreSQL, SQLite, SQL Server y bases de datos similares se formatean bien.

¿Revisa si mi SQL tiene errores?

No. Le da formato al texto; ejecuta la consulta en tu base de datos para detectar errores.

¿Las palabras clave de SQL deben ir en mayúsculas?

No es obligatorio, pero las palabras clave en mayúsculas son una convención común que hace las consultas más fáciles de recorrer con la vista.

Herramientas relacionadas

• Validador y formateador de JSON: Valida contenido JSON y dale un formato legible.
• Convertidor de mayúsculas y minúsculas: Convierte tu texto a minúsculas, MAYÚSCULAS, camelCase y otros formatos.
• Minificador de JS: Minifica tu JS quitando todos los caracteres innecesarios.
• Convertidor de entidades HTML: Codifica o decodifica entidades HTML de cualquier texto.
• Separador de texto: Separa texto en ambos sentidos por saltos de línea, comas, puntos, etc.