mssql-django-Support und Lebenszyklus

Das mssql-django Paket ist das offizielle Microsoft unterstützte Django-Datenbank-Back-End für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance und SQL-Datenbank in Microsoft Fabric. Es wird aktiv auf GitHub gepflegt und über PyPI freigegeben. Auf dieser Seite werden Versionsverwaltung, Plattformkompatibilität und Supportrichtlinie behandelt.

Versionsunterstützung

Verwenden Sie immer die neueste Version, um neue Features, Leistungsverbesserungen und Sicherheitsupdates zu erhalten. Neue Funktionen werden nur zur aktuellen Version hinzugefügt.

Aktuelle Version

Version 1.7.3 ist die aktuelle allgemeine Verfügbarkeit (GA)-Version.

Definitionen des Supportstatus

Verwenden Sie diese Statuswerte in der Versionstabelle:

Status Bedeutung
Aktuell Empfängt neue Features, Fehlerbehebungen und Sicherheitsupdates.
Zurück Historische Version. Bleibt verfügbar, erhält aber keine Updates.

Versionsverlauf

Version Erscheinungsdatum Status Django-Versionen Wichtigste Funktionen
1.7.3 Juni 2026 Aktuell 3.2 - 6.0 FA001 Fix für Authentication= andere Modi als ActiveDirectoryMsi, Unterklassenkorrektur DatabaseWrapperKeyError (Regression von 1.7.1)
1.7.2 Mai 2026 Previous 3.2 - 6.0 Datetimeoffset-Zeitzonenkorrektur , Now() Zeitzonenkorrektur, .explain() Kompatibilitätskorrektur
1.7.1 April 2026 Previous 3.2 - 6.0 SQL-Datenbank in Fabric Fix, absteigender Index AlterField Fix
1.7 März 2026 Previous 3.2 - 6.0 Django 6.0-Unterstützung, ODBC-Treiber 18-Standard, SQL Server 2025-Unterstützung
1.6 August 2025 Previous 3.2 - 5.2 Django 5.1- und 5.2-Unterstützung, erweiterte JSON-Funktionalität
1.5 April 2024 Previous 3.2 - 5.0 supports_comments Markierung, AutoField Fehlerbehebungen
1.4 Januar 2024 Previous 3.2 - 5.0 Django-5.0-Unterstützung, db_comment-Unterstützung
1.3 Mai 2023 Previous 3.2 - 4.2 Django 4.2-Unterstützung, Groß-/Kleinschreibung beachten Replace
1.2 Dezember 2022 Previous 3.2 - 4.1 Django 4.1-Support, Zeitzonenunterstützung, JSONField auf Azure SQL Managed Instance
1.1 Juli 2022 Previous 3.2 - 4.0 Erste Version mit Django 3.2- und 4.0-Support

Versionen vor 1.1 waren Vorabversion und werden nicht aufgeführt.

Important

Fixes und neue Features werden nur in neuen Versionen ausgeliefert. Ältere Versionen bleiben auf PyPI verfügbar, werden jedoch nicht gepatcht. Um Fehlerkorrekturen oder Sicherheitsupdates zu erhalten, führen Sie ein Upgrade auf die neueste Version durch.

Detaillierte Versionshinweise finden Sie unter What's new in mssql-django.

Django und Python Versionskompatibilität

Jede Django-Version unterstützt bestimmte Python Versionen. Stellen Sie bei der Auswahl Ihrer Versionen sicher, dass Django, Python und mssql-django kompatibel sind:

Django-Version Python-Versionen
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

Verwenden Sie immer eine unterstützte Python Version. Ältere Python Versionen erhalten keine Sicherheitsupdates.

SQL Server Versionskompatibilität

Das mssql-django Back-End funktioniert mit allen unterstützten Versionen von SQL Server.

Azure SQL-Dienste

Dienst Status der Unterstützung
Azure SQL-Datenbank Vollständig unterstützt
Verwaltete Azure SQL-Instanz Vollständig unterstützt

Microsoft Fabric

Endpunkt Status der Unterstützung
SQL-Datenbank in Fabric Vollständig unterstützt

ODBC-Treiberkompatibilität

Für das mssql-django-Backend ist ein externer ODBC-Treiber erforderlich, im Gegensatz zum mssql-python-Treiber, der Direct Database Connectivity (DDBC) verwendet.

mssql-django Ab 1.7 wird das Back-End standardmäßig auf ODBC-Treiber 18 für SQL Server festgelegt und automatisch auf ODBC-Treiber 17 zurückgesetzt, wenn Version 18 nicht installiert ist. Sie können dies überschreiben, indem Sie die driver Option in Der Datenbankkonfiguration angeben.

ODBC-Treiber Status der Unterstützung
Microsoft ODBC-Treiber 18 für SQL Server Vollständig unterstützt (Standard)
Microsoft ODBC-Treiber 17 für SQL Server Vollständig unterstützt (Fallback)
FreeTDS ODBC-Treiber Unterstützt

Installationsanweisungen finden Sie unter "ODBC-Treiber herunterladen" für SQL Server.

Betriebssystemkompatibilität

Das mssql-django Backend läuft überall dort, wo Python und der ODBC-Treiber unterstützt werden. Die Installationsschritte des ODBC-Treibers variieren je nach Betriebssystem. Siehe Installieren von mssql-django für plattformspezifisches Setup.

Betriebssystem Aufbau Status der Unterstützung
Windows 11 x64, ARM64 Unterstützt
Windows Server 2019, 2022, 2025 x64 Unterstützt
Ubuntu 22.04, 24.04 x64, ARM64 Unterstützt
Debian 11, 12 x64, ARM64 Unterstützt
Red Hat Enterprise Linux 8, 9 x64, ARM64 Unterstützt
macOS 14, 15 Intel, Apple Silicon (ARM64) Unterstützt
Alpine Linux x64 Unterstützt (erfordert glibc-Kompatibilitätsschicht oder FreeTDS)

Kompatibilität von Funktionen

In den folgenden Tabellen sind Django und SQL Server Features und deren Supportstatus im mssql-django Back-End aufgeführt. Weitere Informationen zu nicht unterstützten Features finden Sie unter Einschränkungen und nicht unterstützte Features in mssql-django.

Funktionen des Django-ORM

Merkmal mssql-django-Unterstützung
Migrations Yes
QuerySet-API Yes
JSONField Ja (SQL Server 2016+)
bulk_create / bulk_update Yes
Datenbanktransaktionen Yes
inspectdb mit --schema Yes
DISTINCT ON No
__regex / __iregex Abfragen Teilweise (erfordert die Einrichtung einer CLR-Assembly; in Azure SQL-Datenbank nicht verfügbar)
SmallAutoField Yes
select_for_update() Ja (NOWAIT und SKIP_LOCKED; of nicht unterstützt)
Fensterfunktionen Yes
GeneratedField (berechnete Spalten) Ja (Django 5.0 und höher)
CompositePrimaryKey Teilweise (Django 5.2 und höher; siehe Einschränkungen)
db_comment Ja (Django 4.2 und höher)
Überdeckende Indizes (include) Ja (Django 4.2 und höher)
NthValue No

SQL Server Funktionen

Merkmal mssql-django-Unterstützung
Verschlüsselte Verbindungen (TLS) Yes
Immer Verschlüsselt Yes
Microsoft Entra-Authentifizierung Yes
MARS (Multiple Active Result Sets, mehrere aktive Resultsets) Ja (via pyodbc)
Gespeicherte Prozeduren Ja (via cursor.execute)
SNAPSHOT Isolation Ja (erfordert Konfiguration auf Datenbankebene)
Schreibgeschütztes Routing Yes

Anforderungen an Abhängigkeiten

Das mssql-django Paket installiert automatisch die folgenden Abhängigkeiten:

Abhängigkeit Purpose Erforderliche Version
Django Webframework >= 3,2
pyodbc ODBC-Datenbanktreiber für Python >= 3,0
pytz Zeitzonenunterstützung (veraltet; modernes Django verwendet die integrierte Funktion zoneinfo mit USE_TZ=True) Any

Das mssql-django Back-End erfordert außerdem den Microsoft ODBC-Treiber, damit SQL Server auf dem Hostsystem installiert werden. Weitere Informationen finden Sie unter Installieren von mssql-django.

Richtlinie für Versionsverwaltung und Unterbrechung von Änderungen

  • Nebenversionen (1.6, 1.7): Fügen Sie neue Django-Versionsunterstützung, neue Features und Fehlerbehebungen ein. Beibehalten der Abwärtskompatibilität.
  • Patchversionen (1.7.1, 1.7.2, 1.7.3): Schließen Sie nur Fehlerkorrekturen ein.

Das Team dokumentiert die Änderungen in den Versionshinweisen. Schauen Sie sich die Neuerungen in mssql-django für versionsspezifische Notizen an.

So bleiben Sie auf dem neuesten Stand

Das mssql-django Backend stellt neue Versionen bereit, um mit den Django-Releases Schritt zu halten. Überprüfen Sie beim Upgrade von Django auf Updates.

Überprüfen der installierten Version

Überprüfen Sie, welche Version derzeit installiert ist:

pip show mssql-django

Upgrade auf die neueste Version

Aktualisieren Sie auf die neueste Version:

pip install --upgrade mssql-django

Abonnieren von Updates

Unterstützung erhalten

Microsoft unterstützt mssql-django über GitHub und Community-Kanäle.

GitHub-Probleme

Melden von Fehlern und Anfordern von Features für GitHub:

Schließen Sie beim Melden eines Problems Ihre Django-Version, Python Version, SQL Server Version, ODBC-Treiberversion und eine minimale Wiedergabe des Problems ein.

Contribute

Gemeinschaftsbeiträge sind willkommen. Weitere Informationen zum Lizenzvertrag für Mitwirkende (Contributor License Agreement, CLA) und zum Einreichungsprozess finden Sie im Leitfaden für Mitwirkende.

Community

Verwandte Inhalte

  • Last updated on