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.10 bis 3.14. Django 6.0 und neuere Versionen erfordern mindestens Python 3.12.
• Pip-Paket-Manager (enthalten in Python 3.4 und neueren Versionen)
• Microsoft ODBC Driver 17 oder 18 für SQL Server, für Datenbankaliase, die den Standardtreiber pyodbc verwenden. Siehe "ODBC-Treiber herunterladen" für SQL Server.

Installieren über PyPI

Installiere das Paket mit pip. Dieser Befehl installiert außerdem Django, pyodbc, mssql-python, und tzdata automatisch:

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==2.0.0

Abhängigkeits- und Versionskompatibilität

Für mssql-django 2.0 enthält die Paketmetadaten folgende Abhängigkeitsbeschränkungen:

Wählen Sie einen Datenbanktreiber

pyodbc ist der Standardtreiber und benötigt keine Konfiguration. Um stattdessen ein Datenbankalias auf mssql-python auszuführen, füge OPTIONS zum "python_driver": "mssql_python"-Wörterbuch dieses Alias hinzu. Aliase können im selben Projekt unterschiedliche Treiber verwenden. Für die Verhaltensunterschiede und die Optionen, die jeder Treiber ignoriert, siehe Select the database driver for mssql-django.

Ü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: 2.0.0
Summary: Django backend for Microsoft SQL Server

Überprüfen Sie die ODBC-Schicht, die der Standardpfad pyodbc verwendet:

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

Datenbankalias, die den Standardtreiber pyodbc verwenden, benötigen einen separat installierten ODBC-Treiber, und die Installationsschritte variieren je nach Betriebssystem. Aliasse, die mssql-python verwenden, erfordern diese Schritte nicht. Stattdessen installieren Sie die Plattformvoraussetzungen für mssql-python, einschließlich OpenSSL auf macOS und der erforderlichen Bibliotheken auf Linux.

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:

Das Backend konvertiert zeitzonenbewusste datetime Werte mithilfe des Standardbibliotheksmoduls zoneinfo . zoneinfoliest die IANA-Zeitzonendatenbank des Betriebssystems, wenn eine vorhanden ist, und greift auf das tzdata ansonsten verwendete Paket zurück, das Windows- und minimale Container-Images abdeckt. pytz ist keine Abhängigkeit mehr.

Verwandte Inhalte

• Schnellstart: Verbinden von Django mit SQL Server
• Wählen Sie den Datenbanktreiber für mssql-django aus
• mssql-django-Konfigurationsreferenz
• Container und lokale Entwicklung mit mssql-django
• Herunterladen des ODBC-Treibers für SQL Server
• Django-Installationshandbuch