mssql-django támogatása és életciklusa

A mssql-django csomag a Microsoft Fabric SQL Server, Azure SQL Database, Azure SQL Managed Instance és SQL-adatbázisának hivatalos Microsoft által támogatott Django-adatbázis-háttérrendszere. Aktívan karbantartják a GitHubon, és a PyPI-n keresztül teszik közzé. Ez a lap a verziószámozást, a platformkompatibilitást és a támogatási szabályzatot ismerteti.

Verziótámogatás

Mindig a legújabb kiadással szerezzen új funkciókat, teljesítménybeli fejlesztéseket és biztonsági javításokat. Az új képességek csak az aktuális kiadáshoz lesznek hozzáadva.

Aktuális verzió

A 2.0-s verzió a jelenlegi általános elérhetőségi (GA) kiadás.

Important

A 2.0 verzió 1.15.0 vagy újabb verziót igényel mssql-python , még akkor is, ha egy adatbázis alias használ pyodbc. A csomag csak olyan platformokra telepíthető, amelyeknek kompatibilis mssql-python disztribúciójuk van. Más platformokon lévő projektek a 1.8.0 verzión maradnak.

Támogatási állapotdefiníciók

Használja az alábbi állapotértékeket a verziótáblában:

Status Meaning
Aktuális Új funkciókat, hibajavításokat és biztonsági javításokat kap.
Előző Korábbi verzió. Továbbra is elérhető marad, de nem kap frissítéseket.

Verzióelőzmények

Változat Megjelenési dátum Status Django-verziók Legfontosabb funkciók
2.0 2026. szeptember Aktuális 5.2 - 6.1 Választható mssql-python illesztőprogram, Python 3.10–3.14, zoneinfo helyettesíti a(z) pytz elemet, MARS- és inspectdb-javítások
1.8.0 2026. augusztus Előző 3.2 - 6.1 Django 6.1 támogatás, a quote_name lekérdezésfordító módosítása, az idegen kulcs introspekciója visszaadja az ON DELETE szabályt
1.7.4 2026. július Előző 3.2 - 6.0 GROUP BY Javítások az escape-elt %% literálok esetében valódi paraméterekkel, valamint a nyers lekérdezésekben lévő IntegerChoices paraméterek esetében
1.7.3 2026. június Előző 3.2 - 6.0 FA001 javítás a Authentication=ActiveDirectoryMsi kivételével minden módhoz, alosztályba sorolt DatabaseWrapperKeyError javítás (regresszió az 1.7.1-ből)
1.7.2 2026. május Előző 3.2 - 6.0 datetimeoffset időzóna javítása, Now() időzóna javítása, .explain() kompatibilitási javítás
1.7.1 2026. április Előző 3.2 - 6.0 SQL-adatbázis javítása a Fabricben, csökkenő index javítása az AlterFieldben
1.7 2026. március Előző 3.2 - 6.0 Django 6.0-támogatás, ODBC Driver 18 alapértelmezett, SQL Server 2025-támogatás
1.6 2025. augusztus Előző 3.2 - 5.2 Django 5.1 és 5.2 támogatás, továbbfejlesztett JSON-funkciók
1.5 2024. április Előző 3.2 - 5.0 supports_comments jelölő, AutoField javítások
1.4 2024. január Előző 3.2 - 5.0 Django 5.0-támogatás, db_comment támogatás
1.3 2023. május Előző 3.2 - 4.2 Django 4.2-támogatás, kis- és nagybetűk megkülönböztetése Replace
1.2 2022. december Előző 3.2 - 4.1 Django 4.1-támogatás, időzóna támogatása Azure SQL Managed Instance JSONField
1.1 2022. július Előző 3.2 - 4.0 Első kiadás a Django 3.2 és 4.0 támogatásával

Az 1.1-es verzió előtti verziók előzetes kiadásúak voltak, és nem szerepelnek a listán.

Important

A javítások és az új funkciók csak új kiadásokban érhetők el. A régebbi verziók továbbra is elérhetők maradnak a PyPI-ban, de nincsenek javítva. Hibajavítások vagy biztonsági javítások beszerzéséhez frissítsen a legújabb kiadásra.

A részletes kibocsátási megjegyzésekért tekintse meg az mssql-django újdonságai című témakört.

Django és Python verziókompatibilitás

Minden Django-kiadás támogatja az adott Python verziókat. mssql-django A 2.0 a következő kombinációkat teszteli:

Django verziója Python-verziók
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

A Django 3.2-től 5.1-ig, valamint a Python 3.8-tól 3.9-ig a támogatás végét érte, és nem tesztelték. Az ilyen verziók projektjei 1.8.0-n maradnak mssql-django .

Important

Mindig használjon támogatott Python verziót. A régebbi Python verziók nem kapnak biztonsági frissítéseket.

SQL Server és Azure SQL kompatibilitás

mssql-djangoA 2.0 minden támogatott Microsoft SQL verziót támogat. A backend számára ismeretlen újabb SQL Server-főverzió a backend által ismert legfrissebb képességkészlet használatával kapcsolódik, ahelyett, hogy a verzióérvényesítés meghiúsulna.

Termék vagy szolgáltatás Támogatási állapot
SQL Server Teljes mértékben támogatott
SQL Server az Azure Virtual Machines szolgáltatásban Teljes mértékben támogatott
Azure SQL Database Teljes mértékben támogatott
Azure SQL Managed Instance Teljes mértékben támogatott
SQL-adatbázis a Fabricben Teljes mértékben támogatott
Microsoft Fabric Warehouse Csak kapcsolatok. A(z) pyodbc útvonalon állítsa be a(z) MARS_Connection=no elemet itt: extra_params. A Django migrációk és más SQL Server funkciók nem támogatottak.
Azure Synapse Analytics Csak kapcsolatok. A Django migrációk és más SQL Server funkciók nem támogatottak.

Adatbázis-illesztőprogram-kompatibilitás

mssql-djangoA 2.0 a két Python adatbázis-illesztőprogram egyikén keresztül csatlakozik, amelyet adatbázis-álnevenként lehet kiválasztani. További információkért lásd: Az adatbázis-illesztőprogram kiválasztása az mssql-djangohoz.

Python illesztőprogram Támogatási állapot Connectivity
pyodbc Teljes mértékben támogatott (alapértelmezett) Microsoft ODBC Driver 17 vagy 18 for SQL Server, külön telepítve
mssql-python Teljesen támogatott (választhatsz a python_driver lehetőséggel) Beépített beépítés, külön telepítés nélkül

ODBC-illesztő kompatibilitása

A pyodbc ágon a háttérrendszer alapértelmezés szerint az ODBC Driver 18 for SQL Servert használja, és automatikusan visszaáll az ODBC Driver 17-re, ha a 18-as verzió nincs telepítve. Az adatbázis-konfigurációban a driver beállítással írja felül az alapértelmezett értéket. Egy explicit érték nem esik vissza.

ODBC-illesztő Támogatási állapot
Microsoft ODBC Driver 18 for SQL Server Teljes mértékben támogatott (alapértelmezett)
Microsoft ODBC Driver 17 for SQL Server Teljesen támogatott (tartalékként)
FreeTDS ODBC-illesztő Támogatott a(z) pyodbc útvonalon

Az mssql-python út figyelmen kívül hagyja az driver opciót.

A telepítési utasításokért tekintse meg az ODBC-illesztőprogram letöltése SQL Server.

Operációs rendszer kompatibilitása

mssql-django A 2.0 verzió megköveteli mssql-python, így a csomag csak akkor telepíthető le, ha kompatibilis mssql-python disztribúció létezik. Ez a követelmény akkor is érvényes, ha minden adatbázis alias használ pyodbc.

Operációs rendszer Architecture Támogatási állapot
Windows 11, Windows Server 2019, 2022 és 2025 x64 Támogatott
Windows 11, Windows Server 2022 és 2025 ARM64 Támogatott a Python 3.11 és újabb verziókban
macOS 15 és újabb verziók Intel, Apple szilícium Támogatott
Linux glibc 2.28 vagy újabb verziókkal, mint például Ubuntu 22.04 és 24.04, Debian 11 és 12, valamint Red Hat Enterprise Linux 8 és 9 x64, ARM64 Támogatott
Linux musl 1.2 vagy újabb verzióval, például Alpine Linux x64, ARM64 Támogatott
SUSE Linux Enterprise Server ARM64 Nem támogatott

A nem támogatott platformon lévő projektek az mssql-django 1.8.0-s verzión maradnak, amelyhez nem szükséges a mssql-python.

pyodbc Az úton külön telepítse a Microsoft ODBC Driver for SQL Server-t. A telepítési lépések operációs rendszerenként változnak. A platformspecifikus beállításért tekintse meg az mssql-django telepítése című témakört.

Funkciókompatibilitás

Az alábbi táblázatok a Django és SQL Server funkciókat és azok támogatási állapotát sorolják fel a mssql-django háttérrendszerben. A nem támogatott funkciókról további információt az mssql-django korlátai és nem támogatott funkciói című témakörben talál.

Django ORM funkciók

Feature mssql-django-támogatás
Migrations Yes
QuerySet API Yes
JSONField Yes
bulk_create / bulk_update Yes
Adatbázis-tranzakciók Yes
inspectdb és --schema Yes
DISTINCT ON No
__regex / __iregex keresések Részleges (CLR-összeállítás beállítását igényli; az Azure SQL Database-ben nem érhető el)
SmallAutoField Yes
select_for_update() Igen (NOWAIT és SKIP_LOCKED; of nem támogatott)
Ablakfunkciók Yes
GeneratedField (számított oszlopok) Igen (Django 5.0 és újabb verziók)
CompositePrimaryKey Részleges (Django 5.2 és újabb verziók; lásd a korlátozásokat)
db_comment Igen (Django 4.2 és újabb verziók)
Fedőindexek (include) Igen (Django 4.2 és újabb verziók)
NthValue No

SQL Server funkciók

Feature mssql-django-támogatás
Titkosított kapcsolatok (TLS) Yes
Always Encrypted (mindig titkosítva) Yes
Microsoft Entra-hitelesítés Yes
Több aktív eredményhalmaz (MARS) Igen, az pyodbc ösvényen. A háttérrendszer akkor engedélyezi a MARS-t, ha az alias Microsoft ODBC drivert használ Windows-on. Az mssql-python út soha nem engedélyezi a MARS-t, és elutasítja a MARS_Connection kulcsszót.
Tárolt eljárások Igen (cursor.execute segítségével)
SNAPSHOT Izoláció Igen (adatbázisszintű konfigurációt igényel)
Írásvédett útválasztás Yes

Függőségi követelmények

A mssql-django csomag automatikusan telepíti a következő függőségeket:

Függőség Alkalmazás célja Kötelező verzió
Django Webes keretrendszer >=5.2,<6.2
pyodbc Alapértelmezett ODBC adatbázis-illezőprogram Python számára >=3.0
mssql-python Python adatbázis-illesztőprogram. Feltétel nélkül telepítve, és csak akkor használom, ha egy alias engedélyezi. >=1.15.0
tzdata IANA időzóna adatbázis a szabványos könyvtári zoneinfo modulhoz, amelyet akkor használnak, ha az operációs rendszer nem biztosít ilyet Any

Az pyodbc úthoz a Microsoft ODBC Driver for SQL Server is szükséges a host rendszeren. A mssql-python elérési út nem rendelkezik külön ODBC-illesztőprogram-telepítéssel. További információ: Mssql-django telepítése.

Verziószámozási és kompatibilitástörő módosításokra vonatkozó szabályzat

  • Főbb verziók (2.0): Megváltoztathatja a támogatott Python, Django, SQL Server és platform mátrixot, valamint hozzáadhat vagy eltávolíthat függőségeket. A törésszerű változtatások csak egy nagyobb verzióban jelennek meg.
  • Alverziók (1.6, 1.7): Új Django-verziótámogatás, új funkciók és hibajavítások. A visszamenőleges kompatibilitás fenntartása.
  • Javítási verziók (1.7.1, 1.7.2, 1.7.3, 1.7.4): Csak hibajavításokat tartalmaznak.

A csapat a kompatibilitástörő változásokat a kiadási megjegyzésekben dokumentálja. A verzióspecifikus megjegyzéseket lásd itt: Újdonságok az mssql-django-ban.

Az aktuális állapot megőrzése

A mssql-django háttérrendszer új verziókat ad ki a Django-kiadások nyomon követéséhez. A Django frissítésekor ellenőrizze a frissítéseket.

Telepített verzió ellenőrzése

Ellenőrizze, hogy jelenleg melyik verzió van telepítve:

pip show mssql-django

Frissítés a legújabb verzióra

Frissítés a legújabb kiadásra:

pip install --upgrade mssql-django

Feliratkozás a frissítésekre

Támogatás igénybevétele

Microsoft GitHub és közösségi csatornákon keresztül támogatjamssql-django.

GitHub-problémák

Hibák jelentése és szolgáltatások kérése a GitHub:

Amikor problémát jelentesz, add fel a Django verziódat, a Python verziót, az SQL Server verziót, a Python adatbázis-illesztőprogramot és annak verzióját, valamint minimális reprodukciót a problémáról.

Contribute

Örömmel fogadjuk a közösségi hozzájárulásokat. A közreműködői licencszerződéssel (CLA) és a beküldési folyamattal kapcsolatos további információkért tekintse meg a közreműködői útmutatót.

Community

Kapcsolódó tartalom

  • Last updated on