VPS 或弱网移动场景想要微秒级本地读,又要把写入汇到云端主库——Embedded Replicas 把远程库复制进应用进程旁的本地文件。
Turso Docs《Embedded Replicas》(dateModified 可核)说明:嵌入式副本在本地保留 Turso Cloud 数据库的只读副本;读从本地文件以微秒级服务,写默认发到云端主库再反映回副本;生产可用。文档同时提示:新项目若需要 sync,更推荐 Turso Sync(基于逻辑 CDC,本地优先写与显式 push/pull,带宽与延迟通常优于页级复制的 Embedded Replicas)。机制:配置本地文件为 url,远程库为 syncUrl;读始终来自本地;写默认发往 syncUrl(非先写本地),可读己之写(可关);可用 syncInterval 周期性同步,亦可手动 sync()。支持 encryptionKey 静态加密。用法上 TypeScript 等 SDK 传入 url/syncUrl/authToken(及可选 syncInterval、offline)。注意:同步过程中不要另开该本地库(可能损坏);无文件系统的 serverless 环境不能用;某些写入/重启/本地文件失效可能导致同步帧数多于预期;一帧约 4KB。本场景据此输出嵌入式副本简报。禁止回显 authToken 或声称「生产副本已同步完成」。