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.

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:

Ü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()}")

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

source .venv/bin/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:

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

• Schnellstart: Verbinden von Django mit SQL Server
• mssql-django-Konfigurationsreferenz
• Container und lokale Entwicklung mit mssql-django
• Herunterladen des ODBC-Treibers für SQL Server
• Django-Installationshandbuch