Nainstalujte mssql-django

Balíček mssql-django je oficiální back-end databáze Django podporovaný Microsoft pro SQL Server, Azure SQL Database, Azure SQL Managed Instance a databázi SQL v Microsoft Fabric. Tento článek vysvětluje, jak nainstalovat balíček a jeho závislosti.

Prerequisites

  • Python 3.8 nebo novější Django 6.0 vyžaduje Python 3.12 a novější verze.
  • pip package manager (součástí Python 3.4 a novějších verzí)
  • Microsoft ovladač ODBC 17 nebo 18 pro SQL Server. Viz Stažení ovladače ODBC pro SQL Server.

Important

mssql-python Na rozdíl od ovladače vyžaduje mssql-django externí ovladač ODBC. Před konfigurací projektu Django nainstalujte ovladač Microsoft ODBC pro SQL Server.

Instalace z PyPI

Nainstalujte balíček pomocí nástroje pip. Tento příkaz také automaticky nainstaluje Django, pyodbc a pytz:

pip install mssql-django

Aktualizace stávající instalace:

pip install --upgrade mssql-django

Instalace konkrétní verze:

pip install mssql-django==1.7.3

Kompatibilita závislostí a verzí

Metadata mssql-django balíčku pro verzi 1.7.3 zahrnují tato omezení závislostí:

Součást Pokyny pro verzi
Python Verze 3.8 nebo novější
Django >=3.2 a <6.1
pyodbc >=3.0
pytz Nainstalováno jako závislost

Tip

Nechte pip určit kompatibilní verze, pokud nemáte otestovaný soubor zámku. Připnutí ke starší verzi pyodbc může způsobit problémy za běhu, i když instalace proběhne úspěšně.

Ověření instalace

Po instalaci ověřte, že je balíček správně nainstalovaný:

pip show mssql-django

Očekávaný výstup:

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

Ověřte instalaci z Python tím, že otestujete vrstvu ODBC:

import pyodbc

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

Note

Back-end mssql-django se automaticky nakonfiguruje v systému směrování databáze Django. Neimportujte ho přímo v kódu aplikace. Místo toho nastavte u ENGINE hodnotu mssql v konfiguraci DATABASES.

Použití virtuálního prostředí

K izolaci závislostí projektu použijte virtuální prostředí Python:

python -m venv .venv

Aktivujte virtuální prostředí:

.venv\Scripts\activate

Pak nainstalujte mssql-django do virtuálního prostředí:

pip install mssql-django

Poznámky specifické pro platformu

Postup instalace ovladače ODBC se liší podle operačního systému.

Windows

Nainstalujte ovladač Microsoft ODBC 18 pro SQL Server pomocí instalačního .msi programu ze souboru Stáhnout ovladač ODBC pro SQL Server.

Linux

Nainstalujte ovladač ODBC pomocí správce balíčků vaší distribuce. Pokyny pro konkrétní platformu najdete v tématu Instalace ovladače Microsoft ODBC pro SQL Server (Linux).

macOS

Nainstalujte ovladač ODBC pomocí Homebrew:

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

Závislosti

Balíček mssql-django automaticky nainstaluje následující závislosti:

Package Purpose
Django Webová architektura
pyodbc Ovladač databáze ODBC pro Python
pytz Podpora časových pásem

pytz zůstává závislostí balíčku kvůli kompatibilitě, ale většina moderních pracovních postupů časových pásem Django se používá USE_TZ=True s integrovaným zpracováním časových pásem Django.

Související obsah

  • Last updated on