“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.

Formateador de SQL: cómo hacer legibles las consultas, y por qué importa elegir el dialecto

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.
  • GO de SQL Server: con el dialecto SQL Server (T-SQL) seleccionado, una línea que contiene solo GO divide el script en lotes y cada lote se formatea por separado. Un go dentro de una cadena o un comentario no se considera separador.
  • DELIMITER de MySQL: los scripts con líneas como DELIMITER // 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 WHERE hace lo que cree que hace?
  • ¿Falta alguna condición de JOIN?
  • ¿Es correcta la elección entre LEFT JOIN e INNER JOIN? (Consulte JOIN en SQL: referencia completa para el desglose completo.)
  • ¿Es la granularidad de GROUP BY la que espera?
  • ¿Están presentes ORDER BY / LIMIT donde 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:

  1. 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
  2. Diffs estables — con una regla de formateo fija, el diff de un cambio de consulta refleja solo la edición significativa
  3. 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.