Español
Embellece consultas SQL con sangría inteligente.
Última actualización
Un formateador de SQL toma consultas densas, escritas en una sola línea o generadas automáticamente, y las reescribe con sangría y saltos de línea consistentes. Desarrolladores y analistas lo usan al revisar joins, depurar filtros, limpiar la salida de un ORM, compartir consultas en tickets o documentación, o repasar planes de ejecución.
Dar formato no cambia *lo que hace* la consulta — cambia lo fácil que resulta leerla. Una vez que el diseño es consistente, la relación entre SELECT, FROM, JOIN, WHERE, GROUP BY, HAVING y ORDER BY se inspecciona mucho más cómodamente, sobre todo en consultas que mezclan subconsultas y CTEs.
SQL tiene muchos *dialectos* — PostgreSQL, MySQL, SQLite, T-SQL (Microsoft SQL Server), Oracle y BigQuery extienden el estándar con su propia sintaxis. Un buen formateador entiende el dialecto que elijas para no romper la sintaxis específica del motor.
SELECT elige columnas, FROM elige tablas, WHERE filtra filas, GROUP BY agrupa y ORDER BY ordena.RETURNING, LIMIT, TOP y los identificadores entre corchetes ([col] vs "col") no son portables entre bases de datos.Suelta tu SQL en el cuadro de entrada. Funciona con SQL en una sola línea, generado por un ORM o parcialmente formateado.
Selecciona PostgreSQL, MySQL, SQLite o T-SQL para que el formateador respete palabras clave específicas como LIMIT, TOP o RETURNING.
Elige el caso de las palabras clave (mayúsculas es lo habitual) y el ancho de sangría (2 o 4 espacios). La mayoría de equipos usa palabras clave en mayúsculas con sangría de 2 espacios.
Cada cláusula queda en su propia línea, los joins quedan alineados y las subconsultas indentadas. Los comentarios se conservan.
Pega la consulta formateada en tu migración, en una raw query del ORM o en tu herramienta de BI. Todo se procesa en tu navegador.
Las cláusulas que verás en el 95% de las consultas SELECT, en el orden en que se procesan conceptualmente. Referencias oficiales: PostgreSQL SELECT, MySQL SELECT.
| Cláusula | Para qué sirve | Ejemplo |
|---|---|---|
SELECT | Indicar qué columnas o expresiones devolver | SELECT id, name |
FROM | Indicar la(s) tabla(s) origen | FROM users |
JOIN ... ON | Combinar filas con otra tabla | JOIN orders ON orders.user_id = users.id |
WHERE | Filtrar filas antes de agrupar | WHERE active = true |
GROUP BY | Agrupar filas que comparten valores | GROUP BY country |
HAVING | Filtrar grupos ya agregados | HAVING COUNT(*) > 10 |
ORDER BY | Ordenar el resultado | ORDER BY created_at DESC |
LIMIT / OFFSET | Paginar el resultado | LIMIT 20 OFFSET 40 |
WITH ... AS | Common Table Expression (CTE) — darle nombre a una subconsulta | WITH active AS (...) |
select id,name from users where active=true order by created_at desc limit 10SELECT id, nameFROM usersWHERE active = trueORDER BY created_at DESCLIMIT 10;Cada cláusula queda en su propia línea y la lista de columnas aparece indentada. Revisar esta consulta en una code review se vuelve 10 veces más cómodo.
select u.name,o.total from users u join orders o on o.user_id=u.id where o.total>100SELECT u.name, o.totalFROM users uJOIN orders o ON o.user_id = u.idWHERE o.total > 100;Usar alias de tabla (users u, orders o) deja la lista de columnas más corta. La línea JOIN ... ON deja explícita la relación entre tablas.
select * from users where id in (select user_id from enrollments where course_id=5)SELECT *FROM usersWHERE id IN ( SELECT user_id FROM enrollments WHERE course_id = 5);Indentar la consulta interna deja la dependencia a la vista. Muchas subconsultas se pueden reescribir como JOINs o CTEs en cuanto se ve la estructura.
LIMIT 10 en PostgreSQL, TOP 10 en T-SQL y FETCH FIRST 10 ROWS ONLY en SQL estándar hacen lo mismo.SELECT, FROM, WHERE) e identificadores en minúsculas, porque el contraste visual hace que la estructura de la consulta resalte. Elige un estilo y mantenlo.