Herramientas mencionadas en este artículo
Abre la herramienta en el navegador mientras lees y prueba el flujo al instante.
“Esta consulta es demasiado densa para leerla…”
Una consulta SQL enorme aplanada en una sola línea por un sistema en producción. Un procedimiento almacenado donde los JOIN anidados se acumulan como un laberinto. “¿Dónde se ramifica esta condición?” — mirar fijamente una pared de SQL así es una frustración conocida.
El Formateador de SQL reformatea el SQL pegado enteramente dentro de su navegador, así que incluso las consultas sensibles de producción nunca salen de su equipo.

Antes / después
select users.id,users.name,count(orders.id) from users left join orders on users.id=orders.user_id where users.deleted_at is null group by users.id,users.name order by users.id desc;
SELECT
users.id,
users.name,
COUNT(orders.id)
FROM users
LEFT JOIN orders ON users.id = orders.user_id
WHERE users.deleted_at IS NULL
GROUP BY
users.id,
users.name
ORDER BY users.id DESC;
Con solo ordenar el diseño, las condiciones faltantes, la dirección del JOIN y la granularidad de la agregación se vuelven mucho más fáciles de detectar.
Por qué la selección de dialecto es obligatoria, no opcional
Un formateador de SQL tiene que tokenizar y entender la sintaxis antes de poder decidir dónde cortar líneas y aplicar sangría. Eso significa que las extensiones específicas de cada dialecto afectan directamente si el formateo tiene éxito.
| Diferencia de dialecto | SQL estándar | MySQL | PostgreSQL | BigQuery |
|---|---|---|---|---|
| Comillas de identificador | "name" |
`name` |
"name" |
`project.dataset.table` |
| Concatenación de cadenas | || |
CONCAT() |
|| |
|| |
| Sintaxis de LIMIT | LIMIT n |
LIMIT n |
LIMIT n OFFSET m |
LIMIT n |
| Arrays/structs | no estándar | no compatible | ARRAY[...] |
STRUCT<...> |
Analizar los identificadores entre comillas invertidas de MySQL como SQL estándar, por ejemplo, puede desplazar los límites de token lo suficiente como para romper el formateo por completo. La mayoría de los informes de “el resultado del formateador se ve mal” se remontan a elegir el dialecto equivocado. La herramienta admite PostgreSQL, MySQL, MariaDB, SQL Server, BigQuery y más — hágalo coincidir con la base de datos con la que realmente trabaja, y el reformateo ocurre automáticamente cada vez que cambia de dialecto.
Opciones de formato, plantillas y scripts almacenados
El Formateador de SQL tiene once opciones que dan forma al resultado.
| Opción | Valores | Efecto |
|---|---|---|
| Mayúsculas/minúsculas de las palabras clave | Conservar / Mayúsculas / Minúsculas | por ejemplo, convertir select en SELECT |
| Sangría | 2 espacios / 4 espacios / Tabulación | ajustarse a la convención del equipo |
Posición de AND / OR |
Al principio / Al final | al principio de la línea, el diff es menor cuando se añade o se quita una condición |
| Ancho máximo de línea | Estrecho (30) / 50 / Ancho (80) | cuanto menor, más alto es el resultado y más a menudo se rompen las líneas dentro de paréntesis |
| Mayúsculas en funciones | Conservar / Mayúsculas / Minúsculas | alinea COUNT(*) y count(*); se indica aparte de las palabras clave |
| Mayúsculas en tipos de datos | Conservar / Mayúsculas / Minúsculas | alinea VARCHAR(10) y varchar(10) |
| Mayúsculas en identificadores (tablas, columnas) | Conservar / Mayúsculas / Minúsculas | los identificadores entre comillas ("Name", `name`) no se tocan |
| Alineación de palabras clave | Estándar / Izquierda / Derecha | izquierda y derecha (estilo river) alinean SELECT, FROM y WHERE en vertical y empiezan el contenido en la misma posición |
| Espacios en operadores | Con espacios / Compacto | el modo compacto elimina los espacios, como en a=1 y a+b |
| Punto y coma | Al final de la línea / En su propia línea | en su propia línea, tras cada sentencia sigue una línea con solo ; |
| Líneas en blanco entre consultas | 1 / 2 / 3 | número de líneas en blanco entre sentencias al formatear varias |
Cuando tu SQL parece de otro dialecto (ON CONFLICT, TOP, AUTO_INCREMENT, etc.), la herramienta indica «esto parece sintaxis de PostgreSQL» y ofrece cambiar. Nunca cambia por sí sola y no dice nada si el SQL solo usa sintaxis común a todos los dialectos.
El SQL real también contiene construcciones que, tal cual, serían errores de sintaxis. Estas se pueden formatear sin romper su contenido:
- Variables de plantilla:
{{ ref('orders') }},{% if … %}y{# … #}de dbt y Jinja, y${var}de shell/JS, se tratan como una sola unidad. GOde SQL Server: con el dialecto SQL Server (T-SQL) seleccionado, una línea que contiene soloGOdivide el script en lotes y cada lote se formatea por separado. Ungodentro de una cadena o un comentario no se considera separador.DELIMITERde MySQL: los scripts con líneas comoDELIMITER //se dividen en sentencias según cada delimitador antes de formatear, así que//nunca se parte.
El botón inverso «minificar» comprime espacios, saltos de línea y comentarios en una sola línea. El contenido de los literales de cadena no se modifica (los comentarios se eliminan). Úselo cuando quiera incrustar una consulta en una sola línea en un registro o en un archivo de configuración.
Qué revisar durante la revisión de SQL
Una vez formateado, algunas comprobaciones adicionales elevan la calidad de la propia revisión.
- ¿La cláusula
WHEREhace lo que cree que hace? - ¿Falta alguna condición de
JOIN? - ¿Es correcta la elección entre
LEFT JOINeINNER JOIN? (Consulte JOIN en SQL: referencia completa para el desglose completo.) - ¿Es la granularidad de
GROUP BYla que espera? - ¿Están presentes
ORDER BY/LIMITdonde se necesitan? - ¿Tienen las subconsultas y CTE cada una un propósito claro?
El SQL extraído de logs suele tener todos los marcadores de posición expandidos, lo que lo hace especialmente largo. Formatear antes de leer puede reducir sustancialmente el tiempo de investigación.
Formatear hace más que mejorar la apariencia
El verdadero beneficio no es cosmético — aparece en tres lugares:
- Detección temprana de errores de sintaxis — un fallo de análisis significa que algo está roto; es una comprobación de cordura gratuita antes de ejecutar la consulta
- Diffs estables — con una regla de formateo fija, el diff de un cambio de consulta refleja solo la edición significativa
- Descifrar SQL generado por máquina — una consulta de una sola línea que escupió un ORM solo se vuelve legible una vez formateada
El primer punto es fácil de pasar por alto: paréntesis desbalanceados o una coma faltante aparecerán como un fallo de formateo, detectando errores antes de ejecutar la consulta.
Limpiar, incrustar y reescribir para otra base de datos
Además de formatear, el Formateador de SQL puede ordenar el SQL pegado, incrustarlo en código y reescribirlo para otra base de datos.
Limpiar e incrustar
- Quitar comentarios: elimina
--y/* */. Los/*! … */de MySQL y los hints del optimizador/*+ … */se conservan porque cambian el comportamiento - Cambiar las comillas de los identificadores: entre
`x`(MySQL),"x"(PostgreSQL / SQLite) y[x](SQL Server). Las comillas solo se quitan si el nombre son minúsculas, dígitos y_, y no es palabra reservada - Envolver como cadena para código: JavaScript (template literal), Python (comillas triples), Java (bloque de texto), Go, PHP, C# o JSON
- Extraer el SQL de una cadena de código: lee concatenaciones como
"SELECT … " + "FROM …"y escapes\n, y devuelve el SQL, para formatear directamente una consulta copiada de un log o del código
Reescribir para otra base de datos
Entre MySQL, PostgreSQL, SQLite y SQL Server reescribe lo que se puede arreglar de forma mecánica. Nunca toca cadenas, comentarios ni identificadores entrecomillados.
| Elemento | Ejemplo |
|---|---|
| Comillas de identificadores | `id` → "id" → [id] |
| Límite de filas | LIMIT 10, 5 → LIMIT 5 OFFSET 10; hacia SQL Server, TOP (n) / OFFSET … FETCH |
| Sustituir NULL | IFNULL(a, 0), ISNULL(a, 0) ⇄ COALESCE(a, 0) |
| Hora actual | NOW() ⇄ GETDATE() ⇄ CURRENT_TIMESTAMP |
| Agregar cadenas | GROUP_CONCAT(x SEPARATOR ',') ⇄ STRING_AGG(x, ',') |
| Conversiones | a::int → CAST(a AS int) |
| Tipos y autoincremento (CREATE TABLE) | AUTO_INCREMENT ⇄ SERIAL ⇄ IDENTITY(1,1), TINYINT(1) → BOOLEAN, DATETIME → TIMESTAMP, … |
Lo que no se puede arreglar de forma mecánica se deja tal cual y se lista en «Revisar a mano»: ILIKE (cambiado a LIKE, con un aviso sobre mayúsculas), || (significa OR en MySQL), RETURNING, upserts (ON CONFLICT frente a ON DUPLICATE KEY UPDATE), GROUP_CONCAT con ORDER BY y los escapes con barra invertida de MySQL. El resultado es un punto de partida. Los dialectos difieren en muchos detalles, así que pruébalo siempre en la base de datos real.
Preguntas frecuentes
¿Admite SQL de MySQL y PostgreSQL?
Sí — se admiten SQL estándar, MySQL, PostgreSQL, MariaDB, SQL Server y BigQuery. Si su SQL usa sintaxis específica de un dialecto, verifíquela de todos modos antes de ejecutarla.
¿Formatear cambia lo que hace el SQL?
No. Formatear solo ajusta espacios, saltos de línea, sangría y mayúsculas/minúsculas de palabras clave — el significado de la consulta (su resultado) no cambia. Aun así, confirme siempre que la versión formateada coincide con su intención antes de ejecutarla.
¿Qué pasa si elijo el dialecto equivocado?
El entrecomillado de identificadores y la interpretación de palabras clave pueden cambiar, provocando sangría rota o saltos de línea inesperados. Si el resultado del formateo se ve mal, revise primero la selección de dialecto.
¿Es seguro pegar SQL con datos sensibles?
Sí. El formateo ocurre enteramente en su navegador sin llamadas de red — los nombres de tabla y columna nunca salen de su equipo.
¿Puedo convertir SQL de MySQL para PostgreSQL o SQL Server?
Sí, en la parte mecánica: comillas, LIMIT, IFNULL / COALESCE, NOW(), GROUP_CONCAT / STRING_AGG, conversiones :: y tipos de CREATE TABLE y AUTO_INCREMENT. Lo que cambia de significado, como ILIKE, ||, upserts y RETURNING, no se reescribe; se lista como elementos para revisar a mano. No se garantiza que el resultado se comporte igual, así que pruébalo en la base de datos real antes de ejecutarlo.
Resumen
- El formateador en sí es una delegación de una línea a una biblioteca, pero la selección de dialecto es el parámetro que realmente determina el resultado
- Una sola diferencia en el entrecomillado de identificadores puede cambiar cómo se analiza la consulta — haga coincidir el dialecto con su base de datos real
- Formatear no es solo cosmético: detecta errores de sintaxis temprano, estabiliza los diffs y descifra SQL generado por máquina
La próxima vez que extraiga una consulta de un log, páselo primero por el formateador.
