Esta página es la guía canónica para formatear y minificar SQL en Dev Tools Suite. Use el SQL Formatter interactivo de arriba mientras lee, o salte a una sección abajo. Todo el análisis y formateo se ejecuta en su navegador con sql-formatter — consultas, nombres de esquema y datos de muestra nunca se suben a un servidor.

SQL Formatter embellece SQL multilínea para humanos y minifica SQL para transporte. Pone en mayúsculas las palabras clave automáticamente (SELECT, FROM, WHERE), aplica sangría según cláusulas y respeta la gramática específica del dialecto de la biblioteca sql-formatter — el mismo motor que usan muchas extensiones de IDE y formateadores CLI.

Qué obtiene

• Espacio de trabajo dual simétrico: entrada SQL a la izquierda, salida formateada o minificada a la derecha
• 13 analizadores de dialecto agrupados como Núcleo relacional, Almacenes en la nube, Big data y Empresa
• Modos Beautify y Minify con autoformato en vivo (con debounce) y botón Process explícito
• Selector de dialecto y casilla Strip comments en el encabezado del panel — sin fila extra que robe altura del editor
• Salida formateada plegable para árboles SELECT grandes (modo Beautify)
• Errores de parseo con indicaciones de línea y columna cuando el analizador del dialecto no puede leer su entrada
• Compartir URL opcional: ?mode=minify&dialect=postgresql persiste modo y dialecto

Use esta herramienta cuando

• Pega SQL ad hoc de un log, herramienta BI u ORM y necesita sangría legible antes de revisar
• Incrusta SQL en código de aplicación y quiere una cadena minificada de una línea
• Trabaja con PostgreSQL, Snowflake, BigQuery, Spark u Oracle y necesita que el analizador reconozca palabras clave del dialecto
• Quiere eliminar comentarios de bloque y línea antes de hacer commit o enviar una consulta

No espere

• Validación semántica — el éxito del formateo no significa que la consulta se ejecutará en su servidor
• Planificación automática de consultas, lint de rendimiento o reescrituras conscientes del esquema
• Preservación perfecta de cada extensión exótica del proveedor no cubierta por el dialecto seleccionado
• EXPLAIN o ejecución en servidor — es solo una herramienta de diseño y espacios en blanco

Los controles están en el encabezado del panel SQL QUERY para que los editores de entrada y salida mantengan la misma altura. No hay fila de opciones separada debajo de la barra de herramientas.

Atajos de teclado

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — Limpiar espacio de trabajo

Elija siempre el dialecto que coincida con donde se ejecutará la consulta. El analizador usa listas de palabras clave, nombres de funciones y reglas de comentarios distintas por dialecto. Standard SQL es un valor predeterminado seguro para fragmentos ANSI genéricos.

Cassandra CQL no está admitido — no forma parte del conjunto de dialectos sql-formatter. Use un formateador específico de CQL para cargas Cassandra.

Beautify y Minify comparten el mismo selector de dialecto y casilla Strip comments pero producen formas de salida distintas.

Ejemplo

Entrada: select id, name from users where active = 1 — Beautify produce líneas con sangría y SELECT / FROM / WHERE en mayúsculas. Minify con Strip comments desactivado produce una línea: select id, name from users where active = 1.

1. Abra SQL Formatter desde la barra lateral en Formatters.
2. Pegue SQL en el editor izquierdo, suba un archivo .sql desde la barra de sesión o arrastre un archivo al estado vacío.
3. Elija el dialecto que coincida con su base de datos (p. ej. snowflake para una consulta de hoja Snowflake).
4. Opcionalmente marque Strip comments si la entrada contiene anotaciones -- o /* */ que no quiere en la salida.
5. Seleccione Beautify para SQL legible o Minify para una línea compacta.
6. Revise la salida a la derecha. Corrija cualquier banner de error de parseo — haga clic para cerrar tras editar la entrada.
7. Copie, descargue o intercambie la salida de vuelta a la entrada para otro paso.
8. Comparta un enlace con ?dialect=bigquery&mode=minify cuando quiera que colaboradores abran la misma configuración.

Los archivos de migración Flyway, Liquibase y ORM son más fáciles de revisar cuando las listas SELECT, bloques JOIN y cláusulas WHERE se dividen en líneas consistentes.

Flujo de trabajo

1. Configure el dialecto en postgresql, transactsql, mysql o sqlite según su destino de migración.
2. Pegue el SQL de migración crudo de un diff generado o salida de ORM.
3. Beautify con Strip comments desactivado si los comentarios en línea documentan la intención.
4. Copie el SQL formateado de vuelta al archivo de migración antes de abrir el PR.

Consejo

El formateo no valida contra su esquema en vivo. Ejecute migraciones en una base de datos de staging tras cambios cosméticos.

Los ingenieros de analítica suelen copiar SQL de consolas Snowflake, BigQuery o Redshift con casing inconsistente y líneas colapsadas.

Snowflake / BigQuery / Redshift

• Seleccione snowflake, bigquery o redshift antes de Beautify para que las funciones del almacén se analicen correctamente.
• Use Strip comments al exportar desde un notebook que incluye notas de sesión --.
• Para listas SELECT muy anchas, use los controles de plegado de salida (Expand all / Collapse all) tras Beautify.

Spark / Trino / Hive

• Elija spark para notebooks Databricks y pipelines Spark SQL.
• Elija trino para consultas federadas compatibles con Presto entre catálogos.
• Elija hive para scripts HiveQL heredados — la cobertura del analizador sigue las reglas del dialecto Hive de sql-formatter.

El código de aplicación suele almacenar SQL como cadena de plantilla. Minify reduce bytes y escapes cuando necesita una línea dentro de JavaScript, Python o Go.

1. Pegue la versión legible del SQL en el panel de entrada.
2. Active Strip comments si los desarrolladores dejaron notas de depuración en la consulta.
3. Cambie al modo Minify.
4. Copie la salida de una línea en su literal de cadena (cuidado con el escape de comillas en su lenguaje).

Si necesita SQL legible en el código fuente pero compacto en tiempo de ejecución, conserve la versión embellecida en docs y minifique solo el artefacto de compilación.

Normalice SQL antes de la revisión para que los diffs se centren en la lógica, no en ruido de espacios.

• Embellezca ambos lados de una comparación cuando un compañero pegue SQL de una línea en un ticket.
• Use palabras clave en mayúsculas como estilo consistente — el formateador lo aplica automáticamente en modo Beautify.
• Canalice la salida a Text Diff tras formatear dos versiones si necesita un diff semántico del texto de la consulta.

La casilla Strip comments aplica a Beautify y Minify. Cuando está activada, la herramienta elimina comentarios antes del formateo con reglas conscientes del dialecto donde estén implementadas.

Cuando Strip está desactivado (Minify)

Minify aún colapsa espacios en blanco a una línea pero mantiene el texto del comentario. Úselo cuando los comentarios deben enviarse con la consulta.

Cuando el analizador falla, un banner rojo muestra Parse error con números de línea y columna. El editor de entrada resalta la línea del error cuando está disponible.

Correcciones comunes

1. Dialecto incorrecto — cambie al motor que realmente usa (p. ej. plsql para paquetes Oracle, no Standard SQL).
2. Cadena o paréntesis sin cerrar — equilibre comillas y paréntesis cerca de la línea indicada.
3. Coma final o cláusula incompleta — complete listas SELECT y CTEs antes de formatear.
4. Contenido no SQL pegado — elimine envoltorios de shell o JSON alrededor de la consulta.
5. Sintaxis específica del dialecto en modo genérico — pruebe el dialecto del proveedor o simplifique extensiones no admitidas.

Si una consulta válida sigue fallando, el analizador sql-formatter puede no cubrir esa variante de sintaxis. Reporte upstream o formatee manualmente un subconjunto simplificado.

SQL Formatter se ejecuta 100 % en su navegador. La biblioteca sql-formatter se carga dinámicamente; el formateo se ejecuta en el hilo principal en JavaScript.

• Ningún texto de consulta se envía a servidores de Dev Tools Suite
• Entrada, salida, dialecto y preferencia Strip comments pueden persistir en localStorage en su dispositivo
• Los parámetros de URL (?dialect=, ?mode=) solo reflejan configuración — no contienen el cuerpo SQL
• Limpie el espacio de trabajo (Ctrl/Cmd+L) tras trabajar con datos de producción o PII

• Haga coincidir el dialecto con el entorno de ejecución antes de Beautify — éxito del formateo ≠ éxito en tiempo de ejecución
• Use Beautify para humanos, Minify para máquinas
• Mantenga Strip comments desactivado cuando los comentarios documentan reglas de negocio; actívelo para exportaciones y cadenas incrustadas
• Verifique la salida minificada en una base de staging cuando haya cadenas con comillas dólar o literales exóticos
• Use historial de sesión y carga de archivos para scripts grandes en lugar de pegar en apps de chat que alteran comillas
• Combine con Text Diff al comparar dos versiones formateadas de la misma consulta de informe