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.8 of hoger. Django 6.0 vereist Python 3.12 en nieuwere versies.
  • pip Package Manager (opgenomen in Python 3.4 en latere versies)
  • Microsoft ODBC-stuurprogramma 17 of 18 voor SQL Server. Zie ODBC-stuurprogramma downloaden voor SQL Server.

Important

In tegenstelling tot het mssql-python stuurprogramma mssql-django is een extern ODBC-stuurprogramma vereist. Installeer het Microsoft ODBC-stuurprogramma voor SQL Server voordat u uw Django-project configureert.

Installeren vanuit PyPI

Installeer het pakket met behulp van pip. Met deze opdracht worden ook automatisch Django, pyodbc en pytz geïnstalleerd:

pip install mssql-django

Een bestaande installatie bijwerken:

pip install --upgrade mssql-django

Een specifieke versie installeren:

pip install mssql-django==1.7.3

Compatibiliteit van afhankelijkheden en versies

Voor mssql-django 1.7.3 bevat de pakketmetagegevens de volgende afhankelijkheidsbeperkingen:

Onderdeel Richtlijnen voor versiebeheer
Python 3.8 of nieuwere versies
Django >=3.2 en <6.1
pyodbc >=3.0
pytz 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.

De installatie controleren

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

pip show mssql-django

Verwachte uitvoer:

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

Controleer de installatie van Python door de ODBC-laag te testen:

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

De installatiestappen van het ODBC-stuurprogramma variëren per besturingssysteem.

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 ODBC-databasestuurprogramma voor Python
pytz Ondersteuning voor tijdzones

pytz blijft een pakketafhankelijkheid voor compatibiliteit, maar de meeste moderne Django-tijdzonewerkstromen worden gebruikt USE_TZ=True met de ingebouwde verwerking van tijdzones van Django.

Verwante inhoud

  • Last updated on