Beperkingen en niet-ondersteunde functies in mssql-django

Dit artikel vermeldt beperkingen van de mssql-django backend wanneer deze wordt gebruikt met SQL Server, Azure SQL Database, Azure SQL Managed Instance en SQL Database in Microsoft Fabric.

Beperkingen van Django-functies

De volgende Django-functies worden niet ondersteund of hebben beperkte ondersteuning in de mssql-django backend:

Migratiebeperkingen

JSONField beperkingen

• mssql-djangoMaps JSONField naar Nvarchar(max). SQL Server 2025 introduceerde een native json-type, maar de Microsoft ODBC-driver voor SQL Server maakt dit niet beschikbaar.
• De contains zoekopdracht wordt niet ondersteund. Gebruik in plaats daarvan key-path lookups (bijvoorbeeld filter(metadata__color="blue")).
• Quoteerde stringwaarden geven extra aanhalingstekens terug (bijvoorbeeld '"value"' in plaats van 'value').
• Sommige geneste opzoekopdrachten kunnen anders werken dan op PostgreSQL.
• Voor meer informatie, zie JSONField met SQL Server.

Beperkingen van inspectDB

• Samengestelde primaire sleutels worden niet automatisch unique_together gegenereerd.
• Sommige SQL Server-specifieke kolomtypes kunnen worden gekoppeld aan generieke Django-velden.
• Bekijk en pas gegenereerde modellen handmatig aan.
• Voor meer informatie, zie Reverse-engineer models with inspectdb.

SQL Server parameterlimiet

SQL Server beperkt elke query tot maximaal 2.100 parameters. Deze limiet beïnvloedt Django-operaties die geparametriseerde queries genereren met grote waardelijsten:

Stel in batch_size op bulkoperaties en chunk large IN queries. Zie Performance tuning voor oplossingen.

Beperkingen van bulkoperaties

• bulk_create die return_rows_bulk_insert=False geen ID's teruggeven. Vereist voor tabellen met triggers. Zie Bulkbewerkingen met mssql-django.

Beperkingen van testframeworks

--keepdb is vereist bij het gebruik van beheerde identiteitsauthenticatie (ActiveDirectoryMsi) omdat de testrunner databases niet kan aanmaken of vernietigen met die authenticatiemethode.

Voor meer informatie, zie Test Django apps met SQL Server.

Versie-specifieke opmerkingen

Django-versie-specifieke notities

Stel regex-opzoekingen in

De mssql-django backend ondersteunt Django's __regex en __iregex lookups, maar die vereisen een eenmalige opstellingsstap. De backend levert een CLR-assembly (regex_clr.dll) die een dbo.REGEXP_LIKE functie aan SQL Server biedt.

Prerequisites

• Een SQL Server-instantie die CLR-integratie ondersteunt. On-premises SQL Server en Azure SQL Managed Instance ondersteunen CLR. Azure SQL Database ondersteunt geen CLR-assemblies, dus __regex opzoekopdrachten __iregex zijn niet beschikbaar in Azure SQL Database.
• De verbindende gebruiker moet een of ALTER SETTINGS toestemming hebbensysadmin. Het managementcommando schakelt CLR automatisch in.
• De mssql app moet in INSTALLED_APPS.

Installeer de CLR-assemblage

Voer het managementcommando uit en geef je databasenaam door:

python manage.py install_regex_clr <your-database-name>

Dit commando voert de volgende stappen uit:

1. Schakelt CLR in op de server in (sp_configure 'clr enabled', 1) als het nog niet is ingeschakeld.
2. Zet zich in clr strict security op 0 (vereist voor SAFE assemblies op SQL Server 2017+).
3. Maakt de regex_clr assembly aan uit de gebundelde DLL.
4. Maakt de dbo.REGEXP_LIKE scalaire functie aan.

Gebruik regex-opzoekingen

Na installatie van de assembly, gebruik __regex en __iregex in querysets:

# Case-sensitive regex
products = Product.objects.filter(name__regex=r"^Widget \d+$")

# Case-insensitive regex
products = Product.objects.filter(name__iregex=r"^widget \d+$")

De backend vertaalt deze lookups naar dbo.REGEXP_LIKE(column, pattern, case_flag) = 1.

Verwante inhoud

• Troubleshoot mssql-django
• FAQ
• MSSQL-Django ondersteuning en levenscyclus
• GitHub-problemen