// HTTP · SQLite 方言

适用于 Mac、Windows 和 Linux 的 libSQL 和 Turso GUI

使用 Turso Cloud 数据库或你自己的 sqld 服务器,就像使用 SQLite 一样——同一套方言、同样的 IntelliSense、同样的比较工具——只是改用 auth token 而不是用户名和密码。

连接方式
通过 HTTP(S) 连接 Turso Cloud 或自托管的 sqld
默认端口
sqld 使用 8080;Turso 托管服务始终使用 HTTPS
登录
数据库认证令牌,本地服务器可留空
粘贴 URL
libsql://…turso.io?authToken=…

SQLly 能为 libSQL 和 Turso 做什么

libSQL 是网络版的 SQLite——Turso Cloud,或者 sqld 在你自己的机器上。SQLly 为它提供 SQLite 方言和工具,并坦率指出网络服务器与本地文件行为不同的地方。

令牌登录,安全无忧

粘贴数据库的授权令牌——或一个 libsql:// URL,带 ?authToken= - 而且它直接进入操作系统的安全存储,绝不落盘。Turso 主机始终通过 HTTPS 访问。

TLS 和证书 →

与 SQLite 方言完全一致

查询以 SQLite 自身的方言运行,每个存储类都被忠实保留:64 位整数保持精确,二进制大对象保持二进制,每列声明的类型都会被捕获。

SQLite 在 SQLly →

脚本作为一个整体运行

多语句脚本作为单个整体运行,因此 BEGIN … COMMIT 以及自动回滚安全设置的工作方式,首个失败的语句会以服务器自身的消息停止脚本执行。

自动回滚 →

比较并跟踪你的模式

模式比较、模式历史快照和数据比较在 libSQL 上都能用,测试数据生成器和结构编辑器也一样 — 便于让 Turso 数据库与本地 SQLite 文件保持同步。

模式比较 →

计划、仪表板和完整性检查

估计计划使用 SQLite 的 EXPLAIN QUERY PLAN,服务器仪表板和磁盘使用情况报告会读取数据库的页计数器,维护菜单则提供 REINDEX 以及完整性检查(服务器拒绝 VACUUM 和 ANALYZE).

查询计划 →

关于取消和分页的真实信息

libSQL 服务器无法中断正在运行的语句,因此取消只会放弃该请求;整个结果会先完整到达,然后第一行才显示出来。读取的数据量特别大时,请用 LIMIT 和 OFFSET.

查询执行 →

连接到 Turso 或 libSQL 服务器

  1. 下载 SQLly 适用于 macOS、Windows 或 Linux,从 下载页面 并打开它。
  2. 创建连接并选择 libSQL / Turso。 端口默认为 8080,即 sqld 自身的端口;Turso 主机使用 HTTPS。
  3. 输入主机 - 你的 …turso.io 地址,或者运行 sqld 的机器——或者粘贴一个 libsql:// URL,或者一个普通的 http:// 或者 https:// 端点。
  4. 粘贴认证令牌,如果是无需认证的本地服务器,就留空。没有用户名和密码。
  5. 测试、保存并连接。 对于位于堡垒机后的自托管服务器,SSH 隧道、代理、Kubernetes 端口转发以及 TLS 模式都可使用。

libSQL / Turso 上的每个 SQLly 工具

应用用来启用或禁用菜单的正是这份引擎矩阵,所以你在这里看到什么,应用里就是什么样。当某个工具不适用于 libSQL / Turso 时,应用会说明原因——我们也会。

SQLly 工具及其在 libSQL / Turso 上的可用性
工具 libSQL / Turso
资源管理器、IntelliSense 和悬停卡片 是
估计的执行计划 是 SQLite 的 EXPLAIN QUERY PLAN。
服务器仪表板 是 数据库的大小、空闲列表和内容。
磁盘使用和对象浏览器 是
维护菜单 是 REINDEX 和完整性检查;服务器拒绝 VACUUM 和 ANALYZE。
模式比较与模式历史 是
数据比较 是
数据传输 是
测试数据生成器 是
表结构编辑器 是
SSH 隧道、代理和 Kubernetes 端口转发 是 适用于自托管服务器。
只读连接 是
自动回滚安全防护 是
在结果网格中编辑行 否 libSQL / Turso 上尚不可用。
实际(已执行)计划 否 libSQL 只提供 SQLite 的估计执行计划。
活动监视器 否 libSQL 独立处理每个请求;没有会话列表。
查询洞察 否 libSQL 不保留查询统计存储。
索引分析器 否 libSQL 不保留索引使用计数器。
安全编辑器(用户、角色、授权) 否 在 libSQL / Turso 上不可用。
备份 / 恢复 否 使用 Turso 自带的备份,或复制 sqld 的数据目录。
创建和删除数据库对话框 否 libSQL 数据库在服务器上创建。
过程模式 否 libSQL 没有存储过程。
SQL 代理、扩展事件和引导式设计器 否 仅适用于 SQL Server 和 Azure SQL。

关于 SQLly 中 libSQL / Turso 的问题

SQLly 是否支持 Turso Cloud?

是的。在连接编辑器中选择 libSQL / Turso,填入你的 …turso.io 主机并粘贴数据库的认证令牌;或者直接粘贴带 ?authToken= 的 libsql:// URL,SQLly 会自动填好全部信息。令牌保存在操作系统的安全存储里,Turso 主机也始终通过 HTTPS 访问。

我可以在没有令牌的情况下连接到本地 sqld 服务器吗?

可以。本地未启用认证的服务器,把认证令牌留空即可;sqld 的默认端口 8080 已经帮你填好。远程自托管服务器的话,SSH 隧道、代理、Kubernetes 端口转发和各种 TLS 模式都能用。

事务可以在 libSQL 上运行吗?

是的。含多条语句的脚本会作为一个整体运行,因此 BEGIN … COMMIT 和自动回滚安全设置照常生效,第一条失败的语句会以服务器自己的消息终止脚本。

为什么 SQLly 无法停止长时间运行的 libSQL 查询?

libSQL 服务器没办法中断正在运行的语句,所以取消只会放弃该请求。整个结果也会先完整到达、第一行才显示出来,因此读取特别大的数据时请用 LIMIT 和 OFFSET 分页。

// 在你自己的 libSQL / Turso 上尝试

把你的 libSQL / Turso 带回家给小猪

SQLly 在 macOS、Windows 和 Linux 上免费即可上手,无需账户。