QueryOptima SQL Analyzer

Analiza consultas SQL de PostgreSQL desde Visual Studio Code con QueryOptima: detecta antipatrones de rendimiento, explica sus riesgos y propone una reescritura sugerida. También puede ser usada por GitHub Copilot en modo Agent mediante un Agent Skill y una Language Model Tool.

La extensión no ejecuta tu SQL contra ninguna base de datos. Envía la consulta que tú confirmas al backend de QueryOptima, que realiza un análisis estático del texto.

Qué puedes hacer

• Analizar el SQL seleccionado o el archivo SQL activo.
• Ver en la vista QueryOptima del Explorador los hallazgos, su severidad, la evidencia y el consejo de cada regla.
• Consultar el SQL sugerido, con sus precondiciones y advertencias de equivalencia, en un documento aparte (nunca reemplaza tu archivo).
• Recibir diagnósticos en el editor cuando el backend entrega coordenadas fiables.
• Pedir a GitHub Copilot (modo Agent) que revise una consulta usando QueryOptima.
• Encontrar tus análisis también en tu historial de QueryOptima Web.

Requisitos

• Visual Studio Code 1.140.0 o posterior.
• Una cuenta de QueryOptima (la misma de QueryOptima Web).
• Conexión a Internet.

Instalación

1. Abre la vista Extensiones (Ctrl+Shift+X).
2. Busca QueryOptima SQL Analyzer.
3. Pulsa Instalar.

Primeros pasos

1. Si aún no tienes cuenta, créala en queryoptima.vercel.app y confirma tu correo si se te solicita.
2. En la paleta de comandos (Ctrl+Shift+P) ejecuta QueryOptima: Iniciar sesión e introduce tu correo y contraseña.
3. Abre un archivo .sql, selecciona una consulta SELECT o UNION, y ejecuta QueryOptima: Analizar SQL seleccionado (también en el menú contextual del editor).
4. Confirma el aviso de envío. Revisa los resultados en la vista QueryOptima del Explorador.

La extensión viene configurada con el backend y el proyecto de autenticación oficiales de QueryOptima: solo debes iniciar sesión.

Ejemplo para probar:

SELECT *
FROM pedidos
WHERE EXTRACT(YEAR FROM fecha_creacion) = 2026;

QueryOptima detecta FUNC_ON_FILTER_COL (la función sobre la columna impide usar un índice) y SELECT_ALL, y sugiere reescribir el filtro como un rango de fechas.

Comandos

Resultados

La vista QueryOptima muestra, por cada documento analizado:

• identificador, estado, modo y versión del análisis;
• regla, severidad, explicación, evidencia y consejo de cada hallazgo;
• recomendaciones con su SQL sugerido, precondiciones, advertencias y estado de validación;
• las limitaciones declaradas por el backend.

Los análisis static no incluyen una puntuación calibrada y la extensión no inventa una. Editar o cerrar el documento elimina sus resultados y diagnósticos desactualizados.

Uso con GitHub Copilot (Agent)

La extensión incluye el Agent Skill queryoptima-sql-review y la herramienta queryoptima_analyze_sql (referencia #queryoptimaAnalyzeSql). En el chat de VS Code, con un modo Agent que admita herramientas de extensiones, puedes pedir:

Revisa esta consulta SQL con QueryOptima y explícame los problemas y las recomendaciones: SELECT * FROM users.

VS Code te pedirá confirmación antes de enviar la consulta. La herramienta solo acepta una consulta SELECT o UNION de hasta 20 000 caracteres, no lee archivos, no ejecuta SQL y no recibe tu sesión ni tus credenciales. Si falta la sesión, indica que debes ejecutar QueryOptima: Iniciar sesión.

Requiere GitHub Copilot u otro agente compatible, habilitado y autenticado en VS Code.

Configuración

Abre Ajustes y busca QueryOptima. Los valores predeterminados apuntan a los servicios oficiales.

Privacidad y seguridad

• El SQL se envía solo después de que lo confirmes, y únicamente el texto seleccionado (o el del archivo que analizas). La confirmación muestra el servidor de destino y la cantidad de caracteres.
• La sesión se guarda en el almacenamiento seguro de VS Code. La contraseña no se almacena, y los tokens nunca se escriben en ajustes, archivos, registros ni prompts.
• La extensión rechaza claves administrativas (service_role).
• Solo se admite una sentencia de lectura (SELECT o UNION); DDL, DML y scripts se rechazan.
• Evita enviar consultas con datos personales o secretos en sus literales.

Limitaciones

• El análisis es estático: no ejecuta la consulta, no mide tiempos y no demuestra por sí solo una mejora de rendimiento. La medición real con comparación entre la consulta original y la sugerida está disponible en QueryOptima Web, sobre las tablas de su laboratorio de datos sintéticos.
• La reescritura sugerida es una propuesta técnica: revisa su equivalencia antes de aplicarla.
• Un documento con varias sentencias debe analizarse seleccionando una sola consulta.
• No hay registro de usuarios ni interfaz de MFA dentro de la extensión; si tu cuenta exige confirmación de correo o MFA y no se entrega una sesión, la extensión lo informa.

Solución de problemas

• Tiempo de espera agotado en el primer análisis: el servicio gratuito del backend puede tardar cerca de un minuto en despertar tras un periodo sin uso. Espera y reintenta.
• «Debe iniciar sesión…»: ejecuta QueryOptima: Iniciar sesión.
• «Seleccione una consulta SQL antes de ejecutar el análisis»: selecciona exactamente una consulta SELECT o UNION.
• Algo no funciona: ejecuta QueryOptima: Verificar configuración.

Acerca de

QueryOptima es un proyecto académico de Base de Datos II de la Universidad Privada de Tacna (UPT). Más información en queryoptima.vercel.app.