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.10 až 3.14. Django 6.0 a novější verze vyžadují alespoň Python 3.12.
  • pip package manager (součástí Python 3.4 a novějších verzí)
  • Microsoft ODBC Driver 17 nebo 18 pro SQL Server, pro databázové aliasy, které používají výchozí pyodbc ovladač. Viz Stažení ovladače ODBC pro SQL Server.

Important

mssql-django 2.0 vyžaduje mssql-python verzi 1.15.0 nebo vyšší, i když každý alias databáze používá pyodbc. Balíček se instaluje pouze na platformách, které mají kompatibilní mssql-python distribuci. Projekty na jiných platformách zůstávají na verzi 1.8.0. Pro seznam platforem viz podpora mssql-django a životní cyklus.

Instalace z PyPI

Nainstalujte balíček pomocí pip. Tento příkaz také automaticky instaluje Django, pyodbc, mssql-python a tzdata:

pip install mssql-django

Aktualizace stávající instalace:

pip install --upgrade mssql-django

Instalace konkrétní verze:

pip install mssql-django==2.0.0

Kompatibilita závislostí a verzí

Pro mssql-django verzi 2.0 obsahují metadata balíčku tato závislostní omezení:

Součást Pokyny pro verzi
Python 3.10 až 3.14
Django >=5.2 a <6.2
pyodbc >=3.0
mssql-python >=1.15.0
tzdata 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ě.

Vyberte ovladač databáze

pyodbc je výchozí ovladač a nepotřebuje žádnou konfiguraci. Chcete-li místo toho spustit databázový alias na mssql-python, přidejte do slovníku OPTIONS tohoto aliasu položku "python_driver": "mssql_python". Aliasy mohou používat různé ovladače ve stejném projektu. Pro rozdíly v chování a možnosti, které každý ovladač ignoruje, viz Vybrat ovladač databáze pro mssql-django.

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

Ověřte vrstvu ODBC, kterou výchozí cesta pyodbc používá:

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

Databázové aliasy, které používají výchozí ovladač, pyodbc vyžadují samostatně nainstalovaný ODBC ovladač a kroky instalace se liší podle operačního systému. Aliasy, které používají mssql-python , tyto kroky nepotřebují. Místo toho nainstalujte platformní předpoklady pro mssql-python, včetně OpenSSL na macOS a požadovaných knihoven na Linuxu.

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 Výchozí ovladač databáze ODBC pro Python
mssql-python Volitelný ovladač databáze pro Python, instalovaný vždy
tzdata IANA databáze časových pásem pro zoneinfo standardní knihovní modul

Backend převádí hodnoty podle časových pásem datetime pomocí standardního zoneinfo knihovního modulu. zoneinfo čte databázi časových pásem IANA operačního systému, je-li k dispozici, a jinak použije balíček tzdata, který pokrývá Windows a minimalistické image kontejnerů. pytz už není závislostí.

Související obsah

  • Poslední aktualizace v