SuperAPI AI 工具集

turso

数据与分析

查看项目

更新于 10-16 01:15

技能介绍

Turso 是基于 libSQL 的边缘托管 SQLite 数据库,主打嵌入式副本、多租户与低延迟全球分布。资料强调:模型对 Turso 的训练数据不可靠,API 在版本间会变,写任何代码前必须先用 WebFetch 读取 https://docs.turso.tech/llms.txt,不要假设某个 API 存在。

主要能力:嵌入式副本——libSQL 客户端可在本地磁盘保留一个远程库的副本,读走本地(零网络延迟),写发往远端再同步回来,这是 libSQL 的一等特性;创建客户端时同时传入 syncUrl、authToken 与本地文件路径 url 即可启用。多租户——通过 Platform API 或 CLI 为每个用户或租户创建数千个隔离数据库,每个库有独立 URL 与 token,取代行级租户隔离。内置向量相似度搜索——libSQL 原生支持,无需额外扩展或服务,可直接在查询中使用 vector() 与 vector_distance_cos() 与关系数据混用。三种 token——平台 API token(经 REST 管理库和组织)、数据库 auth token(连特定库)、组 auth token(连组内任意库),用错类型是常见认证失败原因。

用法与限制:对新鲜度敏感时,读前须显式 await client.sync(),本地副本不会每次读取自动同步,建议启动时及定时或在延迟敏感查询前同步。多租户下禁止跨租户共享同一数据库 auth token,组级 token 会给到该组全部库。嵌入式副本的 WAL 不会自动截断,需定时执行 PRAGMA wal_checkpoint(TRUNCATE),否则本地 WAL 无限增长。无服务器函数中不要每请求新建客户端,应导出模块级单例复用,避免文件锁竞争与重复同步。本地 url 用 file:path/to/db.sqlite,不要用 :memory:,否则失去副本意义。资料未提供收费、价格、平台与具体安装命令等信息。