Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Het mssql-django pakket is de officiële Microsoft-ondersteunde Django-databaseback-end voor SQL Server, Azure SQL Database, Azure SQL Managed Instance en SQL-database in Microsoft Fabric. Het wordt actief onderhouden op GitHub en vrijgegeven via PyPI. Op deze pagina vindt u informatie over versiebeheer, platformcompatibiliteit en ondersteuningsbeleid.
Versieondersteuning
Gebruik altijd de nieuwste versie om nieuwe functies, prestatieverbeteringen en beveiligingsoplossingen te krijgen. Nieuwe mogelijkheden worden alleen toegevoegd aan de huidige release.
Huidige versie
Versie 2.0 is de huidige algemeen beschikbare versie (GA).
Important
Versie 2.0 vereist mssql-python 1.15.0 of hoger, zelfs wanneer een database-alias pyodbc gebruikt. Het pakket wordt alleen geïnstalleerd op platforms met een compatibele mssql-python distributie. Projecten op andere platforms blijven op versie 1.8.0.
Statusdefinities ondersteunen
Gebruik deze statuswaarden in de versietabel:
| Status | Meaning |
|---|---|
| Huidig | Ontvangt nieuwe functies, bugfixes en beveiligingsoplossingen. |
| Vorige | Historische versie. Blijft beschikbaar, maar ontvangt geen updates. |
Versiegeschiedenis
| Versie | Releasedatum | Status | Django-versies | Belangrijkste kenmerken |
|---|---|---|---|---|
| 2.0 | September 2026 | Huidig | 5.2 - 6.1 | Optionele mssql-python driver, Python 3.10 - 3.14, zoneinfo vervangt pytz, MARS en inspectdb-oplossingen |
| 1.8.0 | Augustus 2026 | Previous | 3.2 - 6.1 | Django 6.1-ondersteuning, quote_name wijziging van querycompiler, introspectie van vreemde sleutels geeft de ON-regel DELETE terug |
| 1.7.4 | Juli 2026 | Previous | 3.2 - 6.0 |
GROUP BY Oplossingen voor ontsnapte %% literals met echte parameters en voor IntegerChoices params in raw queries |
| 1.7.3 | Juni 2026 | Previous | 3.2 - 6.0 |
FA001 oplossing voor Authentication= modi anders dan ActiveDirectoryMsi, oplossing voor subklasse DatabaseWrapperKeyError (regressie sinds 1.7.1) |
| 1.7.2 | Mei 2026 | Previous | 3.2 - 6.0 |
datetimeoffset-tijdzonefix, Now() tijdzonefix, .explain() compatibiliteitsfix |
| 1.7.1 | April 2026 | Previous | 3.2 - 6.0 | Oplossing voor SQL-database in Fabric, oplossing voor dalende index en AlterField |
| 1.7 | Maart 2026 | Previous | 3.2 - 6.0 | Ondersteuning voor Django 6.0, ODBC-stuurprogramma 18, SQL Server 2025-ondersteuning |
| 1.6 | augustus 2025 | Previous | 3.2 - 5.2 | Ondersteuning voor Django 5.1 en 5.2, verbeterde JSON-functionaliteit |
| 1.5 | 2024 april | Previous | 3.2 - 5.0 |
supports_comments vlag, AutoField fixes |
| 1.4 | Januari 2024 | Previous | 3.2 - 5.0 | Django 5.0-ondersteuning, db_comment ondersteuning |
| 1.3 | Mei 2023 | Previous | 3.2 - 4.2 | Django 4.2-ondersteuning, hoofdlettergevoelig Replace |
| 1,2 | 2022 december | Previous | 3.2 - 4.1 | Django 4.1-ondersteuning, tijdzoneondersteuning, JSONField op Azure SQL Managed Instance |
| 1,1 | Juli 2022 | Previous | 3.2 - 4.0 | Eerste release met Ondersteuning voor Django 3.2 en 4.0 |
Versies vóór 1.1 werden vooraf uitgebracht en worden niet vermeld.
Important
Fixes en nieuwe functies worden alleen verzonden in nieuwe releases. Oudere versies blijven beschikbaar op PyPI, maar worden niet achteraf gepatcht. Als u oplossingen voor fouten of beveiligingsoplossingen wilt ophalen, voert u een upgrade uit naar de nieuwste versie.
Zie Wat is er nieuw in mssql-django voor gedetailleerde releaseopmerkingen.
Compatibiliteit met Django- en Python-versies
Elke Django-release ondersteunt specifieke Python versies.
mssql-django 2.0 test de volgende combinaties:
| Django-versie | Python-versies |
|---|---|
| 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 tot en met 5.1 en Python 3.8 en 3.9 zijn aan het einde van de ondersteuning gekomen en zijn niet getest. Projecten met die versies blijven op mssql-django 1.8.0.
Important
Gebruik altijd een ondersteunde Python-versie. Oudere Python versies ontvangen geen beveiligingsupdates.
SQL Server en Azure SQL-compatibiliteit
mssql-django2.0 ondersteunt elke ondersteunde versie van Microsoft SQL. Een nieuwere SQL Server-hoofdversie die de backend niet herkent, maakt verbinding met behulp van de nieuwste mogelijkhedenset die de backend kent, in plaats van dat de versievalidatie mislukt.
| Product of dienst | Ondersteuningsstatus |
|---|---|
| SQL Server | Volledig ondersteund |
| SQL Server op virtuele machines in Azure | Volledig ondersteund |
| Azure SQL Database | Volledig ondersteund |
| Azure SQL Managed Instance (een beheerde database-instantie van Azure) | Volledig ondersteund |
| Een SQL-database in Fabric | Volledig ondersteund |
| Microsoft Fabric Warehouse | Alleen verbindingen. Stel MARS_Connection=no in in extra_params op het pad pyodbc. Django-migraties en andere SQL Server-functies worden niet ondersteund. |
| Azure Synapse Analytics | Alleen verbindingen. Django-migraties en andere SQL Server-functies worden niet ondersteund. |
Compatibiliteit van databasedrivers
mssql-django 2.0 maakt verbinding via een van de twee Python-databasedrivers die per databasealias worden geselecteerd. Voor meer informatie, zie Selecteer de databasedriver voor mssql-django.
| Python-stuurprogramma | Ondersteuningsstatus | Connectivity |
|---|---|---|
pyodbc |
Volledig ondersteund (standaard) | Microsoft ODBC Driver 17 of 18 voor SQL Server, apart geïnstalleerd |
mssql-python |
Volledig ondersteund (opt-in met de python_driver optie) |
Ingebouwd, zonder aparte installatie |
Compatibiliteit van ODBC-stuurprogramma's
Op het pyodbc pad staat de backend standaard op ODBC Driver 18 voor SQL Server en valt automatisch terug op ODBC Driver 17 als versie 18 niet is geïnstalleerd. Overschrijf de standaard met de driver optie in je databaseconfiguratie. Een expliciete waarde valt niet terug.
| ODBC-stuurprogramma | Ondersteuningsstatus |
|---|---|
| Microsoft ODBC-stuurprogramma 18 voor SQL Server | Volledig ondersteund (standaard) |
| Microsoft ODBC-stuurprogramma 17 voor SQL Server | Volledig ondersteund (fallback) |
| ODBC-stuurprogramma FreeTDS | Ondersteund op het pyodbc pad |
Het mssql-python pad negeert de driver optie.
Zie ODBC-stuurprogramma downloaden voor SQL Server voor installatie-instructies.
Compatibiliteit van besturingssysteem
mssql-django 2.0 vereist mssql-python, dus het pakket wordt alleen geïnstalleerd waar een compatibele mssql-python distributie bestaat. Die vereiste geldt zelfs wanneer elke database-alias gebruikmaakt van pyodbc.
| besturingssysteem | Architecture | Ondersteuningsstatus |
|---|---|---|
| Windows 11, Windows Server 2019, 2022 en 2025 | x64 | Supported |
| Windows 11, Windows Server 2022 en 2025 | ARM64 | Ondersteund met Python 3.11 en latere versies |
| macOS 15 en latere versies | Intel, Apple silicon | Supported |
| Linux met glibc 2.28 of later, zoals Ubuntu 22.04 en 24.04, Debian 11 en 12, en Red Hat Enterprise Linux 8 en 9 | x64, ARM64 | Supported |
| Linux met musl 1.2 of later, zoals Alpine Linux | x64, ARM64 | Supported |
| SUSE Linux Enterprise Server | ARM64 | Niet ondersteund |
Projecten op een niet-ondersteund platform blijven op mssql-django 1.8.0, wat geen vereiste mssql-pythonvereist.
Installeer op het pad pyodbc de Microsoft ODBC Driver voor SQL Server afzonderlijk. De installatiestappen verschillen per besturingssysteem. Zie Mssql-django installeren voor platformspecifieke installatie.
Functiecompatibiliteit
De volgende tabellen bevatten Django- en SQL Server-functies en hun ondersteuningsstatus in de mssql-django back-end. Zie Beperkingen en niet-ondersteunde functies in mssql-django voor meer informatie over niet-ondersteunde functies.
Functies van Django ORM
| Eigenschap | mssql-django-ondersteuning |
|---|---|
| Migrations | Yes |
QuerySet API |
Yes |
JSONField |
Yes |
bulk_create / bulk_update |
Yes |
| Databasetransacties | Yes |
inspectdb met --schema |
Yes |
DISTINCT ON |
Nee. |
__regex
/
__iregex zoekopdrachten |
Gedeeltelijk (vereist installatie van CLR-assembly; niet beschikbaar op Azure SQL Database) |
SmallAutoField |
Yes |
select_for_update() |
Ja (NOWAIT en SKIP_LOCKED; of niet ondersteund) |
| Vensterfuncties | Yes |
GeneratedField (berekende kolommen) |
Ja (Django 5.0 en hoger) |
CompositePrimaryKey |
Gedeeltelijk (Django 5.2 en hoger; zie beperkingen) |
db_comment |
Ja (Django 4.2 en hoger) |
Dekkende indexen (include) |
Ja (Django 4.2 en hoger) |
NthValue |
Nee. |
SQL Server functies
| Eigenschap | mssql-django-ondersteuning |
|---|---|
| Versleutelde verbindingen (TLS) | Yes |
| Altijd versleuteld | Yes |
| Microsoft Entra-authenticatie | Yes |
| Meerdere actieve resultatensets (MARS) | Ja, op het pyodbc pad. De backend schakelt MARS in wanneer de alias een Microsoft ODBC-driver gebruikt op Windows. Het mssql-python pad maakt MARS nooit mogelijk en wijst het MARS_Connection trefwoord af. |
| opgeslagen procedures | Ja (via cursor.execute) |
SNAPSHOT isolatie |
Ja (vereist configuratie op databaseniveau) |
| Alleen-lezenroutering | Yes |
Afhankelijkheidsvereisten
Het mssql-django pakket installeert automatisch de volgende afhankelijkheden:
| Afhankelijkheid | Purpose | Vereiste versie |
|---|---|---|
| Django | Webraamwerk | >=5.2,<6.2 |
pyodbc |
Standaard ODBC-databasedriver voor Python | >=3.0 |
mssql-python |
Python-databasestuurprogramma. Onvoorwaardelijk geïnstalleerd en alleen gebruikt wanneer een alias zich aanmeldt. | >=1.15.0 |
tzdata |
IANA tijdzonedatabase voor de standaard bibliotheekmodule zoneinfo , gebruikt waar het besturingssysteem er geen levert |
Any |
Het pyodbc pad vereist ook de Microsoft ODBC-driver voor SQL Server op het hostsysteem. Het mssql-python pad heeft geen aparte ODBC-driverinstallatie. Zie Mssql-django installeren voor meer informatie.
Beleid voor versiebeheer en wijzigingen die fouten veroorzaken
- Belangrijke versies (2.0): Kan de ondersteunde Python, Django, SQL Server en platformmatrix wijzigen, en kan afhankelijkheden toevoegen of verwijderen. Ingrijpende wijzigingen komen alleen voor in een hoofdversie.
- Secundaire versies (1.6, 1.7): Neem ondersteuning voor nieuwe Django-versies, nieuwe functies en oplossingen voor fouten op. Compatibiliteit met eerdere versies behouden.
- Patchversies (1.7.1, 1.7.2, 1.7.3, 1.7.4): Alleen bugfixes bevatten.
Het team documenteert belangrijke wijzigingen in releaseopmerkingen. Bekijk wat er nieuw is in mssql-django voor versiespecifieke notities.
Hoe blijf ik op de hoogte
De mssql-django back-end brengt nieuwe versies uit om Django-releases bij te houden. Controleer op updates bij het upgraden van Django.
Geïnstalleerde versie controleren
Controleer welke versie momenteel is geïnstalleerd:
pip show mssql-django
Upgraden naar de nieuwste versie
Bijwerken naar de nieuwste versie:
pip install --upgrade mssql-django
Abonneren op updates
- Bekijk de GitHub opslagplaats voor releasemeldingen.
- Controleer PyPI op nieuwe releases.
- Bekijk het wijzigingenlogboek voor elke release.
Ondersteuning krijgen
Microsoft ondersteunt mssql-django via GitHub en communitykanalen.
GitHub-problemen
Fouten en aanvraagfuncties melden op GitHub:
Als je een probleem meldt, voeg dan je Django-versie, Python-versie, SQL Server-versie, de Python-databasedriver en de bijbehorende versie toe, en een minimale reproductie van het probleem.
Contribute
Bijdragen van de Gemeenschap zijn welkom. Zie de gids voor bijdragen voor meer informatie over de Cla (Licentieovereenkomst) voor inzenders en het inzendingsproces.
Community
- Stack Overflow: Tag vragen met
djangoensql-server. - Django-documentatie
- Azure Python Ontwikkelaarscentrum