Docs 主页 → 开发应用程序 → MongoDB Manual
兼容性
带有相等查询的可查询加密在 MongoDB 7.0 及更高版本中普遍可用 (GA)。6.0 版中发布的可查询加密公共预览版已不再受支持。使用公共预览版加密的数据与功能版本不兼容。有关更多信息，请参阅 MongoDB 7.0 中的兼容性更改。
本页介绍了与可查询加密和客户端字段级加密兼容的 MongoDB 版本和驱动程序版本，以帮助您确定您的部署是否支持每个正在使用的加密功能。
可查询加密兼容性
您可以在 MongoDB 7上使用 Queryable Encryption。 0或更高版本的副本集或分片集群，但不是独立实例。下表显示了哪些 MongoDB 服务器产品支持哪些可查询加密机制：
产品名称 | 最低版本 | 支持具有自动加密功能的 Queryable Encryption | 支持使用显式加密进行 Queryable Encryption |
|---|---|---|---|
MongoDB Atlas [ 1 ] | 7.0 | 是 | 是 |
MongoDB Enterprise Advanced | 7.0 | 是 | 是 |
MongoDB Community Edition | 7.0 | 否 | 是 |
| [1] | Queryable Encryption 与 MongoDB Atlas 兼容，但与 MongoDB Atlas Search 不兼容。 |
Queryable Encryption 驱动程序兼容性
Queryable Encryption 需要以下最低版本才能兼容 MongoDB 驱动程序：
驱动 | 最低版本 | 加密库 |
|---|---|---|
1 。 24 。 0 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
3 。 8 。 0 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
2 。 20 。 0 | 无需额外依赖。 | |
1.12 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
1 。 24 。 0 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
3 。 8 。 0 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
2 。 20 。 0 | 无需额外依赖。 | |
1.12 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
4.10.0 | mongodb-crypt 版本1 。8 。0 或更高版本 | |
5 。 5 。 0 | mongodb-client-encryption 版本2 80。 。 或更高版本。 节点6 。 0 。 0或更高版本需要与 Node.js 驱动程序具有相同主版本号的 | |
1.16 | 无需额外依赖。 | |
4.4 | pymongocrypt 版本1 6。 或更高版本。 | |
2.19 | libmongocrypt-helper 版本1 80。 。 或更高版本。 | |
2.6.0 | libmongocrypt版本1 。 8 。 0或更高版本。 | |
4.10.0 | mongodb-crypt 版本1 。8 。0 或更高版本 |
MongoDB 支持限制
在集合上启用 Queryable Encryption 会导致某些诊断命令中的字段被脱敏，并且查询日志中会省略一些操作。这限制了 MongoDB 的支持工程师获取可用的数据，特别是在分析查询性能时。要衡量操作对加密集合的影响，可使用第三方应用程序性能监控工具来收集指标。
客户端字段级加密兼容性
您可以在 MongoDB 4上使用客户端字段级加密 (CSFLE)。 2或更高版本的副本集或分片集群，但不是独立实例。下表显示了哪些 MongoDB 服务器产品支持哪些客户端字段级加密机制：
产品名称 | 最低版本 | 支持具有自动加密功能的 CSFLE | 支持具有显式加密的 CSFLE |
|---|---|---|---|
MongoDB Enterprise Advanced | 4.2 | 是 | 是 |
MongoDB Community Edition | 4.2 | 否 | 是 |
客户端字段级加密驱动程序兼容性
客户端字段级加密需要以下最低版本才能兼容 MongoDB 驱动程序。
重要
密钥轮换支持
要使用密钥轮换 API，您必须使用特定版本的驱动程序绑定包或libmongocrypt 。
驱动 | 最低版本 | 密钥轮换要求 |
|---|---|---|
1 。 17 。 5 | 没有其他要求。 | |
3.6.0 | 没有其他要求。 | |
2 。 10 。 0 | 驱动程序版本2 。 17 。 1或更高版本。 | |
1.2 | libmongocrypt 版本1 。 5 。 2或更高版本。 | |
3 。 11 。 0 | mongodb-crypt 版本1 。 7 。 3或更高版本。 | |
1.12.0 | mongodb-crypt 版本1 。 7 。 3或更高版本。 | |
3.4.0 | 对于驱动程序版本6 。 0或更高版本，请使用与驱动程序相同的 mongodb-client-encryption主要版本。否则，使用mongodb-client-encryption 2 。 2 。 0 - 2 .x。 | |
1.6.0 | 没有其他要求。 | |
3 。 10 。 0 | pymongocrypt 版本1 。 3 。 1或更高版本。 | |
2 。 12 。 1 | 没有其他要求。 | |
2 。 7 。 0 | 没有其他要求。 |