升级驱动程序版本
Overview
本页介绍了升级到新版本的C驾驶员程序时必须对应用程序进行的更改。
升级前,请执行以下操作:
确保新的C驾驶员版本与应用程序连接到的MongoDB Server版本以及应用程序运行的平台兼容。有关版本兼容性信息,请参阅 C驾驶员兼容性页面。
在 重大更改部分中,解决应用程序使用的当前驾驶员版本与计划升级版本之间发生的任何重大更改。要学习;了解有关MongoDB Server发布兼容性更改的更多信息,请参阅服务器版本兼容性更改部分。
提示
为了最大限度地减少应用程序程序将来升级驾驶员版本时所需的更改数量,请使用 Stable API。要学习;了解更多信息,请参阅 Stable API指南。
重大更改
注意
C驾驶员遵循语义版本控制。 该驾驶员可能会破坏任何发布中的构建系统或包兼容性。补丁版本可能会恢复意外的API重大更改。
重大更改是对从特定版本的驱动程序开始的约定或行为的更改。 如果在升级驱动程序之前未解决,此类更改可能会导致应用程序无法正常工作。
本部分中的破坏性变更 (breaking change) 按引入它们的驱动程序版本进行分类。升级驱动程序版本时,请解决当前版本和升级版本之间的所有破坏性变更 (breaking change)。
例子
从版本1.26升级
如果您要将C驾驶员从版本 1.26 升级到版本 1.27,请解决为版本 1.27.0 到 1.27.6 列出的所有重大更改(如果有)。
版本 1.24.0破坏性变更
构成C驾驶员的库之一 libmongoc
的 1.24.0发布引入了以下破坏性破坏性变更 (breaking change):
需要MongoDB Server 7.0 及更高版本才能使用Queryable Encryption。
服务器版本兼容性更改
服务器版本兼容性更改是对驱动程序的修改,停止对一组 MongoDB 服务器版本的支持。
该驱动程序在 MongoDB Server 版本的生命周期结束 (EOL) 后将停止支持。
要学习;了解有关MongoDB对 EOL 产品的支持的更多信息,请参阅传统支持策略。