应用的构建方式
一个 Rust 工作区、原生 GPU 界面、无头服务核心和一个引擎子进程——以及各部分之间如何配合。
SQLly 是 一个 Rust 工作区: 一组库 crate 加上其上的轻量应用外壳。没有 WebView,也没有第二套代码库——桌面应用、浏览器预览、语言服务器和 CLI 引擎都是同一批 crate 的轻量外壳。
整体形态
- 原生界面
- 工作台由 GPUI 构建——GPU 渲染,在每个平台上都是原生实现,这也是应用保持流畅的重要原因。浏览器预览则把同一套视图编译为 WebAssembly。
- 无头核心
- 无头服务层包含真正的产品逻辑——工具、编辑、转储、计划——没有附加 UI,因此每个前端调用的都是相同的代码。
- 引擎子进程
- 引擎工作可以在一个独立的进程中运行,该进程使用紧凑的二进制帧通信。每个请求和响应都会记录关联 ID,因此挂起或崩溃时会留下完整的轨迹。
- 原生驱动程序
- 引擎层自行实现每一种线上协议——TDS、PostgreSQL、MySQL、SQLite、libSQL/Hrana、DuckDB、ClickHouse HTTP、Oracle Net(通过 Instant Client)以及 Redis 的 RESP,并内置 SSH 隧道。
语句的路径
- 你输入。 编辑器向 IntelliSense 模型请求补全;该模型由实时架构、本地 DDL 以及你启用的任何数据感知构建而成。
- 你执行。 该语句会经过服务层,安全规则——只读连接、事务包裹、确认提示——会先在这里生效。
- 由引擎执行。 驱动程序以背压的方式流式返回行;超大结果会溢出到磁盘,而不会占用机器内存。
- 结果落地。 网格、数据透视、图表和导出器都读取相同的流式结果模型。
远程访问
不在办公桌前时,相同的引擎路径会经由 SQLly 中继传输。一个本地部署的桥接守护进程从你的网络向外拨出,中继路由加密流量,共享的帧格式承载请求和流式结果。中继可以路由它无法读取的内容。
运行位置
- macOS 在 Apple Silicon 上。
- Windows 和 Linux - 同时支持 x64 和 arm64。
- 浏览器预览 - 编译成 WebAssembly 的真正应用,跑在示例数据上;是演示,不是云服务。
测试是构建的一部分
测试伴随每一层编写:单元测试就在每个 crate 的源码里,集成测试套件放在旁边,还有在所有平台上行为一致的黄金文件比对,以及针对真实的 SQL Server、PostgreSQL、MySQL、SQLite、DuckDB、ClickHouse、libSQL、Oracle 和 Redis 服务器做的一致性运行 - 7,413 个测试 截至撰写本文时。 crate 一览页面 列出每一个的数量。