Installera mssql-django

Paketet mssql-django är den officiella Microsoft Django-databasserverdelen som stöds för SQL Server, Azure SQL Database, Azure SQL Managed Instance och SQL-databas i Microsoft Fabric. Den här artikeln beskriver hur du installerar paketet och dess beroenden.

Förutsättningar

  • Python 3.10 till 3.14. Django 6.0 och senare versioner kräver minst Python 3.12.
  • pip package manager (ingår i Python 3.4 och senare versioner)
  • Microsoft ODBC Driver 17 eller 18 för SQL Server, för databasaliaser som använder standarddrivrutinenpyodbc. Se Ladda ned ODBC-drivrutin för SQL Server.

Important

mssql-django 2.0 kräver mssql-python 1.15.0 eller senare, även när varje databasalias använder pyodbc. Paketet installeras endast på plattformar som har en kompatibel mssql-python distribution. Projekt på andra plattformar förblir på version 1.8.0. För plattformslistan, se mssql-django-support och livscykel.

Installera från PyPI

Installera paketet med pip. Detta kommando installerar också Django, pyodbc, mssql-python, och tzdata automatiskt:

pip install mssql-django

Så här uppgraderar du en befintlig installation:

pip install --upgrade mssql-django

Så här installerar du en specifik version:

pip install mssql-django==2.0.0

Beroende- och versionskompatibilitet

För mssql-django 2.0 inkluderar paketets metadata dessa beroendebegränsningar:

Component Versionsvägledning
Python 3.10 till 3.14
Django >=5.2 och <6.2
pyodbc >=3.0
mssql-python >=1.15.0
tzdata Installerat som ett beroende

Tip

Låt pip lösa kompatibla versioner om du inte har en testad låsfil. Om du fäster en äldre pyodbc version kan det orsaka körningsproblem även när installationen lyckas.

Välj en databasdrivrutin

pyodbc är standarddrivrutinen och behöver ingen konfiguration. Om du i stället vill använda ett databasalias på mssql-python, lägger du till "python_driver": "mssql_python" i aliasets OPTIONS-ordlista. Alias kan använda olika drivrutiner i samma projekt. För beteendeskillnader och vilka alternativ varje drivrutin ignorerar, se Välj databasdrivrutinen för mssql-django.

Kontrollera installationen

Kontrollera att paketet är korrekt installerat efter installationen:

pip show mssql-django

Förväntat resultat:

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

Verifiera det ODBC-lager som standardvägen pyodbc använder:

import pyodbc

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

Note

Serverdelen mssql-django konfigureras automatiskt i Djangos databasroutningssystem. Importera den inte direkt i programkoden. Ange ENGINE i stället till mssql i konfigurationen DATABASES .

Använda en virtuell miljö

Använd en Python virtuell miljö för att isolera projektberoenden:

python -m venv .venv

Aktivera den virtuella miljön:

.venv\Scripts\activate

Installera mssql-django sedan i den virtuella miljön:

pip install mssql-django

Plattformsspecifika anteckningar

Databasaliaser som använder standarddrivrutinen pyodbc behöver en separat installerad ODBC-drivrutin, och installationsstegen varierar beroende på operativsystem. Alias som används mssql-python behöver inte dessa stegen. Installera istället plattformskraven för mssql-python, inklusive OpenSSL på macOS och de nödvändiga biblioteken på Linux.

Windows

Installera Microsoft ODBC Driver 18 för SQL Server med installationsprogrammet .msi från Ladda ned ODBC-drivrutin för SQL Server.

Linux

Installera ODBC-drivrutinen med hjälp av distributionens pakethanterare. Se Installera Microsoft ODBC-drivrutin för SQL Server (Linux) för plattformsspecifika instruktioner.

macOS

Installera ODBC-drivrutinen med Homebrew:

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

Beroenden

Paketet mssql-django installerar automatiskt följande beroenden:

Package Purpose
Django Webbramverk
pyodbc Standard ODBC-databasdrivrutin för Python
mssql-python Valfri databasdrivrutin för Python, installeras alltid
tzdata IANA-tidszonsdatabas för standardbiblioteksmodulen zoneinfo

Serverdelen konverterar tidszonsmedvetna datetime-värden med modulen zoneinfo i standardbiblioteket. zoneinfo läser operativsystemets IANA-tidszonsdatabas när en sådan finns och använder annars paketet tzdata, vilket täcker Windows och minimala containerbilder. pytz är inte längre ett beroende.

Relaterat innehåll

  • Last updated on