SQL2API
SQL2API es una puerta de enlace auto-hospedada ligera que convierte consultas SQL en APIs REST seguras con abstracción de bases de datos, guardado de consultas gobernadas, acceso API acotado y validación de parámetros.
Ficha actualizada 24 sept 2026, 17:40 · upstream 24 sept 2026, 17:23 · release sin release detectada
Qué es SQL2API
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SQL2API transforma consultas SQL existentes en endpoints REST documentados sin necesidad de escribir código backend. Soporta múltiples bases de datos nativas (PostgreSQL, MySQL, ClickHouse, SQLite, H2, DuckDB) más JDBC genérico para Oracle, SQL Server, DB2 y Snowflake mediante drivers externos.
El sistema implementa seguridad por defecto: autenticación con API keys encriptadas SHA-256, control de acceso acotado a consultas específicas, guardado SQL que solo permite SELECT/WITH/SHOW por defecto, limitación de tasa IP y per-key, caché HTTP condicional, y streaming para exportaciones masivas sin buffering.
Incluye interfaz administrativa integrada en /ui con editor SQL con resaltado sintáctico, explorador de esquema, gestión de conexiones, historial de ejecución por consulta, generación automática de OpenAPI 3.0 validada en CI, métricas Prometheus en /metrics y logs estructurados JSON.
- Exponer consultas SQL existentes de reportes BI o ETL como endpoints REST sin reescribir el backend
- Crear APIs internas para dashboards con autenticación por API key acotada a consultas específicas
- Exportar datos masivos mediante streaming NDJSON/CSV para pipelines de procesamiento externo
- Proveer acceso controlado a terceros con límites de tasa y expiración de claves independientes
- Documentar automáticamente endpoints OpenAPI 3.0 desde consultas SQL guardadas y versionadas
- Guardado de consultas versionado: cambios en SQL no rompen endpoints existentes, cada versión accesible vía ?version=N
- Parámetros vinculados (:name) con validación tipada antes de ejecución, previene inyección SQL por diseño
- Streaming para exportaciones masivas (1M+ filas) sin buffering en memoria, verificado end-to-end
- OpenAPI 3.0 generado automáticamente y validado en CI contra el oficial validator
- Interfaz administrativa integrada con explorador de esquema, historial de ejecución y copia como curl/TSV
- No soporta operaciones de escritura (INSERT/UPDATE/DDL) por defecto; requiere configuración explícita server-wide o per-key
- Requiere Python 3.9+ con drivers JDBC externos para bases de datos no nativas (Oracle, SQL Server, DB2, Snowflake)
- No incluye soporte one-click deployment; requiere Docker Compose o instalación manual del servicio Flask
- Caché HTTP solo aplicable a consultas SELECT/READ; nunca se aplica a operaciones que escriben en la base de datos
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado con Docker Compose: PostgreSQL, MySQL o ClickHouse como backend. Puerto 5000 para API y /ui para administración. Variables de entorno SQL2API_RATE_LIMIT para limitación global, SQL2API_JSON_LOGS para logs estructurados. Requiere 4 núcleos CPU y 4GB RAM mínimo según análisis técnico. No incluye soporte one-click; configurar manualmente o usar Docker Compose proporcionado.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.