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

  • Python 3.10'dan 3.14'e kadar. Django 6.0 ve daha sonraki sürümler en az Python 3.12 gerektirir.
  • pip paket yöneticisi (Python 3.4 ve üzeri sürümlerde bulunur)
  • pyodbc, varsayılan sürücüsünü kullanan veritabanı diğer adları için. bkz. SQL Server için ODBC Sürücüsünü İndirme.

Important

mssql-django 2.0, tüm veritabanı takma adları mssql-python kullansa bile pyodbc 1.15.0 veya sonraki bir sürümünü gerektirir. Paket yalnızca uyumlu mssql-python dağıtıma sahip platformlara yüklenir. Diğer platformlardaki projeler ise 1.8.0 sürümünde kalır. Platform listesi için mssql-django destek ve yaşam döngüsü bölümlerine bakınız.

PyPI'dan yükleme

Paketi pip kullanarak kurun. Bu komut ayrıca Django, pyodbc, mssql-python ve tzdata öğelerini 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==2.0.0

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

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

Bileşen Sürüm kılavuzu
Python 3.10 ile 3.14
Django >=5.2 ve <6.2
pyodbc >=3.0
mssql-python >=1.15.0
tzdata 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.

Bir veritabanı sürücüsü seçin

pyodbc varsayılan sürücü ve yapılandırma gerektirmiyor. Bunun yerine mssql-python üzerinde bir veritabanı takma adı çalıştırmak için, OPTIONS öğesini ilgili takma adın "python_driver": "mssql_python" sözlüğüne ekleyin. Takma adlar aynı projede farklı sürücüler kullanabilir. Davranış farklılıkları ve her sürücünün göz ardı ettiği seçenekler için bkz. Mssql-django için veritabanı sürücüsünü seç.

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

Varsayılan pyodbc yolun kullandığı ODBC katmanını 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

Varsayılan pyodbc sürücü kullanan veritabanı aliasları ayrı olarak kurulmuş bir ODBC sürücüsü gerektirir ve kurulum adımları işletim sistemine göre değişir. Kullanan mssql-python takma adlar bu adımlara ihtiyaç duymaz. Bunun yerine, macOS'ta OpenSSL ve Linux'ta gerekli kütüphaneler dahil olmak üzere mssql-python için platform ön koşullarını yükleyin.

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 varsayılan ODBC veritabanı sürücüsü
mssql-python İsteğe bağlı Python veritabanı sürücüsü, her durumda yüklenir
tzdata Standart kütüphane zoneinfo modülü için IANA saat dilimi veritabanı

Arka uç, standart kütüphane zoneinfo modülünü kullanarak zaman dilimine duyarlı datetime değerleri dönüştürür. zoneinfo mevcut olduğunda işletim sisteminin IANA saat dilimi veritabanını okur; aksi takdirde Windows'u ve minimal kapsayıcı imajlarını kapsayan tzdata paketini kullanır. pytz artık bağımlılık değil.

İlgili içerik

  • Son güncelleştirme: