跳转到正文

Turso 和 libSQL 客户端

通过 URL 和令牌连接 Turso 数据库,或打开 libSQL 文件,并使用 SQLite 语法查询。

概览

查询语言
SQL
驱动
首次使用时下载与 libSQL 共用
连接方式
服务 API

连接 Turso

在 连接模式 (Connection Mode) 中选择 远程 (Turso) (Remote (Turso)),然后粘贴数据库的 HTTPS URL 和 API Token,令牌保存在 macOS 钥匙串中。两者都可从 Turso 控制台或 CLI 获取。

导入的 libsql:// URL 会成为 HTTPS 远程连接,每个 URL 指定一个数据库。普通 HTTP URL 未加密,且不支持 SSH 隧道。

查询和编辑

libSQL 使用 SQLite 语法,因此浏览、EXPLAIN QUERY PLAN 图和导出的行为与 SQLite 相同。

远程连接不运行事务:每条语句都是独立的 HTTP 请求并各自提交,BEGIN 会报错“Transactions are not supported in this mode”。事务需要以 libSQL 打开的本地文件。远程模式不加载 SQLite 扩展,因为 Turso 数据库运行其服务器构建时包含的扩展;被限流的请求会在错误中说明需要等待多少秒。

表、索引和触发器

Structure 标签页可创建表,添加和删除列及索引,并创建、编辑和删除触发器。可从侧边栏重命名表,但不能重命名视图。

远程连接上的列重排或外键更改会生成重建脚本,供您检查并运行,因为 TablePro 无法将多个独立的 HTTP 请求放在一个事务中。

本页介绍 Turso 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。

libSQL

对于通过其 Hrana v2 pipeline 端点访问的自托管 sqld 服务器,或 本地文件 (Local File) 模式下此 Mac 上的文件,请选择 libSQL。本地文件可运行事务,加载 SQLite 扩展,并在您确认后运行重建脚本;Backup Dump 和 Restore Dump 会对其运行 sqlite3。

切勿打开正被运行中的应用作为 Turso 嵌入式副本同步的文件:两个程序同时访问可能导致其损坏。

限制
  • Backup Dump 仅支持本地 libSQL 文件,不支持远程数据库。

其他

  • 移动数据

    将表或查询结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。要加载数据,请使用 Turso CLI 或 sqld 服务器上的导入功能。

  • 限制

    • 每个连接对应一个数据库,不支持切换数据库或分支。
    • 不支持嵌入式副本。本地文件独立打开,不会同步。
  • 应该选择 Remote 还是 Local File?

    通过 URL 访问的 Turso 数据库或 sqld 服务器选 Remote。此 Mac 上的 libSQL 文件选 Local File,它还提供事务、SQLite 扩展和备份。

  • 需要安装 Turso CLI 吗?

    不需要。Turso 控制台也会显示数据库 URL 并可创建令牌。CLI 适合从终端加载数据。

获取 TablePro

本页功能全部免费。