版本说明

2.23 中的新功能

Ruby驾驶员2.23发布包括以下新增功能、更改和错误修复：

• 新增对使用 OpenTelemetry 跟踪驾驶员操作的支持。启用后，此功能将跟踪Ruby驾驶员操作和相应的服务器命令。您可以通过将 tracing 选项设置为 true，在 Mongo::Client实例中启用跟踪，也可以通过 OTEL_RUBY_INSTRUMENTATION_MONGODB_ENABLED 环境变量进行全局设立。

• 添加 csfle_convert_to_ruby_types 配置选项，用于将客户端字段级加密(CSFLE) 类型转换为Ruby类型。

• 将Ruby引擎（示例TruffleRuby 或 JRuby）添加到客户端元数据日志中的平台字段。

• 允许 SRV 连接字符串使用标签少于三个的有效主机名。

• 正确实施 srv_max_hosts URI 选项。

• 新增对Ruby4.0 的支持。

• 通过正确处理零（无限）和正超时值，修复 with_transaction 中的客户端操作超时 (CSOT) 处理。

要学习；了解有关此发布的更多信息，请参阅Github上的 v2.23 发布说明。

2.22 中的新功能

Ruby驱动程序2.22发布包括以下新增功能、更改和改进：

• 为 update_one 和 replace_one 方法添加排序选项。有关更多信息，请参阅 update_one 和 replace_one 的API文档。

• 在连接池签出期间为 SocketError 处理添加重试逻辑。

• 修复了当服务器被标记为 unknown 时出现的 ArgumentError。

要学习；了解有关此发布的更多信息，请参阅Github上的 v2.22 发布说明。

2.21.1 中的新功能

Ruby驱动程序2.21.1发布包括以下新增功能、更改和改进：

• 将 type 参数添加到 Mongo::SearchIndex::View#create_one 和 Mongo::SearchIndex::View#create_many 搜索索引创建方法中。这使您能够以编程方式创建MongoDB Vector Search 搜索索引。要学习并了解更多信息和查看示例，请参阅 MongoDB 搜索和 MongoDB Vector 搜索索引 指南。

• 新增与Ruby 3.3 的兼容性。要学习；了解更多信息，请参阅兼容性。

2.21 中的新功能

Ruby驱动程序2.21发布包括以下新功能：

• 支持客户端操作超时 (CSOT)功能，该功能将大多数与超时相关的选项统一在单个 timeout_ms 选项下。

• 支持MongoDB Server版本 8.0。

• 支持使用Queryable Encryption进行范围v2 查询，包括新的 trim_factor 参数。有关Queryable Encryption的更多信息，请参阅MongoDB Server手册中的Queryable Encryption 。

要学习；了解有关此发布的更多信息，请参阅Github上的 v2.21 发布说明。

2.20 中的新功能

Ruby驱动程序2.20发布包括以下新功能：

• 不再支持 Ruby 2.5 和 2.6。弃用对 Ruby 2.7 和 JRuby 9.2 的支持，这将在下一个次要驱动程序版本中停止支持。新增对 JRuby 9.4 的支持。

• 支持新发布的 Ruby BSON版本 5.0。

• 允许在主机和选项之间使用不带斜线的连接字符串。示例，mongodb://example.com?w=1 和 mongodb://example.com/?w=1 现在都是有效的连接字符串。

• 将客户端环境的容器运行时和编排元元数据发送到服务器以进行分析。

• 在检测到托管为 CosmosDB (Azure) 或 DocumentDB (Amazon)实例时，向日志写入警告消息。

• 如果可能，尝试在分片的拓扑结构中的不同 mongos实例上重试读取或写入操作。

要学习；了解有关此发布的更多信息，请参阅Github上的 v2.20 发布说明。