Bases de datos y SQL

Cómo escribir y formatear consultas SQL legibles

BT
Equipo de ingeniería de datos de BrivTools
8 min de lectura
Una consulta SQL compacta frente a la misma consulta con SELECT, FROM y WHERE en líneas distintas

Por qué importa el formato

Una consulta analítica de ochenta líneas que llega en un solo bloque cuesta más de revisar. Las cláusulas alineadas muestran la estructura y facilitan detectar condiciones de unión ausentes, filtros inesperados y productos cartesianos. Separar columnas en líneas también hace más pequeños y claros los cambios en Git.

1. Una cláusula por línea

Coloca SELECT, FROM, JOIN, WHERE, GROUP BY, HAVING, ORDER BY y LIMIT en líneas propias. Aplica sangría a las columnas, las condiciones de unión y los predicados. Alinea AND y OR de forma que se pueda seguir la lógica verticalmente y conserva los paréntesis necesarios.

2. Convenciones de estilo

ConvenciónElección frecuenteMotivo
Palabras claveMayúsculasDistinguen cláusulas de identificadores.
Sangría2 o 4 espaciosEl ancho de tabulador puede variar por editor.
AliasAS explícito cuando el dialecto lo admiteFacilita leer los nombres derivados.
UnionesINNER o LEFT explícitoDeja clara la relación que se pretende.
Fin de sentenciaPunto y comaSepara sentencias en scripts y migraciones.

3. Comas al principio o al final

Con comas finales, añadir una columna al final suele obligar a editar también la línea anterior. Con comas iniciales, cada elemento a partir del segundo se puede añadir en una línea independiente. Configura una opción común y aplícala automáticamente.

Comas finales

SELECT
    id,
    email,
    created_at
FROM users

Comas iniciales

SELECT
    id
  , email
  , created_at
FROM users

4. Diferencias entre dialectos

Selecciona el motor de destino antes de formatear. Las comillas, la paginación y algunos operadores cambian según el dialecto.

OperaciónMySQLPostgreSQLSQL Server
Identificador delimitadoComillas invertidasComillas doblesCorchetes
Límite de filasLIMIT 10LIMIT 10TOP 10 u OFFSET/FETCH
Concatenación típicaCONCAT()||+

Consulta la documentación de MySQL, PostgreSQL y SQL Server para las reglas de identificadores.

5. La misma consulta antes y después

Antes

select u.id,u.email,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.created_at>='2026-01-01' and u.status='active' group by u.id,u.email having count(o.id)>3 order by orders desc limit 50;

Después

SELECT
    u.id,
    u.email,
    COUNT(o.id) AS orders
FROM users AS u
LEFT JOIN orders AS o
    ON o.user_id = u.id
WHERE u.created_at >= '2026-01-01'
  AND u.status = 'active'
GROUP BY
    u.id,
    u.email
HAVING COUNT(o.id) > 3
ORDER BY orders DESC
LIMIT 50;

La condición ON se lee junto a LEFT JOIN y los dos filtros se distinguen dentro de WHERE. La cláusula HAVING queda separada del filtro de filas previo a la agrupación.

6. Editor, CI y navegador

Configura el editor para formatear al guardar. Añade una comprobación en CI para aplicar el mismo estilo con independencia del equipo de cada persona. Si solo quieres ordenar una consulta que has copiado de un registro, el formateador SQL permite revisarla en el navegador. Un formateador no repara errores de lógica ni verifica el plan de ejecución.

7. Preguntas frecuentes

¿Es mejor escribir las palabras clave en mayúsculas?+
Respuesta breve:SELECT y select tienen el mismo significado como palabra clave. Las mayúsculas pueden ayudar a distinguir las cláusulas de las tablas y columnas.

Elige una convención para el equipo y aplícala automáticamente. Las reglas de mayúsculas de los identificadores dependen del motor y de si se escriben entre comillas.

¿El formato cambia el rendimiento de la consulta?+
Respuesta breve:Los cambios de sangría, saltos y caja de palabras clave que conservan los mismos tokens no cambian el significado de la consulta.

El beneficio está en la revisión. Una unión sin condición o un filtro en el lugar equivocado sí puede cambiar la corrección y el rendimiento. Revisa literales, identificadores y comentarios cuando uses un formateador.

¿Cómo doy formato a SQL sin compartir la consulta?+
Respuesta breve:Usa un formateador que procese el texto dentro del navegador. El formateador SQL de BrivTools trabaja localmente.

Una consulta puede contener nombres internos y valores de filtros. Revisa dónde se procesa antes de pegar código de producción.

¿Cómo organizo muchas columnas y uniones?+
Respuesta breve:Escribe una columna y una unión por línea y sitúa la condición ON debajo de cada JOIN.

Los alias coherentes ayudan a seguir las relaciones. Si la consulta sigue siendo difícil de leer, considera separar etapas con expresiones de tabla comunes (CTE) y comprobar el plan de ejecución.

Herramienta en el navegador

Da formato a SQL en tu navegador

Elige el dialecto y la sangría para revisar la consulta sin subirla a un servidor.

Varios dialectos
Sangría configurable
Procesamiento local
Abrir el formateador SQLNo necesitas una cuenta