mssql-django パッケージは、Microsoft FabricのSQL Server、Azure SQL Database、Azure SQL Managed Instance、および SQL データベース用の公式のMicrosoftサポートされている Django データベース バックエンドです。 これは、GitHubで積極的に維持され、PyPI を通じてリリースされます。 このページでは、バージョン管理、プラットフォームの互換性、およびサポート ポリシーについて説明します。
バージョンのサポート
常に最新のリリースを使用して、新機能、パフォーマンスの向上、およびセキュリティ修正を取得します。 新機能は、現在のリリースにのみ追加されます。
現在のバージョン
バージョン 1.7.3 は、現在の一般公開 (GA) リリースです。
サポート状態の定義
バージョン テーブルで次の状態値を使用します。
| 地位 | Meaning |
|---|---|
| 現在 | 新機能、バグ修正、およびセキュリティ修正プログラムを受け取ります。 |
| 前へ | リリース履歴。 引き続き利用可能ですが、更新プログラムは受け取りません。 |
バージョン履歴
| バージョン | リリース日 | 地位 | Django のバージョン | 主要な機能 |
|---|---|---|---|---|
| 1.7.3 | 2026 年 6 月 | 現在 | 3.2 - 6.0 |
FA001
Authentication=以外のActiveDirectoryMsiモードの修正、サブクラス化されたDatabaseWrapperKeyError修正 (1.7.1 からの回帰) |
| 1.7.2 | 2026 年 5 月 | 前へ | 3.2 - 6.0 |
datetimeoffset タイム ゾーンの修正、 Now() タイム ゾーンの修正、 .explain() 互換性の修正 |
| 1.7.1 | 2026 年 4 月 | 前へ | 3.2 - 6.0 | Fabric の SQL データベースの修正、降順インデックスの AlterField の修正 |
| 1.7 | 2026 年 3 月 | 前へ | 3.2 - 6.0 | Django 6.0 のサポート、ODBC Driver 18 の既定値、SQL Server 2025 のサポート |
| 1.6 | 2025 年 8 月 | 前へ | 3.2 - 5.2 | Django 5.1 および 5.2 のサポート、強化された JSON 機能 |
| 1.5 | 2024 年 4 月 | 前へ | 3.2 - 5.0 |
supports_comments フラグ、 AutoField 修正 |
| 1.4 | 2024 年 1 月 | 前へ | 3.2 - 5.0 | Django 5.0 対応、db_comment 対応 |
| 1.3 | 2023 年 5 月 | 前へ | 3.2 - 4.2 | Django 4.2 のサポート、大文字と小文字を区別 Replace |
| 1.2 | 2022 年 12 月 | 前へ | 3.2 - 4.1 | Django 4.1 のサポート、タイム ゾーンのサポート、Azure SQL Managed InstanceでのJSONField |
| 1.1 | 2022年7月 | 前へ | 3.2 - 4.0 | Django 3.2 および 4.0 サポートを使用した最初のリリース |
1.1 より前のバージョンはプレリリースであり、一覧に記載されていません。
Important
修正プログラムと新機能は、新しいリリースでのみ提供されます。 以前のバージョンは PyPI で引き続き使用できますが、パッチは適用されません。 バグ修正またはセキュリティ修正プログラムを取得するには、最新リリースにアップグレードします。
詳細なリリース ノートについては、「 mssql-django の新機能」を参照してください。
Django と Python バージョンの互換性
各 Django リリースでは、特定のPython バージョンがサポートされます。 バージョンを選択するときは、Django、Python、およびmssql-django間の互換性を確保します。
| Django バージョン | Python のバージョン |
|---|---|
| 6.0 | 3.12, 3.13, 3.14 |
| 5.2 | 3.10, 3.11, 3.12, 3.13 |
| 5.1 | 3.10, 3.11, 3.12, 3.13 |
| 5.0 | 3.10, 3.11, 3.12 |
| 4.2 | 3.8, 3.9, 3.10, 3.11, 3.12 |
| 4.1 | 3.8, 3.9, 3.10, 3.11 |
| 4.0 | 3.8, 3.9, 3.10 |
| 3.2 | 3.8, 3.9, 3.10 |
Important
サポートされているPythonバージョンを常に使用してください。 古いPythonバージョンでは、セキュリティ更新プログラムは受け取りません。
SQL Serverバージョンの互換性
mssql-django バックエンドは、サポートされているすべてのバージョンのSQL Serverで動作します。
Azure SQL サービス
| サービス | サポートの状態 |
|---|---|
| Azure SQL Database | 完全にサポートされています |
| Azure SQL Managed Instance | 完全にサポートされています |
Microsoft Fabric
| エンドポイント | サポートの状態 |
|---|---|
| Fabric の SQL データベース | 完全にサポートされています |
ODBC ドライバーの互換性
mssql-django バックエンドには、Direct Database Connectivity (DDBC) を使用するmssql-python ドライバーとは異なり、外部 ODBC ドライバーが必要です。
mssql-django 1.7 の時点で、バックエンドは既定で odbc Driver 18 for SQL Serverになり、バージョン 18 がインストールされていない場合は自動的に ODBC Driver 17 にフォールバックします。 これをオーバーライドするには、データベース構成で driver オプションを指定します。
| ODBC ドライバ | サポートの状態 |
|---|---|
| Microsoft ODBC Driver 18 for SQL Server | 完全にサポート (既定) |
| Microsoft ODBC Driver 17 for SQL Server | 完全対応（フォールバック） |
| FreeTDS ODBC ドライバー | サポートされています |
インストール手順については、「ODBC Driver for SQL Server のダウンロード」を参照してください。
オペレーティング システムの互換性
mssql-django バックエンドはPythonどこでも実行され、ODBC ドライバーがサポートされます。 ODBC ドライバーのインストール手順は、オペレーティング システムによって異なります。 プラットフォーム固有のセットアップについては、「 mssql-django のインストール 」を参照してください。
| オペレーティング システム | Architecture | サポートの状態 |
|---|---|---|
| ウィンドウズ11 | x64、ARM64 | サポートされています |
| Windows Server 2019、2022、2025 | x64 | サポートされています |
| Ubuntu 22.04、24.04 | x64、ARM64 | サポートされています |
| Debian 11,12 | x64、ARM64 | サポートされています |
| Red Hat Enterprise Linux 8、9 | x64、ARM64 | サポートされています |
| macOS 14、15 | Intel、Apple Silicon (ARM64) | サポートされています |
| Alpine Linux | x64 | サポートされています (glibc 互換性レイヤーまたは FreeTDS が必要) |
機能の互換性
次の表に、mssql-django バックエンドの Django およびSQL Server機能とそのサポート状態を示します。 サポートされていない機能の詳細については、「 mssql-django の制限事項とサポートされていない機能」を参照してください。
Django ORM の機能
| 特徴 | mssql-django のサポート |
|---|---|
| Migrations | Yes |
QuerySet API (アプリケーション・プログラミング・インターフェース) |
Yes |
JSONField |
はい (SQL Server 2016 以降) |
bulk_create / bulk_update |
Yes |
| データベース トランザクション | Yes |
inspectdb と --schema |
Yes |
DISTINCT ON |
No |
__regex
/
__iregex ルックアップ |
部分 (CLR アセンブリのセットアップが必要です。Azure SQL Databaseでは使用できません) |
SmallAutoField |
Yes |
select_for_update() |
はい (NOWAIT とSKIP_LOCKED; of サポートされていません) |
| ウィンドウ関数 | Yes |
GeneratedField (計算列) |
はい (Django 5.0 以降) |
CompositePrimaryKey |
部分 (Django 5.2 以降。制限事項を参照) |
db_comment |
はい (Django 4.2 以降) |
カバリングインデックス (include) |
はい (Django 4.2 以降) |
NthValue |
No |
SQL Server 機能
| 特徴 | mssql-django のサポート |
|---|---|
| 暗号化された接続 (TLS) | Yes |
| 常に暗号化されています | Yes |
| Microsoft Entra 認証 | Yes |
| 複数のアクティブな結果セット (MARS) | はい ( pyodbc 経由) |
| ストアド プロシージャ | はい ( cursor.execute 経由) |
SNAPSHOT 隔離 |
はい (データベース レベルの構成が必要) |
| 読み取り専用ルーティング | Yes |
依存関係の要件
mssql-django パッケージは、次の依存関係を自動的にインストールします。
| 依存関係 | Purpose | 必要なバージョン |
|---|---|---|
| Django | Web フレームワーク | >= 3.2 |
pyodbc |
Python用 ODBC データベース ドライバー | >= 3.0 |
pytz |
タイムゾーンのサポート（レガシー。最新の Django では、USE_TZ=True を備えた組み込みの zoneinfo を使用） |
Any |
mssql-django バックエンドでは、Microsoft ODBC Driver for SQL Serverをホスト システムにインストールする必要もあります。 詳細については、「 mssql-django のインストール」を参照してください。
バージョン管理と破壊的変更に関するポリシー
- マイナー バージョン (1.6、1.7): 新しい Django バージョンのサポート、新機能、バグ修正が含まれています。 下位互換性を維持します。
- パッチ バージョン (1.7.1、1.7.2、1.7.3): バグ修正のみを含めます。
チームは、リリース ノートの破壊的変更を文書化します。 バージョン固有のメモについては、 mssql-django の新機能 を参照してください。
最新の状態を維持する方法
mssql-django バックエンドは、Django リリースを追跡するために新しいバージョンをリリースします。 Django をアップグレードするときに更新プログラムを確認します。
インストールされているバージョンを確認する
現在インストールされているバージョンを確認します。
pip show mssql-django
最新バージョンへのアップグレード
最新リリースに更新します。
pip install --upgrade mssql-django
更新情報を登録する
- リリース通知については、GitHub リポジトリをご覧ください。
- PyPI で新しいリリースを確認します。
- 各リリースの 変更ログ を確認します。
サポートを受ける
Microsoftでは、GitHubやコミュニティ チャネルを通じたmssql-djangoがサポートされます。
GitHub の問題
GitHubでバグを報告し、機能を要求します。
問題を報告するときは、Django のバージョン、Pythonバージョン、SQL Server バージョン、ODBC ドライバーのバージョン、問題の最小限の再現を含めます。
Contribute
コミュニティへの投稿は大歓迎です。 共同作成者使用許諾契約書 (CLA) と提出プロセスの詳細については、 投稿ガイドを参照してください。
Community
- スタック オーバーフロー:
djangoとsql-serverで質問にタグを付けます。 - Django のドキュメント
- Azure Python デベロッパー センター