FerretDB v1.17.0 技术解析：无后端构建、$natural 排序与 listCollections 增强

后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载本篇技术指南以 FerretDB 官方 v1.17.0 发布说明website/blog/2023-12-19-ferretdb-releases-v117.md为核心展开系统讲解该版本带来的两大核心新特性——通过 Go 构建标签编译出无 PostgreSQL/SQLite 后端的 FerretDB、以及$natural排序与集合 UUID 生成并逐一拆解listDatabases、validate、listCollections等命令的修复与字段增强。读完本文你将掌握 v1.17.0 的发布全貌并能理解这些能力在当前 FerretDB 代码库中的落点与演进脉络。一、版本背景2023 收官之发布v1.17.0 是 FerretDB 在 2023 年impressive year的收官版本。回顾这一年FerretDB 围绕把 MongoDB 工作负载带回开源这一使命取得了多项进展新增 SQLite 后端、重构架构以支持更多后端包括 MySQL 与 SAP Hana、显著改善性能、提升对更多应用与使用场景的兼容性、并登陆多家托管云平台。与此同时官方文档体系也经历了大规模改进并在该版本启用了文档版本化versioning机制——这一点在当前仓库中依然可见例如 website/versioned_docs 下按version-v1.24、version-v2.5、version-v2.7组织的多版本文档目录以及 website/versioned_sidebars 中对应的版本化侧边栏文件。本次发布还新增了 3 位贡献者wazir-ahmed、anunayasri、hungaikev社区规模持续扩大。二、核心新特性无后端构建ferretdb_no_postgresql / ferretdb_no_sqlitev1.17.0 最重要的一项能力是允许构建不带任何后端的 FerretDB通过设置ferretdb_no_postgresql和ferretdb_no_sqlite两个 Go 构建标签build tags可以分别或同时剔除 PostgreSQL 与 SQLite 后端最终产出一个无后端的二进制。这为嵌入式使用、后端自研或仅需协议层/API 层的场景提供了极大的编译期灵活性。2.1 构建标签的语义与用法在 Go 中构建标签通过//go:build约束build constraints在编译期生效典型用法如下# 仅剔除 PostgreSQL 后端保留 SQLite go build -tags ferretdb_no_postgresql ./cmd/ferretdb # 仅剔除 SQLite 后端保留 PostgreSQL go build -tags ferretdb_no_sqlite ./cmd/ferretdb # 同时剔除两个后端构建无后端版本 go build -tags ferretdb_no_postgresql ferretdb_no_sqlite ./cmd/ferretdb这种机制意味着 FerretDB 从双后端绑定演进为后端按需编译天然支持未来接入 MySQL、SAP Hana 等更多后端而不会让单一二进制体积与依赖无限膨胀。2.2 构建标签机制在当前仓库中的落点从当前仓库的源码看构建标签Go build tags是 FerretDB 构建体系中的一等公民。在 build/version/version.go 的包级文档中专门设有 Go build tags 一节系统列出了会影响 FerretDB 构建的标签及其语义例如ferretdb_dev—— 启用开发构建启用 race detector 的构建会隐式带上开发构建行为差异包括显著更慢、部分随机值被固定以便调试、部分内部错误直接崩溃、更激进地收集堆栈、退出时向 stderr 输出指标、默认日志级别为 debug。需要说明的是当前仓库属于 v2 代码线其build/version/version.go中正式文档化的构建标签列表为ferretdb_dev等从当前构建约束搜索结果看仓库中还使用ferretdb_bw见 build/ferretdb-bw/ferretdb/ferretdb.go与ferretdb_testenvdata见 integration/shareddata_test.go等标签而 v1.17.0 时代引入的ferretdb_no_postgresql/ferretdb_no_sqlite已不在当前列表之中。可以推断后端编译开关机制在后继版本中经历了演进与重构但以构建标签控制编译范围这一设计思路被完整保留了下来。2.3 与嵌入式能力的呼应无后端构建的意义与 FerretDB 的嵌入式形态互为表里。在 ferretdb/ferretdb.go 中ferretdb包被明确注释为 embeddable FerretDB implementation嵌入式实现其包级文档还专门引导读者查阅build/version包文档以了解影响该包的 Go 构建标签见 ferretdb/ferretdb.go。开发者既可以通过Config结构体如PostgreSQLURL、ListenAddr、StateDir、LogLevel、LogOutput、Telemetry等字段以库的形式嵌入 FerretDB也可以通过构建标签裁剪后端依赖——两者结合让按需裁剪、按需嵌入成为可能。三、新特性$natural 排序支持v1.17.0 为查询增加了对$natural排序的支持用户现在可以对 capped collection 使用{$natural: 1}与{$natural: -1}按 RecordID 进行物理顺序的正向/逆向扫描。3.1 什么是 $natural 排序在 MongoDB 语义中$natural排序不依赖任何索引而是按照文档在存储介质中的物理顺序返回结果对于 capped collection 这类天然有序的集合$natural排序是常见且高效的操作方式// 按物理存储顺序正序读取 capped collection db.cappedCollection.find().sort({ $natural: 1 }) // 按物理存储顺序倒序读取 capped collection通常用于读取最新写入的文档 db.cappedCollection.find().sort({ $natural: -1 })v1.17.0 在 FerretDB 中实现了这一语义{$natural: 1}与{$natural: -1}按 RecordID 排序仅适用于 capped collection为依赖该特性的应用如日志、事件流、操作日志类场景补齐了兼容性。值得一提的是capped collection 有序读取这一组合在 FerretDB 生态中有其实际用例例如 website/versioned_docs/version-v1.24/configuration/oplog-support.md 中即说明OpLog 作为 capped collection 以避免数据无界增长。可以推断v1.17.0 的$natural排序支持为后续 OpLog 等有序场景的实现铺平了道路。3.2 使用前提与限制$natural排序仅适用于 capped collection排序键必须是$natural取值为1正序或-1倒序其底层对应 RecordID 的物理顺序而非字段值顺序。四、新特性集合 UUID 生成并在 listCollections 中可见v1.17.0 启用了集合 UUIDcollection UUID的生成并使其在listCollections命令的输出中可见。UUID 是 MongoDB 中每个集合的稳定唯一标识客户端如驱动、GUI 工具常通过它跟踪集合身份即便集合被重命名也不会改变。启用该特性后listCollections返回的集合条目中会携带对应的 UUID 字段应用侧可以据此实现与 MongoDB 一致的集合身份识别逻辑。五、Bug 修复与增强5.1 修复listDatabases 在 nameOnly 参数下的过滤错误v1.17.0 修复了listDatabases命令在传入nameOnly参数时的过滤错误。nameOnly用于仅返回数据库名称而非完整信息对象此前在该参数下过滤逻辑存在缺陷会导致结果不符合预期。修复后nameOnly模式下的数据库列表过滤行为与 MongoDB 保持一致。该命令的实现在当前仓库中对应 internal/handler/msg_listdatabases.go并在 internal/handler/commands.go 附近的命令注册表中以listDatabases注册。集成测试方面可在 integration/commands_administration_test.go 中找到对该命令行为的覆盖。5.2 增强validate 诊断命令改进v1.17.0 对validate诊断命令进行了改进。validate用于检查集合/数据库内部结构的完整性其实现对应当前仓库中的 internal/handler/msg_validate.go。改进后的validate能够提供更准确的诊断信息帮助运维与开发人员定位数据层面的异常。5.3 增强listCollections.cursor 响应字段扩展v1.17.0 为listCollections命令的cursor响应新增了更多字段包括字段说明options.capped是否为 capped collectionoptions.sizecapped collection 的最大字节大小options.maxcapped collection 的最大文档数量info.readOnly集合是否为只读idIndex集合的_id索引信息这些字段让listCollections返回的元数据更加完整客户端可以一次性获取集合的容量约束、只读状态与索引信息减少额外的元数据查询。从当前仓库的实现看listCollections的调用链为msgListCollections从请求文档中解析$db数据库名见 internal/handler/msg_listcollections.go通过CreateOrUpdateByLSID处理会话LSID后调用h.p.ListCollections(connCtx, dbName, req.DocumentRaw())获取首页数据与游标 ID再通过会话注册表h.s.AddCursor管理游标最后以middleware.ResponseDoc返回分页响应。其中游标化的分页机制同样应用于 internal/documentdb/pool_cursors.go 中ListCollections的实现——返回listCollections游标首页及游标 ID。这一调用链说明listCollections的响应字段增强不仅体现在 v1.17.0 发布时点其游标化、会话化的架构在后继版本中一直延续。六、总结FerretDB v1.17.0 是一个承前启后的版本构建层面通过ferretdb_no_postgresql/ferretdb_no_sqlite构建标签实现了无后端构建让后端以可插拔方式接入呼应了 MySQL、SAP Hana 等多后端的架构演进方向查询层面$natural排序为 capped collection 补齐了物理顺序扫描能力集合 UUID 生成则提升了与 MongoDB 客户端生态的兼容性命令层面修复listDatabases的nameOnly过滤问题改进validate诊断命令并大幅扩展listCollections.cursor的元数据字段。对于希望深入研究的读者建议继续阅读以下仓库文件v1.17.0 官方发布说明 website/blog/2023-12-19-ferretdb-releases-v117.md、构建标签机制文档 build/version/version.go、嵌入式 API 定义 ferretdb/ferretdb.go、listCollections命令实现 internal/handler/msg_listcollections.go 以及命令注册表 internal/handler/commands.go。赞分享后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载相关推荐FerretDB v1.2.0 版本解析SQLite 后端雏形、排序与统计修复及 insertMany 事务优化FerretDB v1.2.0 版本解析SQLite 后端雏形、排序与统计修复及 insertMany 事务优化 FerretDB v1.2.0 是一次以修后端数据库文档数据库FerretDB 0.7.1 发布解读TLS 加密连接支持与 listCollections 过滤能力FerretDB 0.7.1 发布解读TLS 加密连接支持与 listCollections 过滤能力 本文以 FerretDB 2022 年 12 月的 v后端数据库文档数据库FerretDB 0.4.0 技术解析字段更新操作符、数组查询与多后端探索FerretDB 0.4.0 技术解析字段更新操作符、数组查询与多后端探索 FerretDB 0.4.0 是该项目在 2022 年年中发布的一个重要里程碑版本后端数据库文档数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考