libSQL 连接字符串生成器
为 TypeScript、Python、Go 和环境变量构建带身份验证令牌的 Turso 或 libSQL 数据库 URL;也可以粘贴一个,看看主机、TLS 是否开启、令牌何时过期。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。
在 SQLly 中打开此连接
从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。
libSQL 连接字符串格式
一个 Turso 数据库通过 libsql://<database>-<organization>.turso.io URL 以及身份验证令牌(JWT)进行访问。 libsql:// 表示 TLS;在自己机器上自托管的 sqld 通常监听普通的 http://127.0.0.1:8080.
解码器就在你的浏览器里读取令牌的载荷,显示其过期时间以及是否只读。它不会验证签名,也不会把令牌发送到任何地方。
数据库 URL Turso CLI 和所有 libSQL SDK
libsql://mydb-myorg.turso.io
带身份验证令牌的 URL Go database/sql,@libsql/client,SQLly
libsql://mydb-myorg.turso.io?authToken=your_auth_token
本地 sqld 自托管 libSQL 服务器
http://127.0.0.1:8080
占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 libSQL 的信息: SQLly 适用于 libSQL.
libSQL URL 方案和选项
来自 @libsql/client 源码和 Turso 的 SDK 参考。
| 关键字 | 同义词 | 默认 | 作用 |
|---|---|---|---|
libsql:// |
- | - | TLS;客户端选择 HTTPS 或安全 WebSockets。 |
https:// / wss:// |
- | - | 在特定传输上使用 TLS。 |
http:// / ws:// |
- | - | 纯文本,本地 sqld 使用。 |
file: |
- | - | 本地 libSQL/SQLite 文件(嵌入式)。 |
authToken |
- | - | 携带认证令牌的查询参数;或传入 authToken / auth_token 客户端选项中传递。 |
tls |
- | 1 | ?tls=0 会关闭 TLS,针对 libsql://;需要显式指定端口。 |
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN |
- | - | Turso 快速入门使用的环境变量名称。 |
常见的 libSQL 连接错误
401 Unauthorized
原因: 认证令牌缺失、已过期、已被撤销,或属于另一个数据库或组织。
修复: 用以下命令创建新令牌: turso db tokens create <database> 并将其粘贴到解码器中以检查其有效期。
Connection refused on 127.0.0.1:8080
原因: 本地没有正在运行的 sqld,或者它监听的是其他端口。
修复: 启动 sqld (例如 turso dev 用于本地开发服务器)并使用它打印的 URL。
libSQL 连接字符串常见问题解答
什么是 Turso 数据库 URL?
libsql://<database>-<organization>.turso.io,由 turso db show <database>显示。将其与来自 turso db tokens create <database>.
在 URL 中放置身份验证令牌安全吗?
它可用(?authToken=),但 URL 也就成了会落进日志和 shell 历史记录的秘密。建议改为单独传递令牌,例如放在 TURSO_AUTH_TOKEN 环境变量。
这个工具会检查我的令牌吗?
它会在你的浏览器中解码令牌的载荷,以显示到期日期以及是否只读。它不会校验签名,也绝不会把令牌发送到任何地方。
连接一次。之后只管写 SQL。
SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 libSQL 等引擎上获得模式感知的 IntelliSense。