Installieren von mssql-django

Das mssql-django Paket ist das offizielle Microsoft unterstützte Django-Datenbank-Back-End für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance und SQL-Datenbank in Microsoft Fabric. In diesem Artikel wird erläutert, wie Sie das Paket und die zugehörigen Abhängigkeiten installieren.

Voraussetzungen

  • Python 3.8 oder höher. Django 6.0 erfordert Python 3.12 und neuere Versionen.
  • Pip-Paket-Manager (enthalten in Python 3.4 und neueren Versionen)
  • Microsoft ODBC-Treiber 17 oder 18 für SQL Server. Siehe "ODBC-Treiber herunterladen" für SQL Server.

Important

Anders als der Treiber mssql-python benötigt mssql-django einen externen ODBC-Treiber. Installieren Sie den Microsoft ODBC-Treiber für SQL Server, bevor Sie Ihr Django-Projekt konfigurieren.

Installieren über PyPI

Installieren Sie das Paket mithilfe von Pip. Mit diesem Befehl werden auch Django, Pyodbc und Pytz automatisch installiert:

pip install mssql-django

So aktualisieren Sie eine vorhandene Installation:

pip install --upgrade mssql-django

So installieren Sie eine bestimmte Version

pip install mssql-django==1.7.3

Abhängigkeits- und Versionskompatibilität

Für mssql-django 1.7.3 umfassen die Paketmetadaten die folgenden Abhängigkeitseinschränkungen:

Bestandteil Versionsleitfaden
Python 3.8 oder höhere Versionen
Django >=3.2 und <6.1
pyodbc >=3.0
pytz Als Abhängigkeit installiert

Tip

Lassen Sie pip kompatible Versionen ermitteln, sofern Sie nicht über eine getestete Lockdatei verfügen. Das Anheften einer älteren pyodbc-Version kann Laufzeitprobleme verursachen, auch wenn die Installation erfolgreich ist.

Überprüfen der Installation

Überprüfen Sie nach der Installation, ob das Paket ordnungsgemäß installiert ist:

pip show mssql-django

Erwartete Ausgabe:

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

Überprüfen Sie die Installation von Python, indem Sie die ODBC-Ebene testen:

import pyodbc

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

Note

Das mssql-django Back-End wird automatisch im Datenbankroutingsystem von Django konfiguriert. Importieren Sie sie nicht direkt im Anwendungscode. Setzen Sie stattdessen ENGINE in Ihrer DATABASES-Konfiguration auf mssql.

Verwenden einer virtuellen Umgebung

Verwenden Sie eine Python virtuelle Umgebung, um Projektabhängigkeiten zu isolieren:

python -m venv .venv

Aktivieren Sie die virtuelle Umgebung:

.venv\Scripts\activate

Installieren Sie mssql-django dann innerhalb der virtuellen Umgebung:

pip install mssql-django

Plattformspezifische Hinweise

Die Installationsschritte des ODBC-Treibers variieren je nach Betriebssystem.

Windows

Installieren Sie den Microsoft ODBC-Treiber 18 für SQL Server mit dem .msi Installationsprogramm aus "ODBC-Treiber herunterladen" für SQL Server.

Linux

Installieren Sie den ODBC-Treiber mithilfe des Paket-Managers Ihrer Verteilung. Unter Installieren des Microsoft ODBC-Treibers für SQL Server (Linux) finden Sie plattformspezifische Anweisungen.

macOS

Installieren Sie den ODBC-Treiber mit Homebrew:

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

Abhängigkeiten

Das mssql-django Paket installiert automatisch die folgenden Abhängigkeiten:

Package Purpose
Django Webframework
pyodbc ODBC-Datenbanktreiber für Python
pytz Unterstützung für Zeitzonen

pytz bleibt aus Kompatibilitätsgründen eine Paketabhängigkeit, aber die meisten modernen Django-Zeitzonenworkflows verwenden USE_TZ=True zusammen mit Djangos integrierter Zeitzonenunterstützung.

Verwandte Inhalte

  • Last updated on