新機能

Tip

リリースノート

バージョン間の変更や更新の詳細については、リリースノートをお読みくださいドライバーソースコードで公開されます。

次の新機能をご覧ください。

バージョン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 回の呼び出しで接続できます。

1.12の新機能 Go ドライバーのリリースには、次のものが含まれます。

Queryable Encryption

このドライバーバージョンは、 Queryable Encryption （QE）のサポートを追加します。 QE 機能を使用するための要件の詳細については、「 Queryable Encryption ドライバーの互換性テーブル」を参照してください。

ClientEncryption.CreateEncryptedCollection() メソッドは、新しい暗号化されたコレクションを作成するときに、データ暗号化キーを自動的に作成します。QE 機能の使用方法については、サーバーマニュアルのQueryable Encryptionクイックスタートを参照してください。

ログ記録インターフェース

LogSinkロギングインターフェースを使用して、接続マネジメントとコマンド実行イベントを記録できるようになりました。

詳しくは、「ログの基礎ガイド」をご覧ください。

追加の BSON マーシャリングオプション

このドライバーバージョンは、ドライバーが BSON をマーシャリングおよびアンマーシャリングする方法を指定する機能をoptionsパッケージに追加します。

次の例は、 Clientで BSON オプションを設定する方法を示しています。オプションは、次の動作を指定します。

bson構造体タグが存在しない場合、ドライバーはjson構造体タグにフォールバックします。
ドライバーはnil Go マップ型を空の BSON ドキュメントとしてマーシャリングします。
ドライバーはnil Go スライスタイプを空の BSON 配列としてマーシャリングします。

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

BSONOptions型を指定して実装する方法の完全な例については、 API ドキュメントを参照してください。

簡略化された書込み保証 (write concern) の仕様

このドライバーバージョンにより、 WriteConcern API が簡素化されます。変更の詳細については、「書込み保証 ( write concern) 」を参照してください。

追加の変更

EKS のAmazon Web Services IAM ロールによる認証をサポートします。
カーソルの反復処理時に取得されるバッチのサイズを指定できるようにするためのCursor.SetBatchSize()メソッドの追加。
MarshalValue()メソッドでマーシャリングされた BSON 値のマーシャリングを可能にするためのUnmarshalValue()メソッドの追加。

戻る

クイックリファレンス

使用例

Tip