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

Important

A(z) mssql-python illesztőprogramtól eltérően a(z) mssql-django külső ODBC-illesztőprogramot igényel. A Django-projekt konfigurálása előtt telepítse a SQL Server Microsoft ODBC-illesztőprogramját.

Telepítés a PyPI-ból

Telepítse a csomagot a pip segítségével. Ez a parancs automatikusan telepíti a Django, a pyodbc és a pytz elemet is:

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

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

A mssql-django 1.7.4 esetében a csomag metaadat tartalmazza az alábbi függőségi korlátokat:

Komponens Verzióra vonatkozó útmutató
Python 3.8-os vagy újabb verziók
Django >=3.2 és <6.1
pyodbc >=3.0
pytz 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.

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

Ellenőrizze a telepítést Python az ODBC-réteg tesztelésével:

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 ODBC-illesztőprogram telepítési lépései az operációs rendszertől függően változnak.

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 ODBC adatbázis-illesztőprogram Pythonhoz
pytz Időzóna támogatása

A backend belsőleg importálja a(z) pytz elemet, hogy az SQL Serverrel való használathoz konvertálja az időzónát kezelő datetime értékeket, így a(z) pytz továbbra is kötelező futásidejű függőség marad, még akkor is, ha a Django-projekted a(z) USE_TZ=True elemet használja a szabványos könyvtári zoneinfo modullal.

Kapcsolódó tartalom

  • Last updated on