mssql-django support och livscykel

Paketet mssql-django är den officiella Microsoft Django-databasserverdelen som stöds för SQL Server, Azure SQL Database, Azure SQL Managed Instance och SQL-databas i Microsoft Fabric. Den underhålls aktivt på GitHub och släpps via PyPI. Den här sidan beskriver versionshantering, plattformskompatibilitet och supportprincip.

Versionsstöd

Använd alltid den senaste versionen för att få nya funktioner, prestandaförbättringar och säkerhetskorrigeringar. Nya funktioner läggs bara till i den aktuella versionen.

Aktuell version

Version 2.0 är den nuvarande allmänna tillgänglighetsversionen (GA).

Important

Version 2.0 kräver mssql-python 1.15.0 eller senare, även när ett databasalias använder pyodbc. Paketet installeras endast på plattformar som har en kompatibel mssql-python distribution. Projekt på andra plattformar förblir på version 1.8.0.

Definitioner av supportstatus

Använd dessa statusvärden i versionstabellen:

Status Meaning
Nuvarande Tar emot nya funktioner, felkorrigeringar och säkerhetskorrigeringar.
Tidigare Tidigare utgåva. Förblir tillgängligt men får inte uppdateringar.

Versionshistorik

Version Frisläppningsdatum Status Django-versioner Viktiga funktioner
2.0 September 2026 Nuvarande 5.2 - 6.1 Opt-in-drivrutinmssql-python, Python 3.10 - 3.14, zoneinfo ersätter pytz, MARS och inspectdb fixar
1.8.0 Augusti 2026 Previous 3.2 - 6.1 stöd för Django 6.1, quote_name ändring i frågekompilatorn, introspektion av främmande nycklar returnerar ON DELETE-regeln
1.7.4 Juli 2026 Previous 3.2 - 6.0 GROUP BY Korrigeringar för %%-litteraler med escape-tecken med faktiska parametrar och för IntegerChoices-parametrar i råfrågor
1.7.3 Juni 2026 Previous 3.2 - 6.0 FA001 korrigering för Authentication= andra lägen än ActiveDirectoryMsi, underklassuell DatabaseWrapperKeyError korrigering (regression från 1.7.1)
1.7.2 Maj 2026 Previous 3.2 - 6.0 datetimeoffset tidszonskorrigering , Now() tidszonskorrigering, .explain() kompatibilitetskorrigering
1.7.1 April 2026 Previous 3.2 - 6.0 Korrigering för SQL-databas i Fabric, korrigering för AlterField för index i fallande ordning
1.7 Mars 2026 Previous 3.2 - 6.0 Stöd för Django 6.0, ODBC Driver 18 standard, SQL Server 2025-support
1.6 Augusti 2025 Previous 3.2 - 5.2 Stöd för Django 5.1 och 5.2, förbättrade JSON-funktioner
1.5 2024 april Previous 3.2 - 5.0 supports_comments flagga, AutoField korrigeringar
1,4 Januari 2024 Previous 3.2 - 5.0 Stöd för Django 5.0, db_comment stöd
1.3 maj 2023 Previous 3.2 - 4.2 Django 4.2-stöd, skiftlägeskänsligt Replace
1.2 2022 december Previous 3.2 - 4.1 Stöd för Django 4.1, tidszonsstöd, JSONField på Azure SQL Managed Instance
1.1 juli 2022 Previous 3.2 - 4.0 Första versionen med stöd för Django 3.2 och 4.0

Versioner före 1.1 var förhandsversioner och visas inte.

Important

Korrigeringar och nya funktioner levereras endast i nya versioner. Äldre versioner är fortfarande tillgängliga på PyPI men är inte korrigerade på plats. Om du vill få felkorrigeringar eller säkerhetskorrigeringar uppgraderar du till den senaste versionen.

För detaljerad versionsinformation, se Vad är nytt i mssql-django.

Django- och Python-versionskompatibilitet

Varje Django-version stöder specifika Python versioner. mssql-django 2.0 testar följande kombinationer:

Django-version Python-versioner
6.1 3.12, 3.13, 3.14
6.0 3.12, 3.13, 3.14
5.2 3.10, 3.11, 3.12, 3.13

Django 3.2 till 5.1 och Python 3.8 och 3.9 nådde slutet av stödet och är inte testade. Projekt på dessa versioner förblir på mssql-django 1.8.0.

Important

Använd alltid en Python version som stöds. Äldre Python versioner får inte säkerhetsuppdateringar.

SQL Server och Azure SQL-kompatibilitet

mssql-django2.0 stöder alla stödda versioner av Microsoft SQL. En nyare SQL Server-huvudversion som backend inte känner igen ansluter genom att använda den senaste kapabilitetsuppsättningen som backend känner till, istället för att misslyckas med versionsvalidering.

Produkt eller tjänst Status för support
SQL Server Stöds fullt ut
SQL Server på Azure-virtuella maskiner Stöds fullt ut
Azure SQL Database Stöds fullt ut
Hanterad instans i Azure SQL Stöds fullt ut
SQL-databasen i Fabric Stöds fullt ut
Microsoft Fabric Warehouse Endast anslutningar. I sökvägen pyodbc, ange MARS_Connection=no i extra_params. Django-migreringar och andra SQL Server-funktioner stöds inte.
Azure Synapse Analytics Endast anslutningar. Django-migreringar och andra SQL Server-funktioner stöds inte.

Databasdrivrutinskompatibilitet

mssql-django2.0 ansluter via någon av två Python-databasdrivrutiner, valda för varje databasalias. För mer information, se Välj databasdrivrutinen för mssql-django.

Python-drivrutin Status för support Connectivity
pyodbc Fullständigt stöd (standard) Microsoft ODBC Driver 17 eller 18 för SQL Server, installerad separat
mssql-python Stöds fullt ut (aktivera med alternativet python_driver) Inbyggt, utan separat installation

ODBC-drivrutinskompatibilitet

För sökvägen pyodbc använder serverdelen som standard ODBC Driver 18 for SQL Server och växlar automatiskt tillbaka till ODBC Driver 17 om version 18 inte är installerad. Åsidosätt standardinställningen med alternativet driver i din databaskonfiguration. Ett explicit värde faller inte bakåt.

ODBC-drivrutin Status för support
Microsoft ODBC Driver 18 för SQL Server Fullständigt stöd (standard)
Microsoft ODBC Driver 17 för SQL Server Stöds fullt ut (reservlösning)
FreeTDS ODBC-drivrutin Stöds på sökvägen pyodbc

Vägen mssql-python ignorerar alternativet driver .

Installationsinstruktioner finns i Ladda ned ODBC-drivrutin för SQL Server.

Kompatibilitet för operativsystem

mssql-django 2.0 kräver mssql-python, så paketet installeras endast där en kompatibel mssql-python distribution finns. Det kravet gäller även när varje databasalias använder pyodbc.

Operativsystem Architecture Status för support
Windows 11, Windows Server 2019, 2022 och 2025 x64 Understödd
Windows 11, Windows Server 2022 och 2025 ARM64 Stöds med Python 3.11 och senare versioner
macOS 15 och senare versioner Intel, Apple silicon Understödd
Linux med glibc 2.28 eller senare, såsom Ubuntu 22.04 och 24.04, Debian 11 och 12, samt Red Hat Enterprise Linux 8 och 9 x64, ARM64 Understödd
Linux med musl 1.2 eller senare, såsom Alpine Linux x64, ARM64 Understödd
SUSE Linux Enterprise Server ARM64 Stöds ej

Projekt på en plattform som inte stöds förblir på mssql-django 1.8.0, vilket inte kräver mssql-python.

På pyodbc-sökvägen installerar du Microsoft ODBC-drivrutinen för SQL Server separat. Installationsstegen varierar beroende på operativsystem. Se Installera mssql-django för plattformsspecifik installation.

Funktionskompatibilitet

Följande tabeller visar Django- och SQL Server-funktioner och deras supportstatus i mssql-django serverdelen. Mer information om funktioner som inte stöds finns i Begränsningar och funktioner som inte stöds i mssql-django.

Django ORM-funktioner

Feature stöd för mssql-django
Migrations Yes
QuerySet API (applikationsprogrammeringsgränssnitt) Yes
JSONField Yes
bulk_create / bulk_update Yes
Databastransaktioner Yes
inspectdb med --schema Yes
DISTINCT ON Nej
__regex / __iregex sökningar Partiell (kräver installation av CLR-sammansättning, inte tillgänglig på Azure SQL Database)
SmallAutoField Yes
select_for_update() Ja (NOWAIT och SKIP_LOCKED; of stöds inte)
Fönsterfunktioner Yes
GeneratedField (beräknade kolumner) Ja (Django 5.0 och senare)
CompositePrimaryKey Partiell (Django 5.2 och senare; se begränsningar)
db_comment Ja (Django 4.2 och senare)
Täckande index (include) Ja (Django 4.2 och senare)
NthValue Nej

SQL Server funktioner

Feature stöd för mssql-django
Krypterade anslutningar (TLS) Yes
Alltid Krypterad Yes
Microsoft Entra-autentisering Yes
Flera aktiva resultatuppsättningar (MARS) Ja, på vägen pyodbc . Backend aktiverar MARS när aliaset använder en Microsoft ODBC-drivrutin på Windows. Vägen mssql-python aktiverar aldrig MARS och förkastar MARS_Connection nyckelordet.
Lagrade procedurer Ja (via cursor.execute)
SNAPSHOT isolering Ja (kräver konfiguration på databasnivå)
Skrivskyddad routning Yes

Beroendekrav

Paketet mssql-django installerar automatiskt följande beroenden:

Beroende Purpose Nödvändig version
Django Webbramverk >=5.2,<6.2
pyodbc Standard ODBC-databasdrivrutin för Python >=3.0
mssql-python Python-databasdrivrutin. Installerat villkorslöst och används endast när ett alias är med. >=1.15.0
tzdata IANA-tidszonsdatabas för standardbiblioteksmodulen zoneinfo , använd där operativsystemet inte tillhandahåller en sådan Any

Sökvägen pyodbc kräver också Microsoft ODBC-drivrutin för SQL Server på värdsystemet. mssql-python-vägen kräver ingen separat installation av ODBC-drivrutinen. Mer information finns i Installera mssql-django.

Policy för versionering och brytande ändringar

  • Större versioner (2.0): Kan ändra den stödda matrisen för Python, Django, SQL Server och plattform, och kan lägga till eller ta bort beroenden. Brytande ändringar förekommer endast i en större version.
  • Delversioner (1.6, 1.7): Inkludera stöd för ny Django-version, nya funktioner och felkorrigeringar. Upprätthålla bakåtkompatibilitet.
  • Patchversioner (1.7.1, 1.7.2, 1.7.3, 1.7.4): Inkluderar endast buggfixar.

Teamet dokumenterar icke-bakåtkompatibla ändringar i versionsinformationen. Se Vad är nytt i mssql-django för versionsspecifika kommentarer.

Så här håller du dig uppdaterad

Serverdelen mssql-django släpper nya versioner för att spåra Django-versioner. Sök efter uppdateringar när du uppgraderar Django.

Kontrollera installerad version

Kontrollera vilken version som är installerad för närvarande:

pip show mssql-django

Uppgradera till den senaste versionen

Uppdatera till den senaste versionen:

pip install --upgrade mssql-django

Prenumerera på uppdateringar

Få support

Microsoft stöder mssql-django via GitHub och communitykanaler.

GitHub-problem

Rapportera buggar och begärandefunktioner på GitHub:

När du rapporterar ett problem, inkludera din Django-version, Python-version, SQL Server-version, Python-databasdrivrutinen och dess version, samt en minimal återgivning av problemet.

Contribute

Gemenskapens bidrag är välkomna. Mer information om licensavtalet för deltagare (CLA) och överföringsprocessen finns i bidragsguiden.

Grupp

Relaterat innehåll

  • Last updated on