mssql-django installeren

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. In dit artikel wordt uitgelegd hoe u het pakket en de bijbehorende afhankelijkheden installeert.

Prerequisites

  • Python 3.10 tot en met 3.14. Django 6.0 en latere versies vereisen minimaal Python 3.12.
  • pip Package Manager (opgenomen in Python 3.4 en latere versies)
  • Microsoft ODBC Driver 17 of 18 voor SQL Server, voor databasealiasen die de standaarddriver pyodbc gebruiken. Zie ODBC-stuurprogramma downloaden voor SQL Server.

Important

mssql-django 2.0 vereist mssql-python 1.15.0 of hoger, zelfs als elke databasealias 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. Voor de platformlijst, zie mssql-django ondersteuning en levenscyclus.

Installeren vanuit PyPI

Installeer het pakket met pip. Dit commando installeert ook Django, pyodbc, , mssql-pythonen tzdata automatisch:

pip install mssql-django

Een bestaande installatie bijwerken:

pip install --upgrade mssql-django

Een specifieke versie installeren:

pip install mssql-django==2.0.0

Compatibiliteit van afhankelijkheden en versies

Voor mssql-django 2.0 bevat de pakketmetadata deze afhankelijkheidsbeperkingen:

Onderdeel Richtlijnen voor versiebeheer
Python 3.10 tot en met 3.14
Django >=5.2 en <6.2
pyodbc >=3.0
mssql-python >=1.15.0
tzdata Geïnstalleerd als een afhankelijkheid

Tip

Laat pip compatibele versies bepalen, tenzij u een getest lockbestand hebt. Het vastmaken van een oudere pyodbc versie kan runtimeproblemen veroorzaken, zelfs wanneer de installatie slaagt.

Kies een databasedriver

pyodbc is de standaarddriver en heeft geen configuratie nodig. Om een databasealias in plaats daarvan op mssql-python uit te voeren, voeg "python_driver": "mssql_python" toe aan het OPTIONS-woordenboek van die alias. Aliassen kunnen verschillende drivers in hetzelfde project gebruiken. Voor de gedragsverschillen en de opties die elke driver negeert, zie Selecteer de databasedriver voor mssql-django.

De installatie controleren

Controleer na de installatie of het pakket correct is geïnstalleerd:

pip show mssql-django

Verwachte uitvoer:

Name: mssql-django
Version: 2.0.0
Summary: Django backend for Microsoft SQL Server

Controleer de ODBC-laag die het standaardpad pyodbc gebruikt:

import pyodbc

print(f"pyodbc version: {pyodbc.version}")
print(f"Available ODBC drivers: {pyodbc.drivers()}")

Note

De mssql-django backend wordt automatisch geconfigureerd in Django's database-routeringssysteem. Importeer deze niet rechtstreeks in de toepassingscode. Stel in plaats daarvan ENGINE in op mssql in uw DATABASES-configuratie.

Een virtuele omgeving gebruiken

Gebruik een Python virtuele omgeving om projectafhankelijkheden te isoleren:

python -m venv .venv

De virtuele omgeving activeren:

.venv\Scripts\activate

Installeer vervolgens mssql-django in de virtuele omgeving:

pip install mssql-django

Platformspecifieke notities

Databasealiasen die de standaarddriver pyodbc gebruiken, hebben een apart geïnstalleerde ODBC-driver nodig, en de installatiestappen verschillen per besturingssysteem. Aliassen die mssql-python gebruiken, hebben deze stappen niet nodig. Installeer in plaats daarvan de platformvereisten voor mssql-python, inclusief OpenSSL op macOS en de vereiste bibliotheken op Linux.

Windows

Installeer het Microsoft ODBC-stuurprogramma 18 voor SQL Server met behulp van het .msi installatieprogramma van het ODBC-stuurprogramma downloaden voor SQL Server.

Linux

Installeer het ODBC-stuurprogramma met behulp van pakketbeheer van uw distributie. Zie Het ODBC-stuurprogramma voor Microsoft installeren voor SQL Server (Linux) voor platformspecifieke instructies.

macOS

Installeer het ODBC-stuurprogramma met Homebrew:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18

Dependencies

Het mssql-django pakket installeert automatisch de volgende afhankelijkheden:

Package Purpose
Django Webraamwerk
pyodbc Standaard ODBC-databasedriver voor Python
mssql-python Optioneel Python-databasestuurprogramma, onvoorwaardelijk geïnstalleerd
tzdata IANA tijdzonedatabase voor de standaard bibliotheekmodule zoneinfo

De back-end zet tijdzoneafhankelijke datetime-waarden om met behulp van de standaardbibliotheekmodule zoneinfo. zoneinfoleest de IANA-tijdzonedatabase van het besturingssysteem wanneer die bestaat en valt verder terug op het tzdata pakket, dat Windows- en minimale containerimages dekt. pytz is geen afhankelijkheid meer.

Verwante inhoud

  • Last updated on