SonnetDB Docs

SonnetDB 文档中心

SonnetDB 当前版本的产品、开发与部署文档总览，覆盖工业边缘数据引擎、Copilot、Studio、嵌入式、ADO.NET、CLI、服务端和批量写入。

SonnetDB 是一个面向 C# / .NET 10 工业边缘应用的本地优先数据引擎。它以设备遥测和时序数据为核心起点，同时提供关系表、KV、JSON 文档、全文检索、向量检索、Hybrid Search、对象桶、本地消息队列、SonnetDB Studio 和 Copilot 智能协作能力。

它的产品门面不是“再做一个大而全数据库”，而是让设备网关、采集程序、轻量 MES / SCADA、离线数据记录器和 Industrial Data Agent 可以在一个本地数据库目录里完成主要数据工作。

当前版本的持久化方式是数据库目录中的多文件布局，不再以“单文件数据库”作为产品描述。文档中的示例、目录结构和启动方式都以当前仓库代码为准。

嵌入式与服务端

可在进程内打开数据库目录，也可作为 HTTP 服务运行，并通过同一套 SQL 访问。

工业边缘数据核心

支持设备时序、关系表、KV、JSON 文档、全文、向量、Hybrid Search、对象桶和本地消息队列。

AI、Agent 与运维

内置聚合、窗口、预测、PID、地理空间、Copilot、MCP、权限、Token、备份恢复和管理后台。

从哪里开始

如果你要做什么	建议先看
启动 Docker 镜像、完成首次安装、打开后台	开始使用
了解 measurement、tag、field、time 和 series 的关系	数据模型
编写 `CREATE/INSERT/SELECT/DELETE` 或控制面 SQL	SQL 参考
想直接复制一段常用 SQL 模板	SQL Cookbook
使用 SonnetDB Studio 浏览 schema、编辑 SQL、做 staged preview	SonnetDB Studio
了解 Copilot 如何辅助 SQL、排障和知识检索	SonnetDB Studio 和 Copilot 技能库
构建工业 AI 应用或 Industrial Data Agent	使用 SonnetDB 构建工业 AI 应用
在进程内直接使用引擎	嵌入式与 in-proc API
使用轻量 KV keyspace 存储 metadata 或小对象	KV Keyspace
通过 ADO.NET 访问本地或远程实例	ADO.NET 参考
通过 EF Core DbContext 与现有 .NET 应用集成	EF Core Provider
使用 `sndb` 命令行工具	CLI 参考
走 Line Protocol、JSON 或批量 VALUES 快路径	批量写入
了解当前组件关系与存储路径	架构总览和文件格式与目录布局
复核最近的性能、可靠性和格式演进	性能与可靠性近期变更
查看发布产物与打包说明	发布与打包

SonnetDB 现在由这些主线组成：

这几部分共享同一套底层存储格式和大部分 SQL 行为。服务端额外增加了：