Docs 菜单
Docs 主页
/
客户端库
/
Go
Docs 主页
/
客户端库
/
Go
Docs 主页
/
客户端库
/
Go

新增功能

提示

版本说明

要了解有关各版本之间的更改和更新的更多信息，您可以阅读与驱动程序源代码一起发布的 发布说明。

了解以下版本中的新功能：

  • 版本 1.12.1

  • 版本 1.12

1.12.1 中的新功能

1.12 Go 驱动程序版本包括以下改进和修复：

  • 结束会话时，驱动程序会取消固定连接。这样，当用户在连接到负载均衡器的情况下运行事务时，连接不会泄漏。

  • 当您解组具有无效类型的空 bson.RawValue 类型或封送 ReadConcern实例的 nil 指针时，驱动程序不会引发运行时错误。

  • 将 options.LogComponentAll 正确设置为日志组件会导致针对所有组件发布日志。

1.12 中的新功能

重要

弃用通知

  • mongo.NewClient() 和 client.Connect() 方法已弃用。您可以使用 mongo.Connect() 方法在一次调用中创建客户端并进行连接。

1.12 的新增功能Go 驱动程序发布版本包括：

可查询加密

此驱动程序版本增加了对可查询加密（QE）的支持。如要详细了解使用 QE 功能的要求，请参阅可查询加密驱动程序兼容性表。

创建新的加密集合时，ClientEncryption.CreateEncryptedCollection() 方法会自动创建数据加密密钥。要学习；了解如何使用 QE功能，请参阅服务器手册中的Queryable Encryption快速入门。

日志接口

您现在可以通过 LogSink 日志记录接口来记录连接管理和命令执行事件。

要学习；了解详情，请参阅日志基础知识指南。

其他 BSON 编组选项

此驱动程序版本向 options 包添加了功能，以指定驱动程序如何编组和解组 BSON。

以下示例展示如何在 Client 上设置 BSON 选项。这些选项指定以下行为：

  • 如果缺少 bson struct 标记，则驱动程序将回退到使用 json struct 标记。

  • 驱动程序将 nil Go 映射类型编组为空 BSON 文档。

  • 驱动程序将 nil Go 切片类型编组为空 BSON 数组。

bsonOpts := &options.BSONOptions{
     UseJSONStructTags: true,
     NilMapAsEmpty:     true,
     NilSliceAsEmpty:   true,
}
options.Client().SetBSONOptions(bsonOpts)

有关如何指定和实现BSONOptions 类型的完整示例，请参阅API文档。

简化的写关注规范

此驱动程序版本简化了WriteConcern API。如要了解有关更改的更多信息，请参阅写关注。

其他更改

  • 支持使用 EKS 中的 AWS IAM 角色进行身份验证。

  • 添加 Cursor.SetBatchSize() 方法，允许指定在遍历游标时获取批次的大小。

  • 添加 UnmarshalValue() 方法，允许对使用 MarshalValue() 方法编组的 BSON 值予以解组。

后退

快速参考

来年

使用示例

在此页面上