Instalowanie narzędzia mssql-django

Pakiet mssql-django jest oficjalnym zapleczem bazy danych Django obsługiwanym Microsoft na potrzeby SQL Server, Azure SQL Database, Azure SQL Managed Instance i bazy danych SQL w Microsoft Fabric. W tym artykule wyjaśniono, jak zainstalować pakiet i jego zależności.

Wymagania wstępne

• Python 3.10 do 3.14. Django 6.0 i nowsze wersje wymagają co najmniej Python 3.12.
• menedżer pakietów pip (dołączony do wersji Python 3.4 lub nowszej)
• Microsoft ODBC Driver 17 lub 18 dla SQL Server, dla aliasów baz danych używających domyślnego pyodbc sterownika. Zobacz Pobieranie sterownika ODBC dla programu SQL Server.

Instalacja z PyPI

Zainstaluj pakiet, używając pip. To polecenie instaluje także Django, pyodbc, mssql-python, i tzdata automatycznie:

pip install mssql-django

Aby uaktualnić istniejącą instalację:

pip install --upgrade mssql-django

Aby zainstalować określoną wersję:

pip install mssql-django==2.0.0

Zgodność zależności i wersji

W mssql-django wersji 2.0 metadane pakietu zawierają następujące ograniczenia zależności:

Wybierz sterownik bazy danych

pyodbc jest domyślnym sterownikiem i nie wymaga żadnej konfiguracji. Aby zamiast tego uruchamiać alias bazy danych na mssql-python, dodaj "python_driver": "mssql_python" do słownika OPTIONS tego aliasu. Aliasy mogą używać różnych sterowników w tym samym projekcie. Aby poznać różnice w zachowaniu i opcje, które każdy sterownik ignoruje, zobacz Wybierz sterownik bazy danych dla mssql-django.

Weryfikowanie instalacji

Po zakończeniu instalacji sprawdź, czy pakiet jest poprawnie zainstalowany:

pip show mssql-django

Oczekiwane dane wyjściowe:

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

Sprawdź warstwę ODBC, którą używa domyślna pyodbc ścieżka:

import pyodbc

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

Korzystanie ze środowiska wirtualnego

Użyj środowiska wirtualnego Python, aby odizolować zależności projektu:

python -m venv .venv

Aktywuj środowisko wirtualne:

.venv\Scripts\activate

source .venv/bin/activate

Następnie zainstaluj mssql-django w środowisku wirtualnym:

pip install mssql-django

Uwagi specyficzne dla platformy

Aliasy bazowe wykorzystujące domyślny pyodbc sterownik wymagają osobno zainstalowanego sterownika ODBC, a etapy instalacji różnią się w zależności od systemu operacyjnego. Aliasy, które używają mssql-python , nie wymagają tych kroków. Zamiast tego zainstaluj wymagania platformowe dla mssql-python, w tym OpenSSL na macOS oraz wymagane biblioteki na Linuksie.

Windows

Zainstaluj sterownik Microsoft ODBC Driver 18 dla programu SQL Server za pomocą instalatora .msi ze strony Pobierz sterownik ODBC Driver dla programu SQL Server.

Linux

Zainstaluj sterownik ODBC przy użyciu menedżera pakietów dystrybucji. Aby uzyskać instrukcje specyficzne dla platformy, zobacz Instalowanie sterownika Microsoft ODBC dla SQL Server (Linux).

macOS

Zainstaluj sterownik ODBC za pomocą oprogramowania Homebrew:

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

Zależności

Pakiet mssql-django automatycznie instaluje następujące zależności:

Zaplecze konwertuje wartości uwzględniające strefę czasową datetime, używając modułu zoneinfo ze standardowej biblioteki. zoneinfo odczytuje bazę danych stref czasowych IANA systemu operacyjnego, gdy jest ona dostępna, a w przeciwnym razie korzysta z pakietu tzdata, który obsługuje system Windows i minimalne obrazy kontenerów. pytz nie jest już zależnością.

Treści powiązane

• Szybki start: łączenie platformy Django z SQL Server
• Wybierz sterownik bazy danych dla mssql-django
• dokumentacja konfiguracji mssql-django
• Tworzenie aplikacji w kontenerach i lokalnie za pomocą mssql-django
• Pobierz sterownik ODBC dla programu SQL Server
• Przewodnik instalacji platformy Django