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 1.7.3 is de huidige algemene beschikbaarheidsrelease (GA).
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 |
|---|---|---|---|---|
| 1.7.3 | Juni 2026 | Huidig | 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. Zorg er bij het kiezen van uw versies voor dat de compatibiliteit tussen Django, Python en mssql-django:
| Django-versie | Python-versies |
|---|---|
| 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
Gebruik altijd een ondersteunde Python-versie. Oudere Python versies ontvangen geen beveiligingsupdates.
compatibiliteit met SQL Server-versie
De mssql-django back-end werkt met alle ondersteunde versies van SQL Server.
Azure SQL Services
| Dienst | Ondersteuningsstatus |
|---|---|
| Azure SQL Database | Volledig ondersteund |
| Azure SQL Managed Instance (een beheerde database-instantie van Azure) | Volledig ondersteund |
Microsoft Fabric
| Eindpunt | Ondersteuningsstatus |
|---|---|
| Een SQL-database in Fabric | Volledig ondersteund |
Compatibiliteit van ODBC-stuurprogramma's
Voor de mssql-django back-end is een extern ODBC-stuurprogramma vereist, in tegenstelling tot het mssql-python stuurprogramma dat Gebruikmaakt van Direct Database Connectivity (DDBC).
Vanaf mssql-django 1.7 wordt de back-end standaard ingesteld op ODBC-stuurprogramma 18 voor SQL Server en wordt automatisch teruggezet naar ODBC-stuurprogramma 17 als versie 18 niet is geïnstalleerd. U kunt dit overschrijven door de optie op te geven in de driver databaseconfiguratie.
| 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 | Supported |
Zie ODBC-stuurprogramma downloaden voor SQL Server voor installatie-instructies.
Compatibiliteit van besturingssysteem
De mssql-django backend werkt overal waar Python en het ODBC-stuurprogramma worden ondersteund. De installatiestappen van het ODBC-stuurprogramma variëren per besturingssysteem. Zie Mssql-django installeren voor platformspecifieke installatie.
| besturingssysteem | Architecture | Ondersteuningsstatus |
|---|---|---|
| Windows 11 | x64, ARM64 | Supported |
| Windows Server 2019, 2022, 2025 | x64 | Supported |
| Ubuntu 22.04, 24.04 | x64, ARM64 | Supported |
| Debian 11, 12 | x64, ARM64 | Supported |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Supported |
| macOS 14, 15 | Intel, Apple Silicon (ARM64) | Supported |
| Alpine Linux | x64 | Ondersteund (vereist glibc-compatibiliteitslaag of FreeTDS) |
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 |
Ja (SQL Server 2016+) |
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 (via pyodbc) |
| 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 | >= 3,2 |
pyodbc |
ODBC-databasestuurprogramma voor Python | >= 3,0 |
pytz |
Ondersteuning voor tijdzones (verouderd; moderne Django maakt gebruik van ingebouwd zoneinfo met USE_TZ=True) |
Any |
De mssql-django back-end vereist ook dat het Microsoft ODBC-stuurprogramma voor SQL Server op het hostsysteem moet worden geïnstalleerd. Zie Mssql-django installeren voor meer informatie.
Beleid voor versiebeheer en wijzigingen die fouten veroorzaken
- 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): Alleen oplossingen voor fouten opnemen.
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:
Wanneer u een probleem meldt, neemt u uw Django-versie, Python versie, SQL Server versie, ODBC-stuurprogrammaversie en een minimale reproductie van het probleem op.
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 Developer Center