リリースノート

2.3の新機能

このリリースには、次の改善点と修正が含まれています。

• 操作タイムアウト以上の maxAwaitTimeMS 値を使用して cursor.Next() を呼び出すとソケット タイムアウトが発生する問題を修正します。ドライバーはこれらの呼び出しを短縮して、タイムアウト エラーを防ぐようになりました。

• Element.StringN() が期待どおりに string を切り捨てない問題を修正しました。

• bson.Unmarshal() のパフォーマンスを向上させます。

このバージョンの変更の詳細については、 Githubの v2.3 リリースノート を参照してください。

2.2の新機能

このリリースには、次の改善点と修正が含まれています。

• 空の値がシリアル化されるのをグローバルに防ぐには、OmitEmpty BSONオプションを追加します。OmitEmpty グローバル フラグの設定の詳細については、 BSONガイドのBSONオプション セクションの例を参照してください。

• Kubernetes OIDC認証のサポートを追加します。KubernetesクラスターのMongoDB認証を構成する方法の詳細については、 エンタープライズ認証メカニズムガイドの「Kubernetes OIDC」セクションを参照してください。

• データ暗号化キー（DEK）キャッシュの有効期間を構成するサポートを追加します。DEK 管理の詳細については、 MongoDB Serverマニュアルの「 暗号化キー管理 」ガイドを参照してください。

• エラー管理を改善するために error.Is 関数と error.As 関数のサポートを追加します。詳しくは、 Go APIドキュメント および エラーを参照してください。

このバージョンの変更の詳細については、 Githubの v2.2 リリースノート を参照してください。

2.1の新機能

2.1 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• Client.BulkWrite メソッドを導入し、クライアントが 1 回のリクエストで複数のデータベースとコレクションにわたって複数の挿入、アップデート、削除操作を実行できるようにします。詳細については、一括操作ガイドを参照してください。

• Atlas ベクトル検索を使用してベクトルデータの挿入とクエリを簡単かつ効率的にするために、 bson.Vector タイプを導入します。bson.Vector 型を使用する例については、Atlas ベクトル検索ガイド を参照してください。

• ServerError インターフェースを拡張して、操作実行中にサーバーによって返される重複したエラー コードのリストを返す ErrorCodes を含めます。

• sortスタンドアロンの更新操作と置換操作、および一括操作の UpdateOneOptions と ReplaceOptions に オプションを追加します。

このバージョンの変更の詳細については、 Githubの v2.1 リリースノート を参照してください。

2.0の新機能

2.0 Goドライバーのリリースは、 OpenID Connect（OIDC）認証をサポートし、よりスムーズなクライアント側の操作タイムアウト（CST）エクスペリエンスを提供し、API の効率化、エラー説明の改善、ドライバーパッケージ構造の簡素化により、より明確で慣用的なGoコードを実装します。

これらの変更の詳細については、このセクションを参照するか、 GithubのGoドライバーソースコードでv2.0 移行ガイドを表示してください。

このリリースには、次の改善点と修正が含まれています。

• OpenID Connect（OIDC）認証のドキュメント サポート。詳細については、 OIDC 認証メカニズムのガイド を参照してください。

• GridFS APIには mongoパッケージからアクセスできます。 以前のバージョンでは、別の gridfsパッケージからGridFS関数にアクセスできましたが、この機能はメインのドライバー mongoパッケージから統合されました。 詳細については、 GridFSガイド を参照してください。

• すべてのオプション構造体の Commentフィールドは、string 型ではなく any 型の値を取ります。 このフィールドを設定するには、SetComment() メソッドを使用して any 型のパラメータを渡します。

• モニタリングイベントドキュメントの更新:

  • CommandStartedEvent 構造体と CommandFinishedEvent 構造体には、接続ID を取得するための int64 タイプの単一の ServerConnectionIDフィールドがあります。

  • PoolEvent 構造体の ConnectionIDフィールドは、uint64 ではなく int64 型の値を取ります。

  サンプルイベントドキュメントを表示するには、アプリケーション イベントの監視 のガイドを参照してください。

• Session インターフェースは 構造体に変換されます。 詳細については、「 トランザクション 」ガイドを参照してください。

• Distinct() メソッドは、指定された型にデコードできる構造体を返します。 詳細については、「 個別の値の取得 」ガイドを参照してください。

• IndexView.DropOne() メソッドは、存在する場合はエラーのみを返します。 以前のバージョンでは、このメソッドは削除されたインデックスの数を含むサーバー応答も返していました。 詳細については、「 インデックスガイドの「 インデックスの削除 」セクションを参照してください。

• optionsパッケージ内の 型のビルダ パターンをアップデートします。パターンはセッター関数のスライスを保持するため、 オプションオブジェクトにデータを直接設定することはできません。この更新では、オプションの作成方法と使用方法は通常変更されません。詳しくは、機能の JIRAチケットを参照してください。

• ドライバーは、書込み操作が確認されない場合、mongo.ErrUnacknowledgedWrite 送信エラーをサポートしなくなりました。 サーバーが書込み (write)操作を確認したことを確認するには、書込み (write) メソッドによって返される結果構造体から Acknowledgedプロパティにアクセスする必要があります。

  次の例は、挿入操作の確認応答を確認する方法を示しています。

  res, err := coll.InsertOne(context.TODO(), bson.D{{"x", 2}})
  if err != nil {
     panic(err)
  }
  fmt.Print(res.Acknowledged)

• TransactionOptionsインスタンスを作成し、そのインスタンスを SessionOptions タイプの SetDefaultTransactionOptions() メソッドに渡すことで、特定のセッションで実行されるトランザクションのオプションを設定できます。 詳細については、 トランザクションガイドの「 セッションとトランザクション オプション 」セクションを参照してください。

• Collection.Clone() メソッドはエラーを返しません。

• UnmarshalExtJSON() メソッドの canonical パラメータの名前を canonicalOnly に変更します。canonicalOnly を true に設定すると、拡張JSON が標準モードでマーシャリングされていない場合、 メソッドはエラーを返します。false に設定すると、メソッドは標準または緩和されたJSONのマーシャリングをアンマーシャリングできます。詳細については、 「UnmartsJSON() APIドキュメント」 を参照してください。

1.17の新機能

1.17 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• OpenID Connect（OIDC）認証のサポートを追加しました。詳細については、 OIDC 認証メカニズムのガイド を参照してください。

• Queryable Encryption（QE）範囲クエリのサポートを追加します。 この機能を使用するには、アプリを MongoDB Server 8.0以降に接続する必要があります。 QEQueryable Encryption 範囲クエリの詳細については、MongoDB Server マニュアルの「 」を参照してください。

• クライアントの一括書き込み機能を除く MongoDB Server 8.0のサポートを追加します。

• IndexViewメソッドと メソッドを含むようにDropOneWithKey() DropWithKey()タイプを拡張し、名前の代わりにキー仕様を使用してインデックスを削除できるようにします。

このバージョンの変更の詳細については、 Githubの v1.17 リリースノート を参照してください。

1.16の新機能

1.16 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• Atlas Search インデックスの作成時、インデックス タイプを指定するためのサポートを追加しました。

• zstd圧縮アルゴリズムが有効になっている場合、メモリ使用量を削減します。

• 一部の依存関係要件をアップグレードします。アップグレードのリストについては、v1.16 リリースノートの「アップグレードの依存関係」セクションを参照してください。

これらの変更の詳細については、 Githubの v1.16 リリースノート を参照してください。

1.15.1の新機能

1.15.1 Go ドライバーのパッチ リリースには、次の改善と修正が含まれています。

• レプリカセット クラスターから切断するとrttMonitor接続が残る可能性のある接続リークを修正します。

• クライアント全体のタイムアウトと操作タイムアウトが設定されている場合に、読み取りおよび集計操作にmaxTimeMS値を手動で指定するためのサポートを追加します。

• 変更ストリームで呼び出しできるRemainingBatchLength()メソッドを追加します。

これらの変更の詳細については、 Githubの v1.15.1 リリースノートを参照してください。

1.15の新機能

1.15 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• 接続チャーンは、timeoutMS 接続オプションを指定するか、SetTimeout() 関数を呼び出して、クライアント全体のタイムアウトを設定することで軽減できます。タイムアウトが設定されている場合、ドライバーは操作がタイムアウトした後に接続の再利用を試み、最大 1 秒間待機して接続が再利用できるかどうかを確認してから、接続を閉じます。

• 接続プール イベントには、チェックアウト期間と接続を確立するための合計時間数を測定するためのDurationフィールドが含まれています。

1.14の新機能

1.14 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• 1.18より前の Go バージョンはサポートされなくなりました。

• ハートビート タイムアウトが発生した場合、進行中の操作は先行してキャンセルされます。

• "mongodb+srv://"プレフィックスを含む接続文字列では、SRV ホスト名に大文字を含めることができます。

1.13の新機能

1.13 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• サーバー選択と SDAM のログ。 ロギングについて詳しくは、「 ログ記録 」のドキュメントを参照してください。

• 検索インデックスをプログラムで管理できるCollection型のメソッド。

• event.CommandStartedEventイベントとevent.CommandFinishedEventイベントはDatabaseNameフィールドを返します。 このフィールドは、 コマンド ログ アナライザにも含まれます。

• シャーディングされたトポロジーでは、失敗したクエリを再試行するためにサーバーを選択するときに、ドライバーは最初の試行に使用されたサーバーを除外します。 代わりに、適格なmongosインスタンスが複数ある場合、ドライバーはランダムに 1 つを選択します。 正常でない インスタンスは、自動的に選択対象から除外されます。

• ストリーミング SDAM は、 Amazon Web Services Lambdaおよび同様のFaaS（function-as-a-service）プラットフォームではデフォルトで無効になっています。 serverMonitoringMode URI オプションを使用してモニタリングを有効にできます。

1.12.1の新機能

1.12 Go ドライバーのリリースには、次の改善点と修正が含まれています。

• ドライバーはセッションを終了するときに接続の固定を解除します。 これにより、ユーザーがロード バランサーに接続しているときにトランザクションを実行するときに接続がリークされるのを防ぎます。

• 無効な型で空のbson.RawValue型をアンマーシャリングしたり、 ReadConcernインスタンスのnilポインターをマーシャリングしたりしても、ドライバーはランタイム エラーをスローしません。

• ログ コンポーネントとしてoptions.LogComponentAllを正しく設定すると、すべてのコンポーネントに対するログが公開されます。

1.12の新機能

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

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