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 jelenlegi általános elérhetőségi (GA) verzió az 1.7.4.

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
1.7.4 2026. július Aktuális 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. A verziók kiválasztásakor győződjön meg arról, hogy a Django, a Python és a mssql-django kompatibilisek-e egymással:

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

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

SQL Server verziókompatibilitás

A mssql-django háttérrendszer a SQL Server összes támogatott verziójával működik.

Azure SQL-szolgáltatások

Service Támogatási állapot
Azure SQL Database Teljes mértékben támogatott
Azure SQL Managed Instance Teljes mértékben támogatott

Microsoft Fabric

Endpoint Támogatási állapot
SQL-adatbázis a Fabricben Teljes mértékben támogatott

ODBC-illesztő kompatibilitása

A mssql-django háttérrendszerhez külső ODBC-illesztő szükséges, ellentétben a mssql-python közvetlen adatbázis-kapcsolatot (DDBC) használó illesztőprogramtal.

mssql-django Az 1.7-es verziótól a háttérrendszer alapértelmezés szerint az ODBC Driver 18 SQL Server esetében, és automatikusan visszakerül az ODBC Driver 17-es verziójára, ha a 18-as verzió nincs telepítve. Ezt felülbírálhatja az driver adatbázis konfigurációjában megadott beállítás megadásával.

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 telepítési utasításokért tekintse meg az ODBC-illesztőprogram letöltése SQL Server.

Operációs rendszer kompatibilitása

A mssql-django háttérrendszer minden olyan környezetben fut, ahol a Python és az ODBC-illesztőprogram támogatott. Az ODBC-illesztőprogram telepítési lépései az operációs rendszertől függően változnak. A platformspecifikus beállításért tekintse meg az mssql-django telepítése című témakört.

Operációs rendszer Architecture Támogatási állapot
Windows 11 x64, ARM64 Támogatott
Windows Server 2019, 2022, 2025 x64 Támogatott
Ubuntu 22.04, 24.04 x64, ARM64 Támogatott
Debian 11, 12 x64, ARM64 Támogatott
Red Hat Enterprise Linux 8, 9 x64, ARM64 Támogatott
macOS 14, 15 Intel, Apple Silicon (ARM64) Támogatott
Alpine Linux x64 Támogatott (glibc kompatibilitási réteget vagy FreeTDS-t igényel)

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 Igen (SQL Server 2016+)
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 (pyodbc segítségével)
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 >= 3,2
pyodbc ODBC adatbázis-illesztőprogram Pythonhoz >= 3,0
pytz Időzóna-támogatás (a backend az datetime konvertálásához használja, USE_TZ-től függetlenül) Any

A mssql-django háttérrendszer használatához a Microsoft ODBC-illesztőprogramot is telepíteni kell a gazdarendszerre az SQL Serverhez. További információ: Mssql-django telepítése.

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

  • 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:

A probléma bejelentésekor tartalmazza a Django-verziót, Python verziót, SQL Server verziót, az ODBC-illesztőprogram verzióját és a probléma minimális reprodukálását.

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