Django 4.2 リリースノート¶

2023年4月3日

Django 4.2 へようこそ！

このリリースノートでは、バージョン 4.2 の新機能と、Django 4.1 以前からアップグレードする際に注意すべき、後方互換性のない変更について説明します。また、一部の機能を非推奨としました。

既存のプロジェクトをアップデートするときは、 Django の新しいバージョンへの更新ガイドに従ってください。

Django 4.2 は、長期サポートリリースとして指定されています。リリースから最低3年間はセキュリティアップデートを受けます。以前の LTS および Django 3.2 に対するサポートは2024年4月に終了します。

Python バージョン間の互換性¶

Django 4.2 は、Python 3.8、3.9、3.10、3.11、および 3.12 (4.2.8 時点) をサポートしています。各シリーズの最新リリースのみが 強く推奨され 、公式にサポートされています。

Django 4.2 の新機能¶

Psycopg 3 のサポート¶

Django は psycopg バージョン 3.1.8 以降をサポートするようになりました。コードを更新するには、 psycopg ライブラリをインストールしてください。 django.db.backends.postgresql は両方のライブラリをサポートしているので、 ENGINE を変更する必要はありません。

psycopg2 のサポートは、将来のある時点で非推奨となり削除される可能性があります。

psycopg 3 は psycopg2 と比較して、いくつかの変更点があることに注意してください。結果として、psycopg2 との違いを考慮した変更が必要になるかもしれません。

カラムとテーブルにおけるコメント¶

新しい Field.db_comment と Meta.db_table_comment オプションは、それぞれカラムとテーブルにコメントを作成できるようにします。例えば:

from django.db import models


class Question(models.Model):
    text = models.TextField(db_comment="Poll question")
    pub_date = models.DateTimeField(
        db_comment="Date and time when the question was published",
    )

    class Meta:
        db_table_comment = "Poll questions"


class Answer(models.Model):
    question = models.ForeignKey(
        Question,
        on_delete=models.CASCADE,
        db_comment="Reference to a question",
    )
    answer = models.TextField(db_comment="Question answer")

    class Meta:
        db_table_comment = "Question answers"

また、新しい AlterModelTableComment オペレーションにより、 Meta.db_table_comment で定義されたテーブルコメントを変更できるようになりました。

BREACH 攻撃に対する緩和策¶

GZipMiddleware に BREACH 攻撃の緩和機能が追加されました。BREACH 攻撃をより困難にするために、gzip レスポンスに最大 100 バイトのランダムバイトを追加します。この緩和手法については Heal The Breach (HTB) paper を参照してください。

インメモリファイルストレージ¶

新しい django.core.files.storage.InMemoryStorage クラスは、ディスクアクセスを回避してテストを高速化するのに便利な非永続的なストレージを提供します。

カスタムファイルストレージ¶

新しい STORAGES 設定では、複数のカスタムファイルストレージバックエンドを設定できます。また、ファイル ("default" キー) と静的ファイル ("staticfiles" キー) を管理するためのストレージエンジンを制御します。

古い DEFAULT_FILE_STORAGE と STATICFILES_STORAGE の設定はこのリリースで非推奨になりました。

マイナーな機能¶

`django.contrib.admin`¶

admin 画面のカラーテーマのライト／ダークは、システム設定に従うだけでなく、UIでも切り替えられるようになりました。
管理者のフォントスタックがシステムUIフォントを優先するようになり、フォントのダウンロードが不要になりました。さらに、CSS変数が利用可能になり、デフォルトのフォントファミリーをより簡単に上書きできるようになりました。
admin/delete_confirmation.html テンプレートに、カスタマイズを容易にするためのブロックとスクリプトフックが追加されました。
filter_horizontal と filter_vertical ウィジェットの選択オプションがフィルタ可能になりました。
admin/base.html テンプレートに新しいブロック nav-breadcrumbs が追加され、ナビゲーションランドマークと breadcrumbs ブロックが含まれるようになりました。
ModelAdmin.list_editable が編集時にアトミックトランザクションを使用するようになりました。
jQuery のバージョンが 3.6.0 から 3.6.4 にアップグレードされました。

`django.contrib.auth`¶

PBKDF2パスワードハッシャーのデフォルトの繰り返し回数が390,000から600,000に増加しました。
UserCreationForm がカスタムユーザーモデルの多対多のフォームフィールドを保存するようになりました。
新しい BaseUserCreationForm がユーザ作成フォームをカスタマイズするための推奨基本クラスになりました。

`django.contrib.gis`¶

GeoJSON シリアライザは、シリアライズされたフィーチャの id キーを出力するようになりました。
GDALRaster クラスが pathlib.Path をサポートするようになりました。
GeoIP2 クラスが DB-IP からダウンロードした .mmdb ファイルをサポートするようになりました。
OpenLayers テンプレートウィジェットにはインライン CSS が含まれなくなりました（以前の map_css ブロックも削除されました）。これは、厳格なコンテンツセキュリティポリシーに準拠するためです。
OpenLayersWidget は、以前の OpenLayers 4.6.5 から OpenLayers 7.2.2 に基づくようになりました。
新しい isempty ルックアップと IsEmpty() 式により、PostGIS上で空のジオメトリをフィルタリングできるようになりました。
新しい FromWKB() および FromWKT() 関数により、Well-known binary（WKB）および Well-known text（WKT）表現からジオメトリを作成できるようになりました。

`django.contrib.postgres`¶

新しい trigram_strict_word_similar ルックアップと、TrigramStrictWordSimilarity() および TrigramStrictWordDistance() 式により、trigram (トリグラム) の厳密な単語類似性を使用できるようになりました。
arrayfield.overlap ルックアップは、右辺として QuerySet.values() および values_list() をサポートするようになりました。

`django.contrib.sitemaps`¶

新しい Sitemap.get_languages_for_item() メソッドにより、アイテムが表示される言語のリストをカスタマイズできるようになりました。

`django.contrib.staticfiles`¶

ManifestStaticFilesStorage は、import および export 文内のJavaScriptモジュールへのパスを、それらがハッシュ化されたものに置き換える実験的なサポートを提供するようになりました。これを試したい場合は、ManifestStaticFilesStorage をサブクラス化し、support_js_module_import_aggregation 属性を True に設定してください。
新しい ManifestStaticFilesStorage.manifest_hash 属性は、マニフェスト内のすべてのファイルに対するハッシュを提供し、ファイルのいずれかが変更されるたびに変更されます。

データベースバックエンド¶

新しい "assume_role" オプションが PostgreSQL の OPTIONS でサポートされるようになり、セッションロールを指定できるようになりました。
新しい "server_side_binding" オプションが PostgreSQL の OPTIONS で psycopg 3.1.8+ と共にサポートされるようになり、サーバーサイドバインディングカーソルが使用できるようになりました。

エラー報告¶

デバッグページでは、Python 3.11以降で 例外のノート と 詳細なエラー位置 を表示するようになりました。
セッションクッキーは認証情報として扱われ、エラーレポートでは非表示になり、アスタリスク (**********) で置き換えられるようになりました。

フォーム¶

ModelForm は、フォームフィールドをカスタマイズするための新しい Meta オプション formfield_callback を受け入れるようになりました。
modelform_factory() は、form の Meta の formfield_callback 属性を尊重するようになりました。

国際化 (internationalization)¶

中央クルド語（ソラニー）のサポートと翻訳を追加しました。

ロギング¶

django.db.backends ロガーは、トランザクション管理クエリ（BEGIN、COMMIT、および ROLLBACK）を DEBUG レベルでログに記録するようになりました。

管理コマンド¶

makemessages コマンドは、nl_NL-x-informal のようなプライベートサブタグを含むロケールをサポートするようになりました。
新しい makemigrations --update オプションは、モデルの変更を最新のマイグレーションにマージし、結果として得られる操作を最適化します。

マイグレーション¶

マイグレーションは、enum.Flag オブジェクトのシリアライズをサポートするようになりました。

モデル¶

QuerySet は、集計を実行する際のウィンドウ関数に対する非結合フィルタールックアップを除き、ウィンドウ関数に対するフィルタリングを広範囲にサポートするようになりました。
prefetch_related() は、スライスされたクエリセットを持つ Prefetch オブジェクトをサポートするようになりました。
Field インスタンスに対するルックアップの登録がサポートされるようになりました。
新しい robust 引数を on_commit() に指定することで、データベーストランザクションが成功した後に失敗する可能性のあるアクションを実行できるようになりました。
新しい KT() 式 は、JSONField のキー、インデックス、またはパス・トランスフォームのテキスト値を表します。
Now は、MySQL上でマイクロ秒の精度、SQLite上でミリ秒の精度をサポートするようになりました。
BooleanField を出力する F() 式 は、~F() (反転演算子) を使用して否定できるようになりました。
Model は、データベースを使用するいくつかのメソッドの非同期バージョンを a プレフィックスを使用して提供するようになりました: adelete()、arefresh_from_db()、および asave()。
関係マネージャは、リレーション先オブジェクトのセットを変更するメソッドの非同期バージョンを a プレフィックスを使用して提供するようになりました： aadd()、aclear()、aremove()、および aset()。
PostgreSQLでは無制限の VARCHAR カラムをサポートしているため、CharField.max_length を設定する必要がなくなりました。

Request と Response¶

DjangoがASGI経由で提供される場合、StreamingHttpResponse は非同期イテレータをサポートするようになりました。

テスト¶

test --debug-sql オプションは、SQLクエリを sqlparse でフォーマットするようになりました。
RequestFactory、AsyncRequestFactory、Client、および AsyncClient クラスは、ヘッダー名と値の辞書を受け入れる headers パラメータをサポートするようになりました。これにより、ヘッダーを宣言するためのより自然な構文が可能になります。
```
# Before:
self.client.get("/home/", HTTP_ACCEPT_LANGUAGE="fr")
await self.async_client.get("/home/", ACCEPT_LANGUAGE="fr")

# After:
self.client.get("/home/", headers={"accept-language": "fr"})
await self.async_client.get("/home/", headers={"accept-language": "fr"})
```

ユーティリティ¶

django.utils.html.json_script() 関数の新しい encoder パラメータにより、JSONエンコーダークラスをカスタマイズできるようになりました。
プライベートで内部的に提供される urllib.parse.urlsplit() のコピーは、現在 '\r', '\n', および '\t' を削除するようになりました (CVE 2022-0391 および bpo-43882 を参照)。これは、URLリダイレクトを処理するためのドキュメント化された関数のいずれかを使用する代わりに、内部の url_has_allowed_host_and_scheme() 関数を誤って使用している可能性があるプロジェクトを保護するためです。Djangoの関数は影響を受けませんでした。
新しい django.utils.http.content_disposition_header() 関数は、RFC 6266 に指定されているように Content-Disposition HTTPヘッダー値を返します。

バリデータ¶

CommonPasswordValidator によって使用されるよくあるパスワードのリストが、最新バージョンに更新されました。

4.2 における後方互換性のない変更¶

データベースバックエンド API¶

このセクションでは、サードパーティのデータベースバックエンドで必要になる可能性のある変更について説明します。

DatabaseFeatures.allows_group_by_pk は削除されました。これは、MySQL 5.7.15で適切な機能依存性の検出によって置き換えられたMySQLの拡張機能に対応するために残されていたものです。DatabaseFeatures.allows_group_by_selected_pks はまだサポートされており、バックエンドが SQL:1999 標準で指定されているように、GROUP BY 句での機能依存性の検出をサポートしている場合は有効にするべきです。
inspectdb は、CharField に対して internal_size の代わりに DatabaseIntrospection.get_table_description() からの display_size を使用するようになりました。

MariaDB 10.3 のサポートを終了しました¶

MariaDB 10.3のアップストリームサポートは2023年5月に終了します。Django 4.2はMariaDB 10.4以降をサポートしています。

MySQL 5.7 のサポートを終了しました¶

MySQL 5.7 のアップストリームサポートは 2023年10月に終了します。 Django 4.2 は MySQL 8 以降をサポートします。

PostgreSQL 11 のサポートを終了しました¶

PostgreSQL 11 のアップストリームサポートは 2023 年 11 月に終了します。Django 4.2 は PostgreSQL 12 以降をサポートします。

`Model.save()` で `update_fields` の設定が必要になる場合があります¶

不要なカラムを更新するのを避けるために、 QuerySet.update_or_create() は現在、 update_fields を Model.save() の呼び出しに渡します。その結果、カスタム save() メソッドで変更されたフィールドは、 super() を呼び出す前に update_fields キーワード引数に追加されるべきです。詳細については定義済みのモデルメソッドをオーバーライドするを参照してください。

MySQL での生の集計処理のサポートを廃止¶

MySQL 8 以降では、GROUP BY 列に対する機能依存を許可しているため、メインテーブルのプライマリキーによるグルーピングというDjango 4.2 以前の回避策は削除されました。結果として、GROUP BY 句でそのような集計が必要であるか、または有効であるかを判断する方法がないため、MySQL での RawSQL() 集計の使用はもはやサポートされていません。代わりに集計（Aggregation）関数を使用してください。

その他¶

ドキュメント化されていない django.http.multipartparser.parse_header() 関数は削除されました。代わりに django.utils.http.parse_header_parameters() を使用してください。
{% blocktranslate asvar … %} の結果は、(HTML) 出力用途で安全とマークされるようになりました。
admin の検索ボックスで autofocus HTML 属性が削除されました。これはスクリーンリーダーにとって混乱を招く可能性があるためです。
makemigrations --check オプションは欠損したマイグレーションファイルを作成しなくなりました。
Expression.get_group_by_cols() の alias 引数が削除されました。
sqlparse の最小サポートバージョンが 0.2.2 から 0.3.1 に引き上げられました。
Exists 式のドキュメント化されていなかった negated パラメータが削除されました。
ドキュメント化されていない Query.add_annotation() メソッドの is_summary 引数が削除されました。
SQLite のサポート最小バージョンが 3.9.0 から 3.21.0 に引き上げられました。
asgiref のサポートされている最低バージョンが 3.5.2 から 3.6.0 に引き上げられました。
UserCreationForm は、大文字と小文字の違いしかないユーザーネームを拒否するようになりました。以前の動作が必要な場合は、代わりに BaseUserCreationForm を使用してください。
mysqlclient の最小サポートバージョンが 1.4.0 から 1.4.3 に引き上げられました。
argon2-cffi の最小サポートバージョンが 19.1.0 から 19.2.0 に引き上げられました。
Pillow の最小サポートバージョンが 6.2.0 から 6.2.1 に引き上げられました。
jinja2 の最小サポートバージョンが 2.9.2 から 2.11.0 に引き上げられました。
redis-py の最低サポートバージョンが 3.0.0 から 3.4.0 に引き上げられました。
手動でインスタンス化された WSGIRequest オブジェクトには、wsgi.input のためのファイルライクオブジェクトを提供する必要があります。以前、DjangoはWSGI仕様で想定される挙動よりも寛容でした。
PROJ < 5 のサポートが削除されました。
EmailBackend は hostname と certificates を検証するようになりました。より制限の少ない、非推奨の以前の動作が必要な場合は、 EmailBackend をサブクラスにして ssl_context プロパティをオーバーライドしてください。

4.2 で非推奨となった機能¶

`index_together` オプションは `indexes` を優先するため非推奨になりました。¶

The Meta.index_together option is deprecated in favor of the indexes option.

既存の index_together のマイグレーションはマイグレーションとして扱うべきです。例えば:

class Author(models.Model):
    rank = models.IntegerField()
    name = models.CharField(max_length=30)

    class Meta:
        index_together = [["rank", "name"]]

これは以下のようにすべきです:

class Author(models.Model):
    rank = models.IntegerField()
    name = models.CharField(max_length=30)

    class Meta:
        indexes = [models.Index(fields=["rank", "name"])]

makemigrations コマンドを実行すると、既存のインデックスをリネームする RenameIndex 操作が含まれるマイグレーションが生成されます。次に、履歴マイグレーションから index_together を削除するために、マイグレーションをスカッシュすることを検討してください。

AlterIndexTogether マイグレーションオペレーションは、現在公式には Django 4.2 より前のマイグレーションファイルのためにのみサポートされています。後方互換性の理由から、まだ公開 API の一部であり、非推奨化または削除する計画はありませんが、新しいマイグレーションでの使用は避けるべきです。代わりに AddIndex と RemoveIndex オペレーションを使用してください。

`JSONField` に、エンコードされた JSON 文字列リテラルを渡すことは非推奨になりました¶

JSONField とそれに関連するルックアップや集計は JSON エンコード済みの文字列リテラルを渡すことを許可していましたが、これは文字列リテラルがデータベースバックエンドの観点から既にエンコードされているかどうかについての曖昧さを引き起こしていました。

非推奨期間中、文字列リテラルは JSON デコードされようと試みられ、成功した場合には非エンコード形式を渡すよう指摘する警告が発せられます。

JSONエンコードされた文字列リテラルを渡すために使われていたコード:

Document.objects.bulk_create(
    Document(data=Value("null")),
    Document(data=Value("[]")),
    Document(data=Value('"foo-bar"')),
)
Document.objects.annotate(
    JSONBAgg("field", default=Value("[]")),
)

これは以下のようにすべきです:

Document.objects.bulk_create(
    Document(data=Value(None, JSONField())),
    Document(data=[]),
    Document(data="foo-bar"),
)
Document.objects.annotate(
    JSONBAgg("field", default=[]),
)

Django 5.1 以降、文字列リテラルは JSON 文字列リテラルとして暗黙的に解釈されるようになります。

その他¶

BaseUserManager.make_random_password() メソッドは非推奨です。パスワードを生成するために Python の secrets モジュールを使用する際のレシピとベストプラクティスについては、レシピとベストプラクティスを参照してください。
length_is テンプレートフィルターは、length と == 演算子を {% if %} タグ内で使用する形式に置き換えられました。例えば
```
{% if value|length == 4 %}…{% endif %}
{% if value|length == 4 %}True{% else %}False{% endif %}
```
これは以下の表記に代わるものです:
```
{% if value|length_is:4 %}…{% endif %}
{{ value|length_is:4 }}
```
django.contrib.auth.hashers.SHA1PasswordHasher, django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher, そして django.contrib.auth.hashers.UnsaltedMD5PasswordHasher は非推奨になりました。
django.contrib.postgres.fields.CICharField は、大文字小文字を区別しない非決定的照合順序 (collation) を使用した CharField(db_collation="…") に置き換えられ、非推奨となりました。
django.contrib.postgres.fields.CIEmailField は、大文字小文字を区別しない非決定的照合順序 (collation) を使用した EmailField(db_collation="…") に置き換えられ、非推奨となりました。
django.contrib.postgres.fields.CITextField は、大文字小文字を区別しない非決定的照合順序 (collation) を使用した TextField(db_collation="…") に置き換えられ、非推奨になりました。
django.contrib.postgres.fields.CIText ミックスインは非推奨になりました。
BaseGeometryWidget の map_height 属性と map_width 属性は非推奨となりました。代わりに CSS を使用してマップウィジェットのサイズを設定してください。
SimpleTestCase.assertFormsetError() は assertFormSetError() を用いるため非推奨となりました。
TransactionTestCase.assertQuerysetEqual() は非推奨となり、assertQuerySetEqual() が推奨されます。
Signer および TimestampSigner へ位置引数を渡すことは、キーワード専用引数を使用する形式への変更が推奨となり、非推奨となりました。
DEFAULT_FILE_STORAGE 設定は STORAGES["default"] に置き換えられ、非推奨になりました。
STATICFILES_STORAGE 設定は非推奨となり、代わりに STORAGES["staticfiles"] が推奨されます。
django.core.files.storage.get_storage_class() 関数は非推奨となりました。

Django 4.2 リリースノート¶

Python バージョン間の互換性¶

Django 4.2 の新機能¶

Psycopg 3 のサポート¶

カラムとテーブルにおけるコメント¶

BREACH 攻撃に対する緩和策¶

インメモリファイルストレージ¶

カスタムファイルストレージ¶

マイナーな機能¶

django.contrib.admin¶

django.contrib.auth¶

django.contrib.gis¶

django.contrib.postgres¶

django.contrib.sitemaps¶

django.contrib.staticfiles¶

データベースバックエンド¶

エラー報告¶

フォーム¶

国際化 (internationalization)¶

ロギング¶

管理コマンド¶

マイグレーション¶

モデル¶

Request と Response¶

テスト¶

ユーティリティ¶

バリデータ¶

4.2 における後方互換性のない変更¶

データベースバックエンド API¶

MariaDB 10.3 のサポートを終了しました¶

MySQL 5.7 のサポートを終了しました¶

PostgreSQL 11 のサポートを終了しました¶

Model.save() で update_fields の設定が必要になる場合があります¶

MySQL での生の集計処理のサポートを廃止¶

その他¶

4.2 で非推奨となった機能¶

index_together オプションは indexes を優先するため非推奨になりました。¶

JSONField に、エンコードされた JSON 文字列リテラルを渡すことは非推奨になりました¶

その他¶

Additional Information

Support Django!

Contents

Getting help

Download:

`django.contrib.admin`¶

`django.contrib.auth`¶

`django.contrib.gis`¶

`django.contrib.postgres`¶

`django.contrib.sitemaps`¶

`django.contrib.staticfiles`¶

`Model.save()` で `update_fields` の設定が必要になる場合があります¶

`index_together` オプションは `indexes` を優先するため非推奨になりました。¶

`JSONField` に、エンコードされた JSON 文字列リテラルを渡すことは非推奨になりました¶