新特性

5.2版本的新功能

5.2驱动程序版本的新功能包括

• 添加了SearchIndexType类，您可以在创建SearchIndexModel实例时传递它。此更改允许您在创建Atlas Search或Vector Search索引时指定索引类型。有关更多信息，请参阅的SearchIndexModel API文档.

• 将实现SCRAM-SHA-1和SCRAM-SHA-256身份验证机制的算法实现委托给配置的JCA提供程序。此更改意味着您的应用程序可以使用配置的符合FIPS标准的JCA提供程序提供更高的安全性。

• 修改了mongodb-crypt依赖项版本以匹配JVM驱动程序的版本。未来的mongodb-crypt版本将与驱动程序一起发布，并将共享相同的版本号。在升级此版本驱动程序时，您必须将mongodb-crypt依赖项升级到v5.2.0。有关更多信息，请参阅的正在使用加密指南.

• 在所有支持的平台实现原生加密带来的性能提升。以下列表描述了根据您的操作系统实现此改进所需采取的操作

  • Windows：将您的 mongodb-crypt 版本升级到 v5.2.0。

  • Mac：将您的 mongodb-crypt 版本升级到 v5.2.0。

  • Linux：直接在文件系统中安装 libmongocrypt.so，而不是使用 mongodb-crypt JAR 文件中捆绑的文件。您可以在 服务器手册 中找到安装 libmongocrypt 的 Linux 指令。如果您使用包管理器安装 libmongocrypt，Java Native Access (JNA) 将无需进一步配置即可找到它。或者，您可以通过设置 LD_LIBRARY_PATH 环境变量为 libmongocrypt 包的文件路径来指定搜索路径。

    我们建议直接安装，因为捆绑的共享库由于 OpenSSL 二进制不兼容的可能性而没有链接到 OpenSSL。

    共享库加载由 JNA 处理。您可以在 NativeLibrary 类文档 中查看库加载搜索路径顺序的规则。

• 修复了导致 InsertOneResult.getInsertedId() 和 InsertManyResult.getInsertedIds() 方法在某些情况下返回不正确的文档 ID 的问题。此更改已回滚到 Scala 驱动程序 v5.1.4 和 v4.11.4。

• 当分片集群操作失败时，如果其他 mongos 服务器可用，驱动程序会避免在选择操作重试尝试时选择相同的 mongos 服务器。

• 添加当您的应用程序使用 GraalVM Native Image 时所需的可达性元数据。这些元数据替换了使用驱动库时收集可达性元数据的需求。要了解更多信息，请参阅 GraalVM 文档中的可达性元数据。

  此更改不会添加 libjnidispatch 和 libmongocrypt 资源条目，因为为所有受支持的平台（目标）添加条目会显著影响使用 GraalVM Native Image 构建的本地可执行文件的大小。查看此示例 resource-config.json 文件，了解如何在驱动 GitHub 存储库中显式指定这些条目，如果您的应用程序依赖于 org.mongodb:mongodb-crypt 库。

• 通过扩展 VectorSearchOptions API 来启用精确向量搜索，引入以下特定选项子类型

  • ExactVectorSearchOptions：使用此选项类型来启用精确匹配，确保结果是最接近查询向量的向量。

  • ApproximateVectorSearchOptions：使用此选项类型来启用可能不会返回精确最接近向量的搜索。您可以在实例化此类型时传递一个 numCandidates 参数来指定要考虑的最近邻数量。

  要了解更多关于使用 Atlas 向量搜索功能的信息，请参阅Atlas 向量搜索快速入门 并从语言下拉菜单中选择Scala.

5.1.3版本更新内容

5.1.3驱动程序补丁版本包括以下更改

• 修复了使用Cursor类型时可能导致的断言错误的问题。

5.1.1版本更新内容

5.1.1驱动程序补丁版本包括以下更改

• 在使用MONGODB-OIDC身份验证机制时，不得在authMechanismProperties连接字符串值中包含逗号字符。

5.1版本更新内容

有关v5.1版本中引入的其他更改的信息，请参阅Java Sync Driver文档中的更新内容指南。