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 1.7.3 je aktuální finální vydání (GA).

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
1.7.3 Červen 2026 Aktuální 3.2 - 6.0 FA001 oprava pro režimy jiné než ActiveDirectoryMsi, oprava pro odvozenou podtřídu DatabaseWrapperKeyError (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. Při výběru verzí zajistěte kompatibilitu mezi Django, Python amssql-django:

Verze Django Verze Pythonu
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

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

Kompatibilita verzí SQL Server

Back-end mssql-django funguje se všemi podporovanými verzemi SQL Server.

Služby Azure SQL

Service Stav podpory
Azure SQL Database Plně podporovaná
Azure SQL Managed Instance Plně podporovaná

Microsoft Fabric

Koncový bod Stav podpory
SQL databáze v prostředí Fabric Plně podporovaná

Kompatibilita ovladačů ODBC

Back-end mssql-django vyžaduje externí ovladač ODBC, na rozdíl od mssql-python ovladače, který používá rozhraní DDBC (Direct Database Connectivity).

Od verze mssql-django 1.7 se back-end pro SQL Server jako výchozí nastaví na ovladač ODBC 18 a automaticky se vrátí k ovladači ODBC 17, pokud není nainstalovaná verze 18. Můžete to přepsat zadáním driver možnosti v konfiguraci databáze.

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

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

Kompatibilita operačního systému

Backend mssql-django běží všude tam, kde jsou podporovány Python a ovladač ODBC. Postup instalace ovladače ODBC se liší podle operačního systému. Viz Instalace mssql-django pro nastavení specifické pro platformu.

Operační systém Architecture Stav podpory
Windows 11 x64, ARM64 Podporováno
Windows Server 2019, 2022, 2025 x64 Podporováno
Ubuntu 22.04, 24.04 x64, ARM64 Podporováno
Debian 11, 12 x64, ARM64 Podporováno
Red Hat Enterprise Linux 8, 9 x64, ARM64 Podporováno
macOS 14, 15 Intel, Apple Silicon (ARM64) Podporováno
Alpine Linux x64 Podporováno (vyžaduje vrstvu kompatibility pro glibc nebo FreeTDS)

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 Ano (SQL Server 2016+)
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 (prostřednictvím pyodbc)
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 >= 3,2
pyodbc Ovladač databáze ODBC pro Python >= 3,0
pytz Podpora časového pásma (starší verze, moderní Django používá integrované zoneinfo s USE_TZ=True) Any

Back-end mssql-django také vyžaduje, aby byl v hostitelském systému nainstalován ovladač Microsoft ODBC pro SQL Server. Další informace naleznete v tématu Instalace mssql-django.

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

  • Podverze (1.6, 1.7): Zahrnují podporu nových verzí Django, nové funkce a opravy chyb. Udržujte zpětnou kompatibilitu.
  • Verze oprav (1.7.1, 1.7.2, 1.7.3): Zahrnout 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:

Při hlášení problému uveďte verzi Django, Python verzi, SQL Server verzi, verzi ovladače ODBC 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

  • Last updated on