sonnetdb

SonnetDB：空间函数别名的参数与兼容边界本文介绍 SonnetDB 当前提供的 ST_Distance、ST_Within 与 ST_DWithin 函数别名，重点说明它们实际接受的参数，以及与完整 PostGIS 空间语义的差别。

SonnetDB：向量召回率评估中的精确基线与参数记录本文介绍 SonnetDB 向量召回率评估的准备方法，重点是建立真实精确基线，避免把相同查询调用或示意曲线当成基准结果。

SonnetDB：批量写入的大小、背压与刷新策略本文介绍 SonnetDB 的批量写入与刷新策略，重点是分别控制请求大小、等待队列和确认语义，而不是给出未经测量的吞吐承诺。

SonnetDB：KNN 查询的距离语义与维度边界本文介绍 SonnetDB 的 knn() 表值函数，重点是查询向量、距离方向与实际检索路径的边界。假设 documents 已有三维 VECTOR FIELD 列 embedding，以及 title TAG：

SonnetDB SQL Cookbook：常用查询模式速查SonnetDB 的时序数据开发常会重复用到建模、写入、过滤、聚合和检索。本文汇总 10 类 SQL 模板供查阅；执行前需要对应的数据库连接、权限、schema 和样例数据。这些片段不是整篇顺序执行的脚本。

SonnetDB SQL 分页查询：LIMIT/OFFSET 与 FETCH 语法SonnetDB 支持 LIMIT ... OFFSET 和 OFFSET ... FETCH 两种 SQL 分页写法。它们可以表达同一个“跳过若干匹配行，再返回一页”的查询；分页是否稳定，还取决于排序、筛选条件和连续请求期间的数据变化。

INSERT INTO：向时序表写入数据SonnetDB measurement 使用 INSERT INTO ... VALUES 写入 TAG、FIELD 和保留时间列。本文介绍 measurement 的批量写入、稀疏 FIELD、类型检查与 schema-on-write。

深入探讨：SonnetDB 的文件格式与存储布局排查容器挂载、数据库迁移和备份问题，第一步是分清 Server 数据根目录、单个数据库目录和控制面目录。SonnetDB 的持久化边界是目录，不是一个可随意复制的单文件。本篇按当前文件格式文档修订旧稿中的每个 measurement 单独 WAL/Segment 目录示意。

架构深度解析：SonnetDB 的写入与查询路径理解写入、读取和段发布的顺序，有助于选择持久性配置和排查恢复问题。SonnetDB 的 measurement 存储采用 WAL、MemTable、不可变 Segment 与后台 Compaction 组成的 LSM 风格路径。本文讨论时序存储，关系表、文档、对象和 MQ 保留各自合同，不能把这条路径直接套到所有模型。

Docker 快速上手：5 分钟运行 SonnetDBDocker 可以帮助我们快速体验 SonnetDB 的 HTTP API、管理界面和随镜像附带的帮助站点。本文的目标是完成首次启动和连接验证；下载耗时、机器配置和初始化操作都会影响实际时间，“5 分钟”不是性能保证。

CLI 工具安装与使用：sndb 命令行指南sndb 是 SonnetDB 的命令行入口，适合本地与远程 SQL、交互式 REPL、连接 profile 和离线备份。本文按当前 CLI 文档与命令分发表修订旧稿中的 sndb config、health、execute 等不适用示例，并保留可以直接使用的入门路径。

我是有底线的