应用的构建方式

一个 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 隧道。

语句的路径

  1. 你输入。 编辑器向 IntelliSense 模型请求补全;该模型由实时架构、本地 DDL 以及你启用的任何数据感知构建而成。
  2. 你执行。 该语句会经过服务层,安全规则——只读连接、事务包裹、确认提示——会先在这里生效。
  3. 由引擎执行。 驱动程序以背压的方式流式返回行;超大结果会溢出到磁盘,而不会占用机器内存。
  4. 结果落地。 网格、数据透视、图表和导出器都读取相同的流式结果模型。

远程访问

不在办公桌前时,相同的引擎路径会经由 SQLly 中继传输。一个本地部署的桥接守护进程从你的网络向外拨出,中继路由加密流量,共享的帧格式承载请求和流式结果。中继可以路由它无法读取的内容。

运行位置

  • macOS 在 Apple Silicon 上。
  • Windows 和 Linux - 同时支持 x64 和 arm64。
  • 浏览器预览 - 编译成 WebAssembly 的真正应用,跑在示例数据上;是演示,不是云服务。

测试是构建的一部分

测试伴随每一层编写:单元测试就在每个 crate 的源码里,集成测试套件放在旁边,还有在所有平台上行为一致的黄金文件比对,以及针对真实的 SQL Server、PostgreSQL、MySQL、SQLite、DuckDB、ClickHouse、libSQL、Oracle 和 Redis 服务器做的一致性运行 - 7,413 个测试 截至撰写本文时。 crate 一览页面 列出每一个的数量。