リリースノート

バージョン6.0.3

Django MongoDB バックエンド v6.0.3 リリースには、次の機能、改善点、修正が含まれています。

• URLパターンで一致する ObjectId のサポートを追加します。詳細については、 APIドキュメントのURLディスパッチを参照してください。

• PolymorphicEmbeddedModelField と PolymorphicEmbeddedModelArrayField サブフィールドのインデックスのサポートを追加します。インデックスの作成ガイドの 埋め込みモデル サブフィールド インデックスのセクションに示されているように、EmbeddedModelField サブフィールド インデックスと同じ構文を使用します。

• PolymorphicEmbeddedModelField と PolymorphicEmbeddedModelArrayField のサブフィールドに一意の制約のサポートを追加しました。モデル化ガイドの 埋め込みフィールド制約 のセクションに示されているように、EmbeddedModelField サブフィールドの一意の制約と同じ構文を使用します。

• SQLではなくMQLを出力するように str(queryset.query)操作を更新します。

• Queryable Encryptionが構成されていない場合にエラーを生成し、暗号化されていないデータベースに暗号化されたフィールドを持つモデルの作成を防ぎます。

• makemigrations コマンドに、埋め込みモデル参照を string としてシリアル化するように指示します。その結果、モデルが後で削除された場合は、移行においてモデル参照を調整する必要がありません。

• 以前は具体的なエラーが返されなかった QuerySet.extra(where=...) メソッドと StringAgg(..., distinct=True) メソッドに NotSupportedError を追加します。

• 埋め込みモデル フィールドのインデックスと制約の定義に、unique=True、db_index=True、Meta.constraints、Meta.indexes、Meta.unique_together の使用を廃止します。代わりに、最上位モデルで EmbeddedFieldIndex と EmbeddedFieldUniqueConstraint を使用します。新しい構文の詳細については、「埋め込みモデルのサブフィールド インデックス と 埋め込みフィールドの制約」を参照してください。

バージョン6.0.2

Django MongoDB バックエンド v6.0.2 リリースには、次の機能、改善点、修正が含まれています。

• QuerySet.intersection() メソッドと QuerySet.difference() メソッドのサポートを追加しました。

• UniqueConstraint コンストラクターの nulls_distinct パラメーターのサポートを追加します。これにより、NULL 値を持つドキュメントを1 つだけ保存できます。詳細を学ぶには、モデルの作成ガイドの「一意の制約の指定」を参照してください。

• EmbeddedFieldIndexクラスを追加します。これにより、EmbeddedModelField 値と EmbeddedModelArrayField 値のサブフィールドでインデックスが有効になります。詳細については、インデックス作成ガイドの 埋め込みモデル サブフィールド インデックス を参照してください。

• EmbeddedModelField 値と EmbeddedModelArrayField 値のサブフィールドに一意の制約を有効にする EmbeddedFieldUniqueConstraintクラスを追加します。詳細については、 モデル作成ガイドの 「埋め込みフィールド制約」 を参照してください。

• 暗号化されたフィールドを持つモデルで Model.save() を呼び出すとエラーが発生するバグを修正します。

バージョン6.0.1

Django MongoDB バックエンド v6.0.1 リリースには、次の機能、改善点、修正が含まれています。

• Queryable Encryptionのサポートを追加しました。詳しくは、「Queryable Encryption」のチュートリアルを参照してください。

• 空間検索のサポートを追加しました。詳細については、クエリの指定ガイドの「地理空間値のクエリ」を参照してください。

• Index システム チェックが 2 回実行中のを防ぎます。

• DatabaseError と IntegrityError の例外に例外メッセージを追加します。

• メソッドが正しいフィールドをプロジェクトように、QuerySet.defer() と QuerySet.only() の動作を修正します。

• 集計パイプラインから $facet の使用が排除されるため、クエリのパフォーマンスが向上します。

バージョン6.0.0

バージョン5.2.4

Django MongoDB バックエンド v5.2.4 リリースには、次の機能、改善点、修正が含まれています。

• $match ステージから $lookup ステージに複雑な条件をプッシュすることで、$lookup集計ステージを使用する結合操作のパフォーマンスを向上させます

バージョン5.2.3

Django MongoDB バックエンド v5.2.3 リリースには、次の機能、改善点、修正が含まれています。

• QuerySet.union() クエリが $projectパイプラインステージを重複するのを防ぎます。

• MongoDB がこれらを式として解釈しないようにするには、Valueクラスを更新して、string、辞書、tune 値を $literal 演算子でラップします。同様に、モデルを更新するクエリが $literal 演算子で値をラップするようになりました。これも同じ理由です。

• localField と foreignField を使用して $lookup クエリを簡素化します。

バージョン5.2.2

Django MongoDB バックエンド v5.2.2 リリースには、次の機能、改善点、修正が含まれています。

• より複雑なインデックスを作成できる次の SearchIndex 引数を追加します。

  • field_mappings

  • analyzer

  • search_analyzer

  詳細については、 インデックスガイドの「検索インデックス」を参照してください。

• データにフィールドが存在しない場合に、データベース変換を使用して EmbeddedModel フィールドを含むモデルをロードするときに発生する KeyError 例外を修正します。

• db_column 引数が EmbeddedModel フィールドに適用されることを確認します。

• EmbeddedModelField と PolymorphicEmbeddedModelField の検索インデックスタイプを embeddedDocuments から document に修正します。

• データベース接続が初期化されなかった場合に発生する transaction.atomic() エラーを修正しました。

• django_mongodb_backend.utils.parse_uri() メソッドを非推奨にします。このメソッドは将来のリリースで削除されます。

バージョン5.2.1

Django MongoDB バックエンド v5.2.1 リリースには、次の機能、改善点、修正が含まれています。

• django_mongodb_backend.utils.parse_uri() メソッドを使用する代わりに、DATABASES["HOST"] キーで接続文字列を指定するためのサポートを追加します。詳細については、 「データベース接続の構成」ガイドの 「データベース設定の自動構成」 を参照してください。

• 検索インデックスを追加または削除する移行操作に対して、サーバー上で操作が完了するまで待機するよう指示します。これにより、複数の操作を連続して実行中際の競合を防止します。

• 次の演算子を使用する単純なクエリを構成して、$expr ではなく $match を使用し、これによりインデックスを使用できるようにします。

  • $eq

  • $in

  • $and

  • $or

  • $gt

  • $gte

  • $lt

  • $lte

バージョン5.2.0

Dlango MongoDBバックエンド v5.2.0 は、初期一般提供（GA）リリースです。GA 機能の詳細については、Django MongoDB バックエンドが一般提供になりましたのブログ記事を参照してください。

バージョン 5.2.0beta3

バージョン 5.2.0beta2

D Jango MongoDBバックエンド v5.2.0beta2 リリースには、次の機能、改善点、修正が含まれています。

• MongoDB Search クエリのサポートを追加しました。詳しくは、MongoDB Search クエリの実行するガイドを参照してください。

• EmbeddedModelArrayField 値のサブクエリ サポートを追加します。詳細については、クエリの指定ガイドの「埋め込みモデル配列値のクエリ」を参照してください。

• options パラメータを django_mongodb_backend.utils.parse_uri() メソッドに追加します。

• データベーストランザクションのサポートを追加します。詳細については、トランザクションとセッションのガイドを参照してください。

• 複数のモデルクラスに属することができるモデルインスタンスまたはモデル インスタンスのリストを保存する PolymorphicEmbeddedModelField フィールドと PolymorphicEmbeddedModelArrayField フィールドを追加します。詳細については、 「モデル作成ガイド」で 「多形埋め込みモデル データを保存する」 を参照してください。

• GeoDiango のサポートを追加します。詳細については、 「地理空間データのモデル化ガイド」を参照してください。

• JSONとして解析できる string を返すように QuerySet.explain() を更新します。

• 32 ビットを超える重複値が誤って許可されていた IntegerField フィールドと PositiveBigIntegerField フィールドの一意の制約生成を修正します。int ではなく $type: long を使用するには、既存の一意の制約を再作成する必要があります。

• 次のフィールドを bson.int64.Int64 値としてMongoDBに送信し、32 ビット未満の値に対する一意の制約を修正します。

  • IntegerField

  • BigIntegerField

  • PositiveIntegerField

  • PositiveBigIntegerField

  • DurationField

• サーバー側チャンクの下限を排除することで、QuerySet のパフォーマンスを向上させます。

• いくつかの簡単な条件を $match ステージから $lookup ステージにプッシュすることで、$lookup集計ステージを使用する結合操作のパフォーマンスを向上させます。

バージョン 5.2.0beta1

D Jango MongoDBバックエンド v5.2.0beta1 リリースには、次の機能、改善点、修正が含まれています。

• モデル インスタンスのリストを保存するための EmbeddedModelArrayFieldフィールドを追加します。学ぶには、 「モデル作成ガイド」の 埋め込みモデル配列データの保存 を参照してください。

• データベース変換 を使用して、null の ArrayField 値と base_field を持つモデルをロードするときに発生するクラッシュを修正します。

バージョン 5.2.0beta0

D Jango MongoDBバックエンド v5.2.0beta0 リリースには、次の機能、改善点、修正が含まれています。

• MongoDB Search およびベクトル検索インデックスを作成できる SearchIndex クラスと VectorSearchIndex クラスを追加します。詳細については、 インデックスの作成ガイドの 検索インデックス と ベクトル検索インデックス を参照してください。

• デフォルトで 、PyMongo の接続プーリングを使用します。

• フィールドのカスタム検索と変換のサポートを EmbeddedModelField に追加します。

• Truncデータベース関数の tzinfo パラメータを使用するクエリの結果を修正します。

• QuerySet.dates() メソッドと QuerySet.datetimes() メソッドのサポートを追加しました。

• データベース変換 を使用する埋め込みモデル フィールドの QuerySet 結果の読み込みを修正しました。

バージョン 5.1.0beta4

D Jango MongoDBバックエンド v5.1.0beta4 リリースには、次の機能、改善点、修正が含まれています。

• null の ArrayField 値を持つモデルと、base_field がデータベース変換を使用するモデルをロードするときに発生するクラッシュを修正します。

• サーバー側チャンクの下限を排除することで、QuerySet のパフォーマンスを向上させます。

バージョン 5.1.0beta3

D Jango MongoDBバックエンド v5.1.0beta3 リリースには、次の機能、改善点、修正が含まれています。

• フィールドのカスタム検索と変換のサポートを追加します EmbeddedModelField

• Truncデータベース関数の tzinfo パラメータを使用するクエリの結果を修正します

• QuerySet.dates() メソッドと QuerySet.datetimes() メソッドのサポートを追加しました

• データベース変換を使用する埋め込みモデル フィールドの QuerySet 結果の読み込みを修正しました

バージョン 5.1.0beta2

D Jango MongoDBバックエンド v5.1.0beta2 リリースには、次の機能、改善点、修正が含まれています。

• データベースキャッシュのサポートを追加しました。このサポートは後で v5.1.4 で削除されています。

• ドキュメントキーの順序がモデルのフィールドの順序と一致しない場合に、QuerySet.raw_aggregate()フィールドの初期化を修正します。

バージョン 5.1.0beta1

D Jango MongoDBバックエンド v5.1.0beta1 リリースには、次の機能、改善点、修正が含まれています。

• ネストされた埋め込みモデル フォームの保存 サポートを追加しました

• 永続的なデータベース接続を修正します

• 非同期操作のサポートを追加しました

• django_mongodb_backend.utils.parse_uri() メソッドに db_name パラメータを追加します

• django_mongodb_backend.routers.MongoRouter ルーターを追加します。これにより、Diango MongoDBバックエンド は埋め込みモデルのコレクションを作成せず、dumpdata コマンドに埋め込みモデルが含まれないようにします。

バージョン 5.1.0beta0

Dpango MongoDBバックエンド v5.1.0beta0 は最初のpublic previewリリースです。To learn more about the public preview features, see the 公式ブログ記事「Dmango MongoDBバックエンドがパブリック プレビューで利用可能になりました」を参照してください。