Cómo formatear una consulta SQL
- Pega tu consulta SQL en el recuadro de arriba, un
SELECTcon varios JOIN, unINSERT, un fragmento de procedimiento almacenado, o cualquier otra cosa. - Elige tu dialecto SQL (PostgreSQL, MySQL, SQLite, T-SQL, o SQL genérico si no estás seguro) y un tamaño de sangría, luego pulsa Formatear SQL.
- La consulta embellecida aparece al instante debajo, con nueva sangría y saltos de línea para mejorar la legibilidad. Si la consulta tiene un problema estructural genuino (como paréntesis desequilibrados), obtienes un error claro en lugar de una salida ilegible.
- Pulsa Copiar al portapapeles para llevarte el resultado, o pega una consulta nueva y ejecútala de nuevo.
Sin archivo que subir, sin cliente SQL de escritorio que abrir, solo pega y lee.
Por qué formatear consultas SQL
Una consulta generada por un ORM, exportada de una herramienta de base de datos, o pegada de un mensaje de Slack suele ser una única línea larga sin cortar, cada condición JOIN, cláusula WHERE y subconsulta apretados sin ninguna estructura visual. Leerla, revisarla en un pull request, o averiguar dónde termina una subconsulta y retoma la consulta externa significa forzar la vista sobre un muro de texto. Reformatearla a mano es lento y fácil de equivocar sutilmente (contar mal un paréntesis de cierre, desalinear un JOIN).
Esta herramienta toma esa misma consulta y la organiza como la escribiría a mano una persona: cada cláusula (SELECT, FROM, WHERE, JOIN, ORDER BY) en su propia línea, subconsultas anidadas con un nivel más de sangría, listas de columnas partidas una por línea, al instante, en cualquiera de los cuatro dialectos principales que realmente use tu consulta.
El dialecto importa más de lo que parece
SQL no es un solo lenguaje: PostgreSQL, MySQL, SQLite y T-SQL (SQL Server) tienen cada uno sus propias particularidades (TOP N de T-SQL en lugar de LIMIT, identificadores entre comillas invertidas en MySQL, operadores específicos de PostgreSQL) que un formateador genérico puede analizar o etiquetar mal. La opción de dialecto de esta herramienta alimenta tu elección directamente al analizador subyacente, así que la sintaxis específica del dialecto se reconoce correctamente en lugar de adivinarse. Si no estás seguro de qué dialecto usa tu consulta, el valor por defecto “SQL genérico” maneja razonablemente bien la sintaxis ANSI SQL común.
Privado, porque las consultas de producción nunca salen de tu dispositivo
Una consulta SQL suele ser una de las cosas más sensibles que un desarrollador pega en una herramienta web cualquiera, puede contener nombres reales de tablas y columnas que revelan tu esquema, o incluso valores literales (un correo, un ID de cuenta) incrustados en una cláusula WHERE durante una depuración. Muchos sitios de “formateador de SQL online gratis” en realidad proxean el contenido pegado a través de un backend de todas formas. Esta herramienta ejecuta todo el paso de formateo usando la librería de código abierto sql-formatter cargada una vez en tu propia pestaña del navegador, nada se transmite, registra ni almacena, y funciona igual sin conexión una vez cargada la página.
Usos habituales
- Embellecer una consulta larga de una sola línea copiada del registro de un ORM o el historial de una GUI de base de datos antes de pegarla en un pull request o documentación.
- Revisar la consulta de un colega en una revisión de código reformateándola en una forma más fácil de leer de un vistazo.
- Volver a sangrar una consulta con subconsultas anidadas para que quede claro qué
SELECTpertenece a qué nivel. - Estandarizar el formato en las migraciones o scripts de siembra SQL escritos a mano de un proyecto.
- Formatear primero el payload JSON de una consulta, consulta el compañero Formateador y Validador de JSON si parte de lo que estás mirando es un valor de columna JSON en lugar de sintaxis SQL.
- Comparar dos versiones de una consulta para ver exactamente qué cambió, consulta el compañero Comparador de Textos para diferenciar una consulta antes y después de una edición.
- Limpiar la hoja de estilos de un proyecto de la misma forma que limpiarías una consulta, consulta el Minificador y Formateador de CSS si lo que necesita formato es CSS en lugar de SQL.

