// 面向数据分析师

写查询。相信答案。拿到数据。

你不需要弄懂生成计数器是什么,也能从 SQLly 里得到价值。本指南只讲你每天真在做的三件事:写查询时不必跟编辑器较劲、看结果不必眯起眼睛、导出数据不必再开第二个工具。

// 入门指南

在编写 SQL 语句前先找到你的表

左侧的服务器面板按照你实际思考数据的方式对每个连接进行分组——而不仅仅是按主机名。

SQLly - 服务器
SQLly 查询工作区,左侧打开服务器面板,查询标签页为空

服务器面板、空白的查询标签页和结果面板——这就是你今后天天打交道的三个面板。

🗂️
连接分组 ✓ 已实现

客户端、项目、环境或原始服务器

在面板顶部切换分组模式 - 无、客户、项目、环境、服务器 - 让零散的主机名列表变成“Acme Corp → Reporting → Prod”。

📑
选项卡 ✓ 已实现

每个思路一个标签页

每个查询都待在自己的标签页里,带着各自的服务器和数据库选择,所以在这一页顺手查点东西,绝不会串到你在另一页里正在搭的报表上。

💾
防崩溃 ✓ 已实现

你的标签页会恢复

关闭 SQLly 再重新打开,你打开的选项卡——查询文本、布局、一切——都停在你离开时的样子。无需保存,什么都不会丢。

// 编写查询

既懂模式也懂数据的自动补全

大多数 SQL 编辑器只会自动补全表名和列名。SQLly 则更进一步。

SQLly - 查询 2
SQLly 编辑器:查询进行到一半时 IntelliSense 建议 AND、AS、BETWEEN 等 SQL 关键字

输入时会显示关键字和子句补全,无需手动触发。

⌨️
值自动补全 ✓ 已实现

列的自动补全 值

在 WHERE 子句,SQLly 会根据该列的实际数据建议真实值——并在你继续输入时实时过滤。

-- as you type, it filters live
WHERE CompanyName = 'Acme␣'  ⟶ Acme Corp, Acme Labs…
🔑
键 ↔ 名称 ○ 计划中

输入名称,而不是键

想找外键背后那一行?直接输入你真正想找的可读名称——SQLly 会解析它并接好 JOIN,省得你手写 JOIN,只是为了按客户名称筛选。

🌫️
不完整的架构 ✓ 已实现

即使模式只建好一半,它也依然有用

如果一张表的定义还很粗糙——比如同事的迁移草稿、还无法完全解析的雏形——SQLly 会叠上它的最佳猜测并继续提供补全,而不是直接放弃。

🏷️
可读的结果 ◐ 进行中

在结果中看到名称,而不是 ID

只要 SQLly 能推断出外键自然的“显示值”,它就会向你显示 Acme Corp 在网格中显示,而不是 customer_id = 4827 - 当它猜错时,可以针对每列进行配置。

// 读取结果

为真正阅读数据而生的结果网格

大型结果集保持流畅,因为 SQLly 只渲染屏幕上的行——不会一次性在 DOM 中渲染 50 万行而导致卡顿。

SQLly - 语法高亮
SQLly 编辑器显示带有语法高亮的多行聚合查询

为你实际写下的查询提供干净的语法高亮——关键字、函数和标识符各有各的颜色。

📊
虚拟网格 ✓ 已实现

即使在大型结果集上也能平滑滚动

网格是虚拟化的——它只渲染当前屏幕上的那一段行,因此在六位数的结果集里翻页,和在十行里翻页手感完全一样。

🧭
分页 ✓ 已实现

结果分页返回,而不是一次性全部返回

SQLly 分页处理大型结果集,而不是试图一次性将所有内容加载到内存中,所以一个返回结果远超预期的查询不会在数据流入时阻塞整个应用程序。

🧮
自定义格式 ◐ 进行中

按你们团队的阅读习惯格式化各列

在“偏好设置”面板里一次性设置每列的格式偏好——货币、舍入、日期样式——而不用把每个查询都包进 FORMAT() 调用。

🔀
基于注释的透视 ✓ 已实现

用注释透视结果

给查询加上标注,SQLly 就能直接在结果网格里把行重排成列——不需要向导,也不用导出到数据透视工具。

--! pivot rows=region cols=quarter value=revenue
📝
行编辑器 ✓ 已实现

无需手动编写 UPDATE 即可编辑行

右键点击任意结果行,SQLly 会根据表自身的元数据生成按列编辑的表单——包括类型、默认值和约束。可以编辑、插入、复制或删除行,写入采用带防护的参数化操作,还可以在单独的标签页中跳转到相关行。

🧬
结构化单元格 ✓ 已实现

读取 JSON 和 XML,而不是一大坨文本

包含 JSON 或 XML 的单元格会在结构化的美化查看器中打开,可展开、可折叠——而不是挤在网格单元格里的一行难以阅读的内容。

🪟
自定义布局 ✓ 已实现

按你的方式排列多个结果集

别再在一个个堆叠的结果集之间来回滚动。在选项卡、堆叠和自由画布布局之间切换——或者用注释设定行和列 (-- sqlly 4x2),这样多个结果集就能各落在合理的位置。

想亲手点点真实的数据网格吗? 这 交互式示例 在文档中,在你的浏览器中运行真实的结果网格 - 对打包的数据集进行排序、调整大小、透视表和绘制图表,而无需下载任何内容。
// 导出数据

以下一步需要的任何形式导出

报告很少就是查询结果本身——它可能是一张电子表格、一条 Slack 消息,或一个迁移脚本。SQLly 能直接导出成所有这些。

📋
日常格式 ✓ 已实现

CSV、TSV、JSON、Markdown、HTML

选择与数据下一步去向匹配的形式——电子表格、API 载荷、README 表格,或者直接粘进文档。

📗
真正的电子表格 ✓ 已实现

直接导出为 XLSX

当“给我发点数字”意味着一份真正的电子表格、而不是一份还要别人再排版的 CSV 时,直接导出为 Excel 文件。

🧱
针对工程师 ✓ 已实现

将结果复制为 INSERT 语句

需要给开发者几行数据来初始化测试环境?把结果集导出成可直接运行的 INSERT 语句,而不是他们必须手动重新格式化的 CSV。

⚖️
比较 ✓ 已实现

比较两个结果集

在改动前后运行过同一条查询?把两个结果集放在一起对比,确切看到哪些行被添加、删除或保持不变——模式不匹配会被明确指出,而不是被悄悄地错误对比。

// 为什么感觉这么快

你本不必考虑性能。你也确实不必。

⚡
✓ 已实现

自动补全不会等待你的数据库

SQLly 在内存中维护自己的模式模型,并在后台刷新它,因此即使面对大型或缓慢的服务器,IntelliSense 仍然保持即时响应——它不会每次输入一个字母就向数据库发送实时查询。

🧠
✓ 已实现

它只会重新检查实际发生变化的内容

SQLly 不会在每次按键时都重新扫描整个模式,而是只追踪变化的部分并重新验证——这就是为什么即使面对拥有数千个对象的数据库,它依然保持流畅。

好奇原因吗? 这 DBA 和高级用户指南 涵盖了调优旋钮,以及 工程深度解析 涵盖了实际架构——缓存、快照,以及其底层的 Rust 引擎。

这就是整个工作流程。

连接,在真正的辅助下写查询,读结果不头疼,把结果导出到需要去的地方。不需要十四步的新手引导。