Formateador SQL

Embellece, minifica o formatea consultas SQL en cualquier dialecto

Dialecto

Sangría

Palabras clave en mayúscula

Cómo funciona

Formateador SQL — Embellece, minifica o formatea consultas SQL en cualquier dialecto. Todo el procesamiento ocurre en tu navegador — sin subida, sin registro, sin email. Gratis para siempre.

Última actualización: 2026-05-06

Editor's note

Usamos esto sobre logs de producción donde alguien embebió una query de 400 caracteres en un campo string y tenemos que leerla antes de que el incident bridge se llene. El desplegable de dialecto no es un detalle de pulido: es el punto entero. El RETURNING de PostgreSQL, las comillas invertidas de MySQL para identificadores, el quoting con corchetes de T-SQL y el QUALIFY de BigQuery cada uno tiene su set de keywords, y elegir el dialecto equivocado produce una salida que se ve bien, compila en tu cabeza y luego falla en cuanto la pegas en psql. Nos obsesiona el dialecto por defecto correcto porque "se ve formateada" y "está formateada correctamente" no son lo mismo.

Nos negamos a subir tu query, aunque fuera marginalmente más fácil correr el formateador en servidor. El SQL de producción es la cadena más reveladora del esquema en tu base de código: nombres de tabla, nombres de columna, lógica de negocio y a veces los IDs literales de clientes que estabas depurando. No existe una versión de "prometemos no loguearlo" que nos creamos, así que corremos sql-formatter en el navegador y se acabó la conversación. Si el compromiso fuera mejor formato a cambio de tu esquema en el pipeline de otro, seguiríamos eligiendo el navegador cada vez.

Acerca de Formateador SQL

Pegar una query SQL de 500 líneas que llegó como una cadena continua no es manera de depurar un reporte lento. Este formateador SQL embellece cualquier consulta con indentación consistente, palabras clave en mayúsculas y cláusulas alineadas, de modo que JOIN, WHERE, GROUP BY y las expresiones CASE se vuelven escaneables al instante. Es la misma librería (sql-formatter) que respalda los plugins populares de IDE, expuesta como una herramienta que puedes usar sin instalar nada.

Elige el dialecto que case con tu base de datos para obtener el reconocimiento de keywords más preciso: SQL estándar, MySQL, PostgreSQL, SQLite, MariaDB, T-SQL (SQL Server), BigQuery, Redshift, Snowflake y Trino están todos soportados. El dialecto importa porque cada motor tiene palabras reservadas, comillas de identificadores y funciones built-in que los demás no tienen — formatear con el dialecto correcto mantiene tus nombres de CTE, expresiones de path JSON y keywords específicas en buen estado.

El formateo solo ajusta espacios en blanco y mayúsculas. Identificadores, literales, comentarios y la semántica real de la query se preservan exactamente, así que la salida formateada produce resultados idénticos al original. Y como todo se ejecuta localmente en tu navegador, la query (que a menudo contiene nombres reales de schema, IDs y lógica de negocio) jamás cruza la red.

Cómo usar Formateador SQL

Pega tu consulta SQL (en una sola línea o multilínea) en el cuadro de entrada.
Elige el Dialecto que case con tu base de datos para un manejo preciso de keywords e identificadores.
Configura la Indentación (2 o 4 espacios son típicos) para que case con el estilo de tu equipo.
Activa "Palabras clave en mayúsculas" si tu guía de estilo capitaliza SELECT, FROM, JOIN.
Pulsa Formatear para una disposición legible, o Minificar para colapsar la query en una sola línea para embeberla en código.
Copia el resultado a tu editor, script de migración o revisión de pull request.

Casos de uso comunes

Limpiar una query que llegó como una sola línea en una entrada de log o en una respuesta JSON de API.
Estandarizar el SQL dentro de una code review para que los revisores detecten el cambio real de lógica, no el ruido de formato.
Reformatear el SQL autogenerado por un ORM en algo que un humano pueda depurar para mejorar el rendimiento.
Minificar una query antes de embeberla como string literal en código de aplicación, y luego volver a formatearla cuando depures.
Producir queries objetivo de EXPLAIN legibles para un runbook o un postmortem de incidente.

Consejos y errores comunes

Si keywords como "QUALIFY" o "PIVOT" no se ponen en mayúsculas, probablemente elegiste el dialecto equivocado: solo se reconocen como keywords en BigQuery / Snowflake / T-SQL respectivamente.
Los punto y coma finales y los comentarios se preservan. Si tu herramienta downstream los rechaza, quítalos después de formatear.
El formateador no puede corregir un error de sintaxis. Si una query se niega a formatearse, pásala primero por el parser de tu base de datos para encontrar el paréntesis o coma que falta.
Para queries muy largas, el formateo es más útil cuando las keywords quedan alineadas y indentas con generosidad (4 espacios): la legibilidad gana sobre la compactación cuando la query ya no cabe en una pantalla.

Preguntas frecuentes

¿Qué dialectos SQL están soportados?

SQL estándar más MySQL, PostgreSQL, SQLite, MariaDB, T-SQL (SQL Server), BigQuery, Redshift, Snowflake y Trino. Elige el dialecto para el manejo más preciso de palabras clave e identificadores.

¿Mi consulta se envía al servidor?

No. El formateo se ejecuta enteramente en tu navegador con la librería sql-formatter. La consulta nunca sale de tu dispositivo.

¿Cambiará el significado de mi consulta?

No — el formateador solo ajusta espacios y mayúsculas. La semántica SQL, identificadores y literales de cadena se preservan exactamente.

¿Puedo formatear sintaxis específica de dialecto como operadores JSON de PostgreSQL o literales STRUCT de BigQuery?

Sí — elige el dialecto correspondiente y operadores como ->>, #>>, [].* y STRUCT(...) conservan su significado. El formateo solo realinea espacios; nunca reescribe operadores ni tipos.

¿El formateador valida que el SQL sea correcto?

Solo de forma laxa. Parsea lo suficiente para saber dónde empiezan y acaban las cláusulas, pero no es un parser SQL completo: las queries inválidas pueden salir igualmente "formateadas". Usa EXPLAIN o un dry-run de tu base de datos para validación real.

¿Minificar producirá una query más corta que mi one-liner escrito a mano?

Normalmente sí: elimina espacios redundantes, normaliza comas y borra líneas en blanco, pero preserva los comentarios a menos que los quites tú. Útil cuando necesitas la query como string de una sola línea en código.