SuperAPI AI 工具集

turso-best-practices

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:该技能整理 Turso 与 libSQL 的最佳实践,用于构建需要 SQLite 简洁性又具备云端分发能力的应用,包括边缘分发、嵌入式副本、原生向量搜索、数据库分支与时间点恢复。

主要能力:提供 CLI 安装与认证、数据库创建与连接、SDK 查询与事务、本地开发、性能建议和常见错误修正。核心原则是“SQLite 的简单性加云规模的分布”。

必要用法:macOS 安装 CLI 用 brew install tursodatabase/tap/turso;Linux/WSL 用 curl -sSfL https://get.tur.so/install.sh | bash。登录用 turso auth login,创建数据库用 turso db create my-db,进入 shell 用 turso db shell my-db,获取连接信息用 turso db show my-db --url 与 turso db tokens create my-db。SDK 安装 npm install @libsql/client,通过 createClient 传入 TURSO_DATABASE_URL 与 TURSO_AUTH_TOKEN。本地开发可用 file:local.db,或运行 turso dev 启动本地 libSQL 服务器。事务模式包括 write(BEGIN IMMEDIATE)、read(只读,可在副本并行)和 deferred。

适用场景:需要 SQLite 云功能的项目、离线优先的嵌入式副本、向量搜索与 AI 嵌入、本地开发、迁移与分支管理。

限制与注意:本地文件应使用 @libsql/client 而非 @libsql/client/web;写事务应保持短小;同步期间不要打开本地文件;嵌入式副本需调用 sync() 或设置 syncInterval;凭据应使用环境变量;相关写入应使用 batch() 或 transaction()。向量索引建议用于超过 1000 行的表。更高级功能(嵌入式副本、向量搜索、Drizzle ORM、分支、静态加密、SQLite 扩展)见 references/advanced-features.md。具体收费、价格与平台支持范围暂未提供。