Az mssql-django telepítése

A mssql-django csomag a Microsoft Fabric SQL Server, Azure SQL Database, Azure SQL Managed Instance és SQL-adatbázisának hivatalos Microsoft által támogatott Django-adatbázis-háttérrendszere. Ez a cikk bemutatja, hogyan telepítheti a csomagot és annak függőségeit.

Prerequisites

  • Python 3.10-től 3.14-ig. A Django 6.0 és újabb verziók legalább Python 3.12-t igényelnek.
  • pip package manager (Python 3.4-ben és újabb verziókban)
  • Microsoft ODBC Driver 17 vagy 18 SQL Server számára, adatbázis-aliasokhoz, amelyek az alapértelmezett pyodbc drivert használják. Lásd: Az SQL Serverhez készült ODBC-illesztőprogram letöltése.

Important

mssql-django A 2.0 verziója 1.15.0 vagy újabb verziót igényel mssql-python , még akkor is, ha minden adatbázis alias használ pyodbc. A csomag csak olyan platformokra telepíthető, amelyeknek kompatibilis mssql-python disztribúciójuk van. Más platformokon lévő projektek a 1.8.0 verzión maradnak. A platformlistáért lásd: mssql-django támogatás és életciklus.

Telepítés a PyPI-ból

Telepítsd a csomagot a pip használatával. Ez a parancs automatikusan telepíti a következőket: Django, pyodbc, mssql-python és tzdata.

pip install mssql-django

Meglévő telepítés frissítése:

pip install --upgrade mssql-django

Egy adott verzió telepítése:

pip install mssql-django==2.0.0

Függőségek és verziókompatibilitás

A mssql-django 2.0-hoz a csomag metaadat tartalmazza a következő függőségi korlátokat:

Komponens Verzióra vonatkozó útmutató
Python 3.10-től 3.14-ig
Django >=5.2 és <6.2
pyodbc >=3.0
mssql-python >=1.15.0
tzdata Függőségként telepítve

Tip

Hagyja pip feloldani a kompatibilis verziókat, hacsak nem rendelkezik tesztelt zárolási fájllal. A régebbi pyodbc verziók rögzítése futásidejű problémákat okozhat még akkor is, ha a telepítés sikeres.

Válasszon egy adatbázis-meghajtót

pyodbc alapértelmezett illesztőprogram, és nem igényel konfigurációt. Ha azt szeretnéd, hogy helyette a(z) mssql-python adatbázisalias fusson, add hozzá a(z) "python_driver": "mssql_python" elemet az alias OPTIONS szótárához. Az álnevek különböző illesztőprogramokat használhatnak ugyanabban a projektben. A viselkedésbeli különbségekről és az egyes illesztőprogramok által figyelmen kívül hagyott beállításokról lásd a következőt: Az adatbázis-illesztőprogram kiválasztása a mssql-djangohoz.

A telepítés ellenőrzése

A telepítés után ellenőrizze, hogy a csomag megfelelően van-e telepítve:

pip show mssql-django

Várt kimenet:

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

Ellenőrizd az alapértelmezett út által használt ODBC réteget pyodbc :

import pyodbc

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

Note

A mssql-django háttérrendszer automatikusan konfigurálva van a Django adatbázis-útválasztási rendszerében. Ne importálja közvetlenül az alkalmazáskódba. Ehelyett állítsa a ENGINE beállítást mssql-ra a DATABASES konfigurációjában.

Virtuális környezet használata

A projektfüggőségek elkülönítéséhez használjon Python virtuális környezetet:

python -m venv .venv

A virtuális környezet aktiválása:

.venv\Scripts\activate

Ezután telepítse mssql-django a virtuális környezetben:

pip install mssql-django

Platformspecifikus megjegyzések

Az alapértelmezett pyodbc illesztőprogramot használó adatbázis-aliasokhoz külön telepített ODBC-illesztőprogramra van szükség, és a telepítés lépései operációs rendszerenként eltérnek. Azok az álnevek, amelyek a mssql-python elemet használják, nem igénylik ezeket a lépéseket. Ehelyett telepítsd a platformon az mssql-python előfeltételeit, beleértve az OpenSSL-t macOS-en és a szükséges könyvtárakat Linuxon.

Windows

Telepítse a Microsoft ODBC Driver 18 for SQL Server illesztőprogramot a .msi oldalról származó telepítővel.

Linux

Telepítse az ODBC-illesztőprogramot a disztribúció csomagkezelőjével. Platformspecifikus utasításokért tekintse meg a SQL Server (Linux) Microsoft ODBC-illesztőprogramjának telepítését.

macOS

Telepítse az ODBC-illesztőt a Homebrew használatával:

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

Függőségek

A mssql-django csomag automatikusan telepíti a következő függőségeket:

Package Alkalmazás célja
Django Webes keretrendszer
pyodbc Alapértelmezett ODBC adatbázis-illezőprogram Python számára
mssql-python Választható Python adatbázis-illesztőprogram, mindenképpen telepítve
tzdata IANA időzóna adatbázis a standard könyvtári zoneinfo modulhoz

A háttérrendszer az időzóná-alapú datetime értékeket a szabványos könyvtármodul zoneinfo használatával konvertálja. zoneinfoha létezik, olvassa az operációs rendszer IANA időzóna adatbázisát, és egyébként visszatér a tzdata csomaghoz, amely lefedi a Windows-t és a minimális konténer képeket. pytz már nem függőség.

Kapcsolódó tartalom

  • Utolsó frissítés időpontja: