Cómo se construye la aplicación
Un workspace de Rust, una interfaz GPU nativa, un núcleo de servicio headless y un subproceso de motor - y cómo se comunican las piezas.
SQLly es un workspace de Rust: un conjunto de crates de biblioteca más unas capas ligeras de aplicación por encima. No hay webview ni segunda base de código: la app de escritorio, la vista previa en el navegador, el servidor de lenguaje y el motor de la CLI son interfaces ligeras sobre los mismos crates.
La forma
- Interfaz nativa
- El banco de trabajo es GPUI: renderizado por GPU, nativo en cada plataforma, y una gran parte de por qué la aplicación sigue siendo rápida. La vista previa del navegador compila las mismas vistas a WebAssembly.
- Núcleo sin interfaz
- Una capa de servicio sin interfaz concentra la lógica real del producto —herramientas, edición, volcados, planes— sin ninguna UI acoplada, así que cada frontend llama al mismo código.
- Subproceso del motor
- El trabajo del motor puede ejecutarse en un proceso aparte que habla en tramas binarias compactas. Cada solicitud y respuesta se registra con un id de correlación, así que un cuelgue o fallo deja un rastro completo.
- Controladores nativos
- La capa del motor habla cada protocolo de red por sí misma: TDS, PostgreSQL, MySQL, SQLite, libSQL/Hrana, DuckDB, ClickHouse HTTP, Oracle Net (a través de Instant Client) y RESP de Redis, con tunelización SSH incorporada.
La ruta de una instrucción
- Escribes. El editor le pide sugerencias al modelo IntelliSense; el modelo se construye a partir del esquema en vivo, el DDL local y cualquier conocimiento de los datos que hayas activado.
- Tú ejecutas. La instrucción pasa a través de la capa de servicio, donde se aplican primero las reglas de seguridad: conexiones de solo lectura, envoltura de transacciones, confirmaciones.
- El motor ejecuta. El controlador devuelve las filas en streaming con contrapresión; los resultados demasiado grandes se vuelcan a disco en lugar de consumir la memoria de la máquina.
- Los resultados llegan. La cuadrícula, la tabla dinámica, los gráficos y los exportadores leen el mismo modelo de resultados en streaming.
Acceso remoto
Lejos del escritorio, el mismo camino del motor viaja por el relay de SQLly. Un daemon de puente en tus instalaciones realiza una conexión saliente desde tu red, el relay enruta el tráfico cifrado y un formato de tramas común transporta las solicitudes y los resultados en streaming. El relay puede enrutar lo que no puede leer.
Dónde se ejecuta
- macOS en Apple Silicon.
- Windows y Linux - tanto x64 como arm64.
- Vista previa del navegador - la aplicación de verdad compilada a WebAssembly con datos de ejemplo; una demostración, no un servicio en la nube.
Pruebas como parte de la compilación
Las pruebas se escriben junto a cada capa: pruebas unitarias en el código fuente de cada crate, suites de integración junto a ellas, comparaciones con archivos de referencia (golden) que se comportan igual en todas las plataformas y ejecuciones de conformidad contra servidores reales de SQL Server, PostgreSQL, MySQL, SQLite, DuckDB, ClickHouse, libSQL, Oracle y Redis - 7.413 pruebas en el momento de escribir esto. La página de crates lista el conteo de cada uno.