mssql-django yükleme

mssql-django paketi, SQL Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği ve Microsoft Fabric'deki SQL veritabanı için Microsoft tarafından resmen desteklenen Django veritabanı arka ucudur. Bu makalede paketin ve bağımlılıklarının nasıl yükleneceği açıklanmaktadır.

Prerequisites

Important

mssql-python Sürücünün aksine, mssql-django bir dış ODBC sürücüsü gerektirir. Django projenizi yapılandırmadan önce SQL Server için Microsoft ODBC Sürücüsünü yükleyin.

PyPI'dan yükleme

Pip kullanarak paketi yükleyin. Bu komut ayrıca Django, pyodbc ve pytz'i de otomatik olarak yükler:

pip install mssql-django

Mevcut bir yüklemeyi yükseltmek için:

pip install --upgrade mssql-django

Belirli bir sürümü yüklemek için:

pip install mssql-django==1.7.4

Bağımlılık ve sürüm uyumluluğu

1.7.4 için mssql-django , paket meta veri şu bağımlılık kısıtlamalarını içerir:

Bileşen Sürüm kılavuzu
Python 3.8 veya üzeri sürümler
Django >=3.2 ve <6.1
pyodbc >=3.0
pytz Bağımlılık olarak yüklendi

Tip

Doğrulanmış bir kilit dosyanız yoksa, uyumlu sürümleri pip belirlesin. Daha eski pyodbc bir sürümü sabitlemek, yükleme başarılı olduğunda bile çalışma zamanı sorunlarına neden olabilir.

Yüklemeyi doğrulama

Yüklemeden sonra paketin doğru yüklendiğini doğrulayın:

pip show mssql-django

Beklenen çıkış:

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

ODBC katmanını test ederek Python yüklemesini doğrulayın:

import pyodbc

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

Note

mssql-django Arka uç, Django'nun veritabanı yönlendirme sisteminde otomatik olarak yapılandırılır. Uygulama kodunda doğrudan içeri aktarmayın. Bunun yerine, ENGINE yapılandırmanızda mssql öğesini DATABASES olarak ayarlayın.

Sanal ortam kullanma

Proje bağımlılıklarını yalıtmak için Python sanal ortamı kullanın:

python -m venv .venv

Sanal ortamı etkinleştirin:

.venv\Scripts\activate

Ardından sanal ortamın içine yükleyin mssql-django :

pip install mssql-django

Platforma özgü notlar

ODBC sürücüsü yükleme adımları işletim sistemine göre farklılık gösterir.

Windows

SQL Server için ODBC Sürücüsü İndir'den yükleyiciyi .msi kullanarak SQL Server için Microsoft ODBC Sürücüsü 18'i yükleyin.

Linux

Dağıtımınızın paket yöneticisini kullanarak ODBC sürücüsünü yükleyin. Platforma özgü yönergeler için bkz. SQL Server için Microsoft ODBC sürücüsünü yükleme (Linux).

macOS

Homebrew ile ODBC sürücüsünü yükleyin:

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

Bağımlılıklar

Paket mssql-django aşağıdaki bağımlılıkları otomatik olarak yükler:

Package Purpose
Django Web çerçevesi
pyodbc Python için ODBC veritabanı sürücüsü
pytz Saat dilimi desteği

Arka uç, zaman kuşağına duyarlı datetime değerlerini SQL Server’a göre dönüştürmek için pytz öğesini dahili olarak içe aktarır; bu nedenle, Django projeniz standart kitaplık zoneinfo modülüyle USE_TZ=True kullansa bile, pytz gerekli bir çalışma zamanı bağımlılığı olarak kalır.

İlgili içerik

  • Last updated on