Podpora a životní cyklus mssql-django

Balíček mssql-django je oficiální back-end databáze Django podporovaný Microsoft pro SQL Server, Azure SQL Database, Azure SQL Managed Instance a databázi SQL v Microsoft Fabric. Aktivně se udržuje na GitHub a vydává se prostřednictvím PyPI. Tato stránka se věnuje správě verzí, kompatibilitě platformy a zásadám podpory.

Podpora verzí

Vždy používejte nejnovější verzi k získání nových funkcí, vylepšení výkonu a oprav zabezpečení. Nové funkce se přidají jenom do aktuální verze.

Aktuální verze

Verze 2.0 je aktuální vydání v obecné dostupnosti (GA).

Important

Verze 2.0 vyžaduje mssql-python verzi 1.15.0 nebo novější, i když alias databáze používá pyodbc. Balíček se instaluje pouze na platformách, které mají kompatibilní mssql-python distribuci. Projekty na jiných platformách zůstávají na verzi 1.8.0.

Definice stavu podpory

V tabulce verzí použijte tyto stavové hodnoty:

Stav Meaning
Aktuální Přijímá nové funkce, opravy chyb a opravy zabezpečení.
Předchozí Archivní vydání. Zůstane k dispozici, ale neobdrží aktualizace.

Historie verzí

Verze Datum vydání Stav Verze Django Klíčové funkce
2.0 Září 2026 Aktuální 5.2 - 6.1 Volitelný mssql-python ovladač, Python 3.10–3.14, zoneinfo nahrazuje pytz, opravy pro MARS a inspectdb
1.8.0 Srpen 2026 Předchozí 3.2 - 6.1 Podpora Django 6.1, quote_name změna kompilátoru dotazů, introspekce cizích klíčů vrací pravidlo ON DELETE
1.7.4 Červenec 2026 Předchozí 3.2 - 6.0 GROUP BY Opravy pro %% únikové literály s reálnými parametry a pro IntegerChoices parametry v surových dotazech
1.7.3 Červen 2026 Předchozí 3.2 - 6.0 FA001 oprava pro režimy jiné než Authentication=, oprava pro odvozenou podtřídu ActiveDirectoryMsiDatabaseWrapper (regrese z verze 1.7.1)
1.7.2 Květen 2026 Předchozí 3.2 - 6.0 oprava časového pásma datetimeoffset, Now() oprava časového pásma, .explain() oprava kompatibility
1.7.1 Duben 2026 Předchozí 3.2 - 6.0 oprava databáze SQL ve Fabric, oprava sestupného indexu AlterField
1.7 Březen 2026 Předchozí 3.2 - 6.0 Podpora Django 6.0, výchozí ovladač ODBC 18, SQL Server 2025 podpora
1.6 Srpen 2025 Předchozí 3.2 - 5.2 Podpora Django 5.1 a 5.2, vylepšené funkce JSON
1.5 Duben 2024 Předchozí 3.2 - 5.0 supports_comments příznak, AutoField opravy
1.4 Leden 2024 Předchozí 3.2 - 5.0 Podpora Django 5.0, podpora db_comment
1.3 Květen 2023 Předchozí 3.2 - 4.2 Podpora Django 4.2, citlivé na velikost písmen Replace
1,2 prosinec 2022 Předchozí 3.2 - 4.1 Podpora Django 4.1, podpora časových pásem v JSONField Azure SQL Managed Instance
1.1 Červenec 2022 Předchozí 3.2 - 4.0 Počáteční verze s podporou Django 3.2 a 4.0

Verze starší než 1.1 byly předběžné verze a nejsou uvedené.

Important

Opravy a nové funkce se dodávají pouze v nových verzích. Starší verze zůstávají dostupné na PyPI, ale nejsou opravené. Pokud chcete získat opravy chyb nebo opravy zabezpečení, upgradujte na nejnovější verzi.

Podrobné poznámky k verzi najdete v tématu Co je nového v mssql-django.

Kompatibilita verzí Django a Python

Každá verze Django podporuje konkrétní verze Python. mssql-django 2.0 testuje následující kombinace:

Verze Django Verze Pythonu
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 až 5.1 a Python 3.8 a 3.9 dosáhly konce podpory a nejsou testovány. Projekty na těchto verzích zůstávají na mssql-django verzi 1.8.0.

Important

Vždy používejte podporovanou Python verzi. Starší Python verze nedostávají aktualizace zabezpečení.

Kompatibilita SQL Server a Azure SQL

mssql-djangoVerze 2.0 podporuje všechny podporované verze Microsoft SQL. Novější hlavní verze SQL Serveru, kterou back-end nerozpozná, se připojí pomocí nejnovější sady funkcí, kterou back-end zná, namísto toho, aby selhalo ověření verze.

Produkt nebo služba Stav podpory
SQL Server Plně podporovaná
SQL Server na virtuálních počítačích Azure Plně podporovaná
Azure SQL Database Plně podporovaná
Azure SQL Managed Instance Plně podporovaná
SQL databáze v prostředí Fabric Plně podporovaná
Microsoft Fabric Warehouse Pouze připojení. V cestě pyodbc nastavte MARS_Connection=no v extra_params. Migrace Django a další funkce SQL Server nejsou podporovány.
Azure Synapse Analytics Pouze připojení. Migrace Django a další funkce SQL Server nejsou podporovány.

Kompatibilita ovladačů databáze

mssql-django2.0 se připojuje přes jeden ze dvou Python ovladačů databáze, vybraných pro každý alias databáze. Pro více informací viz Vybrat ovladač databáze pro mssql-django.

Python ovladač Stav podpory Connectivity
pyodbc Plně podporovaná (výchozí) Microsoft ODBC ovladač 17 nebo 18 pro SQL Server, nainstalovaný samostatně
mssql-python Plně podporováno (po zapnutí možnosti python_driver) Vestavěné, bez samostatné instalace

Kompatibilita ovladačů ODBC

Na cestě pyodbc backend výchozí nastavení používá ODBC Driver 18 pro SQL Server a automaticky se vrací k ODBC Driver 17, pokud verze 18 není nainstalována. Přepište výchozí nastavení pomocí volby driver v konfiguraci databáze. Explicitní hodnota se nevrátí zpět.

ovladač ODBC Stav podpory
Ovladač Microsoft ODBC 18 pro SQL Server Plně podporovaná (výchozí)
Ovladač Microsoft ODBC 17 pro SQL Server Plně podporováno (záložní možnost)
Ovladač FreeTDS ODBC Podporováno v cestě pyodbc

Cesta mssql-python tuto driver možnost ignoruje.

Pokyny k instalaci naleznete v tématu Stažení ovladače ODBC pro SQL Server.

Kompatibilita operačního systému

mssql-django Verze 2.0 vyžaduje mssql-python, takže balíček se instaluje pouze tam, kde existuje kompatibilní mssql-python distribuce. Tento požadavek platí i tehdy, když každý alias databáze používá pyodbc.

Operační systém Architecture Stav podpory
Windows 11, Windows Server 2019, 2022 a 2025 x64 Podporováno
Windows 11, Windows Server 2022 a 2025 ARM64 Podporováno s Python 3.11 a novějšími verzemi
macOS 15 a novější verze Intel, Apple Silicon Podporováno
Linux s glibc 2.28 nebo novějšími, například Ubuntu 22.04 a 24.04, Debian 11 a 12 a Red Hat Enterprise Linux 8 a 9 x64, ARM64 Podporováno
Linux s musl 1.2 nebo novší, například Alpine Linux x64, ARM64 Podporováno
SUSE Linux Enterprise Server ARM64 Nepodporováno

Projekty na nepodporované platformě zůstávají na mssql-django verzi 1.8.0, která nevyžaduje mssql-python.

Na cestě pyodbc nainstalujte Microsoft ODBC ovladač pro SQL Server zvlášť. Kroky instalace se liší podle operačního systému. Viz Instalace mssql-django pro nastavení specifické pro platformu.

Kompatibilita funkcí

Následující tabulky uvádějí funkce frameworku Django a serveru SQL Server a jejich stav podpory v backendu mssql-django. Další podrobnosti o nepodporovaných funkcích najdete v tématu Omezení a nepodporované funkce v mssql-django.

Funkce Django ORM

Vlastnost Podpora mssql-django
Migrations Yes
QuerySet API Yes
JSONField Yes
bulk_create / bulk_update Yes
Databázové transakce Yes
inspectdb s --schema Yes
DISTINCT ON No
__regex / __iregex vyhledávání Částečná (vyžaduje nastavení sestavení CLR; není k dispozici v Azure SQL Database)
SmallAutoField Yes
select_for_update() Ano (NOWAIT a SKIP_LOCKED; of nepodporováno)
Funkce okna Yes
GeneratedField (vypočítané sloupce) Ano (Django 5.0 a novější)
CompositePrimaryKey Částečná (Django 5.2 a novější; viz omezení)
db_comment Ano (Django 4.2 a novější)
Pokrytí indexů (include) Ano (Django 4.2 a novější)
NthValue No

funkce SQL Server

Vlastnost Podpora mssql-django
Šifrovaná připojení (TLS) Yes
Trvale šifrováno Yes
Ověřovací systém Microsoft Entra Yes
Několik aktivních sad výsledků (MARS) Ano, na trase pyodbc. Backend umožňuje MARS, když alias používá ovladač Microsoft ODBC na Windows. Cesta mssql-python nikdy neumožňuje MARS a odmítá klíčové slovo MARS_Connection .
Uložené procedury Ano (prostřednictvím cursor.execute)
SNAPSHOT izolace Ano (vyžaduje konfiguraci na úrovni databáze)
Směrování pouze pro čtení Yes

Požadavky na závislost

Balíček mssql-django automaticky nainstaluje následující závislosti:

Závislost Purpose Požadovaná verze
Django Webová architektura >=5.2,<6.2
pyodbc Výchozí ovladač databáze ODBC pro Python >=3.0
mssql-python Python ovladač databáze. Instalováno bezpodmínečně a používáno pouze tehdy, když se přihlásí alias. >=1.15.0
tzdata IANA databáze časových pásem pro standardní knihovní zoneinfo modul, používaná tam, kde operační systém žádnou neposkytuje Any

Cesta pyodbc také vyžaduje Microsoft ODBC ovladač pro SQL Server na hostitelském systému. Cesta mssql-python nemá samostatnou instalaci ovladačů ODBC. Další informace naleznete v tématu Instalace mssql-django.

Zásady pro správu verzí a zásadní změny

  • Hlavní verze (2.0): Lze měnit podporovanou matici Python, Django, SQL Server a platformy a přidávat nebo odebírat závislosti. Zásadní změny se objevují pouze ve velké verzi.
  • Podverze (1.6, 1.7): Zahrnují podporu nových verzí Django, nové funkce a opravy chyb. Udržujte zpětnou kompatibilitu.
  • Verze patchů (1.7.1, 1.7.2, 1.7.3, 1.7.4): Obsahují pouze opravy chyb.

Tým dokumentuje zásadní změny v poznámkách k verzi. Viz What's new in mssql-django, kde najdete poznámky ke konkrétním verzím.

Jak zůstat aktuální

Backend mssql-django vydává nové verze, aby držel krok s novými verzemi Django. Při upgradu Django zkontrolujte aktualizace.

Kontrola nainstalované verze

Ověřte, která verze je aktuálně nainstalovaná:

pip show mssql-django

Upgrade na nejnovější verzi

Aktualizujte na nejnovější verzi:

pip install --upgrade mssql-django

Přihlášení k odběru aktualizací

Získání podpory

Microsoft podporuje mssql-django prostřednictvím kanálů GitHub a komunity.

Problémy s GitHubem

Hlášení chyb a žádostí o funkce v GitHub:

Když hlásíte problém, zahrňte verzi Django, Python, SQL Server, ovladač databáze Python a jeho verzi a minimální reprodukci problému.

Contribute

Příspěvky komunity jsou vítány. Další informace o licenční smlouvě přispěvatele (CLA) a procesu odeslání najdete v průvodci přispívání.

Community

Související obsah

  • Poslední aktualizace v