后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载FerretDB v1.6.0 是面向 MongoDB 兼容层的又一次功能性与健壮性升级在已有 SQLite 后端 Beta 支持的基础上新增了ping命令与getParameter方法的实现同时通过killCursors命令显著改善游标生命周期管理并修复了$set更新同一_id报错、findOne()查询翻译异常等若干历史问题。本文以该版本的官方发布说明为骨架结合当前仓库源码与集成测试逐一还原这些功能背后的实现路径帮助你理解命令解析、参数选择与游标回收的实际行为并掌握升级到该版本前后的注意事项。版本背景SQLite 后端 Beta 能力持续补全FerretDB v1.6.0 的核心工作围绕此前引入的 SQLite 后端 Beta 支持展开。该版本为 SQLite 后端补齐了两项 MongoDB 协议层面高频使用的能力ping命令客户端驱动、监控探针用于探测服务可用性的标准命令getParameter方法用于查询服务端运行参数的诊断命令。这两项命令的加入让基于 SQLite 后端的部署在健康检查与运维诊断上与基于 PostgreSQL 后端的部署保持同等体验。在当前仓库中这两个命令分别由 internal/handler/msg_ping.go 与 internal/handler/msg_getparameter.go 实现二者已被列入 internal/handler/commands.go 的命令注册表任何后端的 FerretDB 实例都统一走同一套命令分发链路经由 internal/handler/middleware/dispatcher.go 派发到对应 handler。ping 命令一次真实的往返校验ping在 MongoDB 生态中承担双重职责一是确认服务器在线二是校验客户端与服务端之间连接与认证上下文的有效性。从源码看FerretDB 的ping并不是简单的空操作首先调用h.s.CreateOrUpdateByLSID处理会话标识lsid保证逻辑会话状态与客户端同步随后通过连接池h.p.WithConn获取一个底层连接并执行documentdb_api.BinaryExtendedVersion发起一次真实的数据库往返最后返回{ ok: 1 }。也就是说FerretDB 的ping会真正触达存储后端完成一次往返校验见 internal/handler/msg_ping.go而非仅在内核层面返回成功这使其可以作为可靠的存活探针使用。getParameter受控的参数查询getParameter命令用于读取服务端运行参数FerretDB 当前维护了如下参数集合源码见 internal/handler/msg_getparameter.go参数名值settableAtRuntimesettableAtStartup说明authenticationMechanisms[SCRAM-SHA-1, SCRAM-SHA-256]falsetrue支持的认证机制列表authSchemaVersion5truetrue认证模式版本号featureCompatibilityVersion{version: 7.0}falsefalse功能兼容版本quietfalsetruetrue日志安静模式开关该命令支持两种调用形态传入*返回全部参数对应源码中的allParameters true传入文档{showDetails: bool, allParameters: bool}按选项决定是否输出每个参数的value、settableAtRuntime、settableAtStartup细节以及是否忽略命令体中未显式点名的参数。其过滤逻辑由selectParameters完成internal/handler/msg_getparameter.go当allParameters为 false 时只返回命令文档中显式出现的参数键若最终没有任何参数被选中则返回错误码 72InvalidOptions消息为 no option found to get。这一行为与 MongoDB 保持一致并在 integration/commands_administration_test.go 中通过数十个用例得到验证包括通配符、整型/字符串/空值参数、布尔细节开关、负数与最小浮点数等边界输入。killCursors游标管理的关键升级在 v1.6.0 之前游标的创建与回收机制相对粗放长时间运行或异常中断的查询可能留下未释放的游标资源。该版本实现了killCursors命令客户端可以显式请求终止一组游标从而优化资源管理与后端性能。从 internal/handler/msg_killcursors.go 的实现看处理流程如下从命令文档中解析$db、集合名以及cursors数组逐项校验游标 ID 类型cursors中每一项必须是int64long 类型否则返回类型不匹配错误错误码 14TypeMismatch依次对每个游标执行会话级游标删除h.s.DeleteCursor与底层连接游标终止h.p.KillCursor按结果分别归类到cursorsKilled、cursorsNotFound、cursorsAlive、cursorsUnknown四个返回字段。集成测试 integration/cursor/kill_test.go 完整覆盖了四种典型场景空游标列表、错误类型 ID、已存在游标被成功终止终止后再次读取返回CursorNotFound、以及部分游标不存在时的cursorsNotFound归类确保返回结构cursorsKilled、cursorsNotFound、cursorsAlive、cursorsUnknown、ok与 MongoDB 完全对齐。配合 internal/documentdb/cursor 目录下的游标注册表实现FerretDB 在 v1.6.0 起具备了从协议层到底层的完整游标生命周期闭环。Bug 修复$set更新同一_id与findOne()查询翻译允许$set设置与文档相同的_id在早期版本中执行类似db.collection.updateOne({_id: 1}, {$set: {_id: 1, a: 1}})的更新会报错——更新操作被要求不得修改_id字段即使新值与原值完全相同也会被拒。v1.6.0 修复了该问题当$set写入的_id与文档现有_id相等时视为幂等操作直接放行不再抛出错误。对应的兼容性测试位于 integration/query/findandmodify_compat_test.go其注释 to have the same _id for target and compat 明确验证了目标后端与 MongoDB 参考实现在此场景下行为一致。findOne()的 PostgreSQL 查询翻译修复另一个被重点修复的问题是findOne()查询无法被正确翻译为对应的 PostgreSQL 查询语句并且会引发显著延迟。尽管当前仓库已演进到 v2 架构查询执行由 internal/documentdb/documentdb_core/documentdb_core.go 等模块承担该修复的意义在于验证了单文档读取这一高频路径在查询翻译层需要被当作特殊形态处理——即限制返回条数并提前结束扫描而不是退化为全量查询后截断。相关行为可在 integration/query/main_test.go 与 integration/query/findandmodify_compat_test.go 中找到持续回归验证。其他变化Tigris 后端终止支持与功能增强相对的是平台策略的收敛FerretDB 在 v1.6.0 中正式确认将停止对 Tigris 后端的支持。官方说明明确指出若仍需使用 Tigris 后端请不要将 FerretDB 升级到 v1.5.0 之后的版本更早的、仍含 Tigris 支持的发布版本均可继续使用。与此同时该版本的 README 补充了更多 SQLite 后端的部署与配置指引便于用户在新后端上快速上手相关后端配置可参考仓库根目录的 README.md 与 docker-compose.yml。升级建议与总结综合来看FerretDB v1.6.0 的增量价值集中在三点SQLite 后端可用性提升ping与getParameter让基于 SQLite 的部署具备了完整的健康检查与参数诊断能力资源管理更可控killCursors使客户端能主动回收不再使用的游标降低长连接场景下的资源占用兼容性细节修正$set幂等更新_id、findOne()查询翻译等问题被修复减少了应用迁移时遇到的边界错误。如果你正在从 v1.5.0 及更早版本升级建议先确认是否仍依赖 Tigris 后端若已迁移到 PostgreSQL 或 SQLite 后端则可以放心升级并通过getParameter快速核验新实例的运行参数是否符合预期。赞分享后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载相关推荐FerretDB v1.5.0 发布SQLite 后端 Beta 支持全面解读与实战指南FerretDB v1.5.0 发布SQLite 后端 Beta 支持全面解读与实战指南 2023 年 7 月FerretDB 发布 v1.5.0首次为后端数据库文档数据库FerretDB v1.11.0 版本解析SQLite 后端稳定性修复与 MongoDB 数据迁移指南FerretDB v1.11.0 版本解析SQLite 后端稳定性修复与 MongoDB 数据迁移指南 本文以 FerretDB v1.11.0 官方发布说明后端数据库文档数据库FerretDB v1.24 发布解析SQLite 后端认证支持与初始用户配置实战FerretDB v1.24 发布解析SQLite 后端认证支持与初始用户配置实战 FerretDB v1.24 是 MongoDB 兼容的开源替代方案 Fe后端数据库文档数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FerretDB v1.6.0 发布解读：SQLite 后端 ping/getParameter、killCursors 游标管理与关键修复
后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载FerretDB v1.6.0 是面向 MongoDB 兼容层的又一次功能性与健壮性升级在已有 SQLite 后端 Beta 支持的基础上新增了ping命令与getParameter方法的实现同时通过killCursors命令显著改善游标生命周期管理并修复了$set更新同一_id报错、findOne()查询翻译异常等若干历史问题。本文以该版本的官方发布说明为骨架结合当前仓库源码与集成测试逐一还原这些功能背后的实现路径帮助你理解命令解析、参数选择与游标回收的实际行为并掌握升级到该版本前后的注意事项。版本背景SQLite 后端 Beta 能力持续补全FerretDB v1.6.0 的核心工作围绕此前引入的 SQLite 后端 Beta 支持展开。该版本为 SQLite 后端补齐了两项 MongoDB 协议层面高频使用的能力ping命令客户端驱动、监控探针用于探测服务可用性的标准命令getParameter方法用于查询服务端运行参数的诊断命令。这两项命令的加入让基于 SQLite 后端的部署在健康检查与运维诊断上与基于 PostgreSQL 后端的部署保持同等体验。在当前仓库中这两个命令分别由 internal/handler/msg_ping.go 与 internal/handler/msg_getparameter.go 实现二者已被列入 internal/handler/commands.go 的命令注册表任何后端的 FerretDB 实例都统一走同一套命令分发链路经由 internal/handler/middleware/dispatcher.go 派发到对应 handler。ping 命令一次真实的往返校验ping在 MongoDB 生态中承担双重职责一是确认服务器在线二是校验客户端与服务端之间连接与认证上下文的有效性。从源码看FerretDB 的ping并不是简单的空操作首先调用h.s.CreateOrUpdateByLSID处理会话标识lsid保证逻辑会话状态与客户端同步随后通过连接池h.p.WithConn获取一个底层连接并执行documentdb_api.BinaryExtendedVersion发起一次真实的数据库往返最后返回{ ok: 1 }。也就是说FerretDB 的ping会真正触达存储后端完成一次往返校验见 internal/handler/msg_ping.go而非仅在内核层面返回成功这使其可以作为可靠的存活探针使用。getParameter受控的参数查询getParameter命令用于读取服务端运行参数FerretDB 当前维护了如下参数集合源码见 internal/handler/msg_getparameter.go参数名值settableAtRuntimesettableAtStartup说明authenticationMechanisms[SCRAM-SHA-1, SCRAM-SHA-256]falsetrue支持的认证机制列表authSchemaVersion5truetrue认证模式版本号featureCompatibilityVersion{version: 7.0}falsefalse功能兼容版本quietfalsetruetrue日志安静模式开关该命令支持两种调用形态传入*返回全部参数对应源码中的allParameters true传入文档{showDetails: bool, allParameters: bool}按选项决定是否输出每个参数的value、settableAtRuntime、settableAtStartup细节以及是否忽略命令体中未显式点名的参数。其过滤逻辑由selectParameters完成internal/handler/msg_getparameter.go当allParameters为 false 时只返回命令文档中显式出现的参数键若最终没有任何参数被选中则返回错误码 72InvalidOptions消息为 no option found to get。这一行为与 MongoDB 保持一致并在 integration/commands_administration_test.go 中通过数十个用例得到验证包括通配符、整型/字符串/空值参数、布尔细节开关、负数与最小浮点数等边界输入。killCursors游标管理的关键升级在 v1.6.0 之前游标的创建与回收机制相对粗放长时间运行或异常中断的查询可能留下未释放的游标资源。该版本实现了killCursors命令客户端可以显式请求终止一组游标从而优化资源管理与后端性能。从 internal/handler/msg_killcursors.go 的实现看处理流程如下从命令文档中解析$db、集合名以及cursors数组逐项校验游标 ID 类型cursors中每一项必须是int64long 类型否则返回类型不匹配错误错误码 14TypeMismatch依次对每个游标执行会话级游标删除h.s.DeleteCursor与底层连接游标终止h.p.KillCursor按结果分别归类到cursorsKilled、cursorsNotFound、cursorsAlive、cursorsUnknown四个返回字段。集成测试 integration/cursor/kill_test.go 完整覆盖了四种典型场景空游标列表、错误类型 ID、已存在游标被成功终止终止后再次读取返回CursorNotFound、以及部分游标不存在时的cursorsNotFound归类确保返回结构cursorsKilled、cursorsNotFound、cursorsAlive、cursorsUnknown、ok与 MongoDB 完全对齐。配合 internal/documentdb/cursor 目录下的游标注册表实现FerretDB 在 v1.6.0 起具备了从协议层到底层的完整游标生命周期闭环。Bug 修复$set更新同一_id与findOne()查询翻译允许$set设置与文档相同的_id在早期版本中执行类似db.collection.updateOne({_id: 1}, {$set: {_id: 1, a: 1}})的更新会报错——更新操作被要求不得修改_id字段即使新值与原值完全相同也会被拒。v1.6.0 修复了该问题当$set写入的_id与文档现有_id相等时视为幂等操作直接放行不再抛出错误。对应的兼容性测试位于 integration/query/findandmodify_compat_test.go其注释 to have the same _id for target and compat 明确验证了目标后端与 MongoDB 参考实现在此场景下行为一致。findOne()的 PostgreSQL 查询翻译修复另一个被重点修复的问题是findOne()查询无法被正确翻译为对应的 PostgreSQL 查询语句并且会引发显著延迟。尽管当前仓库已演进到 v2 架构查询执行由 internal/documentdb/documentdb_core/documentdb_core.go 等模块承担该修复的意义在于验证了单文档读取这一高频路径在查询翻译层需要被当作特殊形态处理——即限制返回条数并提前结束扫描而不是退化为全量查询后截断。相关行为可在 integration/query/main_test.go 与 integration/query/findandmodify_compat_test.go 中找到持续回归验证。其他变化Tigris 后端终止支持与功能增强相对的是平台策略的收敛FerretDB 在 v1.6.0 中正式确认将停止对 Tigris 后端的支持。官方说明明确指出若仍需使用 Tigris 后端请不要将 FerretDB 升级到 v1.5.0 之后的版本更早的、仍含 Tigris 支持的发布版本均可继续使用。与此同时该版本的 README 补充了更多 SQLite 后端的部署与配置指引便于用户在新后端上快速上手相关后端配置可参考仓库根目录的 README.md 与 docker-compose.yml。升级建议与总结综合来看FerretDB v1.6.0 的增量价值集中在三点SQLite 后端可用性提升ping与getParameter让基于 SQLite 的部署具备了完整的健康检查与参数诊断能力资源管理更可控killCursors使客户端能主动回收不再使用的游标降低长连接场景下的资源占用兼容性细节修正$set幂等更新_id、findOne()查询翻译等问题被修复减少了应用迁移时遇到的边界错误。如果你正在从 v1.5.0 及更早版本升级建议先确认是否仍依赖 Tigris 后端若已迁移到 PostgreSQL 或 SQLite 后端则可以放心升级并通过getParameter快速核验新实例的运行参数是否符合预期。赞分享后端数据库文档数据库【免费下载链接】FerretDBA truly Open Source MongoDB alternative项目地址https://gitcode.com/gh_mirrors/fe/FerretDB点击查看免费下载相关推荐FerretDB v1.5.0 发布SQLite 后端 Beta 支持全面解读与实战指南FerretDB v1.5.0 发布SQLite 后端 Beta 支持全面解读与实战指南 2023 年 7 月FerretDB 发布 v1.5.0首次为后端数据库文档数据库FerretDB v1.11.0 版本解析SQLite 后端稳定性修复与 MongoDB 数据迁移指南FerretDB v1.11.0 版本解析SQLite 后端稳定性修复与 MongoDB 数据迁移指南 本文以 FerretDB v1.11.0 官方发布说明后端数据库文档数据库FerretDB v1.24 发布解析SQLite 后端认证支持与初始用户配置实战FerretDB v1.24 发布解析SQLite 后端认证支持与初始用户配置实战 FerretDB v1.24 是 MongoDB 兼容的开源替代方案 Fe后端数据库文档数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考