SuperAPI AI 工具集

turso

数据与分析

查看项目

更新于 10-16 07:25

技能介绍

用途:Turso 是基于 libSQL(SQLite 开源分支)的边缘托管 SQLite 平台,面向需要低延迟读取的边缘部署应用、按租户隔离数据库的 SaaS 场景,以及支持离线的嵌入式副本。若需要跨租户复杂 join 的传统关系库或 PostgreSQL 专有特性,则不适合。

主要能力:通过 @libsql/client SDK 连接云端数据库(createClient({ url, authToken }))、纯本地文件(file:local.db)或内存库(:memory:);嵌入式副本用 syncUrl 加 authToken 实现本地读、远程同步,可手动 client.sync() 或设置 syncInterval 秒级自动同步;支持 client.execute 查询、client.batch 原子多语句、client.transaction('write') 交互式事务、encryptionKey 本地文件加密;原生向量搜索支持 vector32() 存 F32_BLOB、vector_distance_cos 余弦距离(ORDER BY distance ASC)与 libsql_vector_idx DiskANN 索引。平台侧可用 CLI turso db create、turso db tokens create,或 API POST /v1/organizations/{org}/databases 编程式开通多租户库。可与 drizzle-orm/libsql 驱动集成。

使用方式:安装并配置 TURSO_DATABASE_URL 与 TURSO_AUTH_TOKEN 环境变量,按连接模式创建客户端;嵌入式副本必须同时提供 syncUrl 与 authToken,读取前调用 sync() 或设置 syncInterval。向量检索需先建 libsql_vector_idx 索引,向量值用 vector32() 包装或传 Float32Array。

限制与注意:不要在源码硬编码 token;简单批量用 batch() 而非交互式事务;事务出错须在 finally 中 close();避免所有租户共用一个库;余弦距离越小越近,勿用 DESC。ORM 模式、本地优先架构与 PGlite 对比可分别交由对应技能处理。其余细节暂未提供。