mssql-django desteği ve yaşam döngüsü

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. GitHub etkin bir şekilde korunur vePyPI aracılığıyla yayınlanır. Bu sayfa sürüm oluşturma, platform uyumluluğu ve destek ilkesini kapsar.

Sürüm desteği

Yeni özellikler, performans iyileştirmeleri ve güvenlik düzeltmeleri kazanmak için her zaman en son sürümü kullanın. Yeni özellikler yalnızca geçerli sürüme eklenir.

Güncel sürüm

Sürüm 1.7.3, geçerli genel kullanılabilirlik (GA) sürümüdür.

Destek durumu tanımları

Sürüm tablosunda şu durum değerlerini kullanın:

Statü Meaning
Şu anki Yeni özellikler, hata düzeltmeleri ve güvenlik düzeltmeleri alır.
Önceki Eski sürüm. Kullanılabilir durumda kalır ancak güncelleştirmeleri almaz.

Sürüm geçmişi

Version Yayınlanma tarihi Statü Django sürümleri Temel özellikler
1.7.3 Haziran 2026 Şu anki 3.2 - 6.0 FA001 ActiveDirectoryMsi dışındaki modlar için düzeltme, alt sınıf DatabaseWrapperKeyError düzeltmesi (1.7.1'den kaynaklanan gerileme)
1.7.2 Mayıs 2026 Previous 3.2 - 6.0 datetimeoffset saat dilimi düzeltmesi, Now() saat dilimi düzeltmesi, .explain() uyumluluk düzeltmesi
1.7.1 Nisan 2026 Previous 3.2 - 6.0 Fabric'teki SQL veritabanı düzeltmesi, azalan sıralı dizin AlterField düzeltmesi
1.7 Mart 2026 Previous 3.2 - 6.0 Django 6.0 desteği, ODBC Sürücüsü 18 varsayılan, SQL Server 2025 desteği
1.6 Ağustos 2025 Previous 3.2 - 5.2 Django 5.1 ve 5.2 desteği, geliştirilmiş JSON işlevselliği
1.5 Nisan 2024 Previous 3.2 - 5.0 supports_comments bayrak, AutoField düzeltmeler
1.4 Ocak 2024 Previous 3.2 - 5.0 Django 5.0 desteği, db_comment destek
1.3 Mayıs 2023 Previous 3.2 - 4.2 Django 4.2 desteği, büyük/küçük harfe duyarlı Replace
1.2 Aralık 2022 Previous 3.2 - 4.1 Django 4.1 desteği, saat dilimi desteği, Azure SQL Yönetilen Örneği üzerinde JSONField
1.1 Temmuz 2022 Previous 3.2 - 4.0 Django 3.2 ve 4.0 desteğiyle ilk sürüm

1.1 öncesi sürümler yayın öncesi sürümlerdi ve listelenmemişti.

Important

Düzeltmeler ve yeni özellikler yalnızca yeni sürümlerde gönderilir. Eski sürümler PyPI'de kullanılabilir durumda kalır ancak yerinde düzeltme eki uygulamaz. Hata düzeltmeleri veya güvenlik düzeltmeleri almak için en son sürüme yükseltin.

Ayrıntılı sürüm notları için bkz . mssql-django'daki yenilikler.

Django ve Python sürüm uyumluluğu

Her Django sürümü belirli Python sürümlerini destekler. Sürümlerinizi seçerken Django, Python ve mssql-djangoarasında uyumluluğu sağlayın:

Django sürümü Python sürümleri
6.0 3.12, 3.13, 3.14
5.2 3.10, 3.11, 3.12, 3.13
5.1 3.10, 3.11, 3.12, 3.13
5.0 3.10, 3.11, 3.12
4.2 3.8, 3.9, 3.10, 3.11, 3.12
4.1 3.8, 3.9, 3.10, 3.11
4,0 3.8, 3.9, 3.10
3.2 3.8, 3.9, 3.10

Important

Her zaman desteklenen bir Python sürümü kullanın. Eski Python sürümleri güvenlik güncelleştirmelerini almaz.

SQL Server sürüm uyumluluğu

mssql-django arka uç, SQL Server’ın desteklenen tüm sürümleriyle çalışır.

Azure SQL hizmetleri

Hizmet Destek durumu
Azure SQL Veritabanı Tamamen desteklenir
Azure SQL Yönetilen Varlık Tamamen desteklenir

Microsoft Fabric

Bitiş noktası Destek durumu
Fabric'de SQL veritabanı Tamamen desteklenir

ODBC sürücüsü uyumluluğu

mssql-django Arka uç, Doğrudan Veritabanı Bağlantısı (DDBC) kullanan sürücüden mssql-python farklı olarak bir dış ODBC sürücüsü gerektirir.

1.7 itibarıyla mssql-django arka uç, SQL Server için varsayılan olarak ODBC Sürücüsü 18'e geçer ve sürüm 18 yüklü değilse otomatik olarak ODBC Sürücüsü 17'ye geri döner. Veritabanı yapılandırmanızda driver seçeneğini belirterek bunu geçersiz kılabilirsiniz.

ODBC sürücüsü Destek durumu
SQL Server için Microsoft ODBC Sürücüsü 18 Tam olarak desteklenir (varsayılan)
SQL Server için Microsoft ODBC Sürücüsü 17 Tam olarak desteklenir (geri dönüş)
FreeTDS ODBC sürücüsü Destekleniyor

Yükleme yönergeleri için bkz. SQL Server için ODBC Sürücüsünü İndirme.

İşletim sistemi uyumluluğu

mssql-django Arka uç, Python ve ODBC sürücüsünün desteklendiği her yerde çalışır. ODBC sürücüsü yükleme adımları işletim sistemine göre farklılık gösterir. Platforma özgü kurulum için bkz . mssql-django'yu yükleme .

İşletim Sistemi Architecture Destek durumu
Windows 11 x64, ARM64 Destekleniyor
Windows Server 2019, 2022, 2025 x64 Destekleniyor
Ubuntu 22.04, 24.04 x64, ARM64 Destekleniyor
Debian 11, 12 x64, ARM64 Destekleniyor
Red Hat Enterprise Linux 8, 9 x64, ARM64 Destekleniyor
macOS 14, 15 Intel, Apple Silicon (ARM64) Destekleniyor
Alpine Linux x64 Desteklenir (glibc uyumluluk katmanı veya FreeTDS gerektirir)

Özellik uyumluluğu

Aşağıdaki tablolarda Django ve SQL Server özellikleri ve arka uçtaki mssql-django destek durumları listelenmiştir. Desteklenmeyen özellikler hakkında daha fazla bilgi için bkz. mssql-django'da sınırlamalar ve desteklenmeyen özellikler.

Django ORM özellikleri

Feature mssql-django desteği
Migrations Yes
QuerySet API (Uygulama Programlama Arayüzü) Yes
JSONField Evet (SQL Server 2016+)
bulk_create / bulk_update Yes
Veritabanı işlemleri Yes
inspectdb ile --schema Yes
DISTINCT ON Hayı
__regex / __iregex Aramalar Kısmi (CLR derleme kurulumu gerektirir; Azure SQL Veritabanı kullanılamaz)
SmallAutoField Yes
select_for_update() Evet (NOWAIT ve SKIP_LOCKED; of desteklenmez)
Pencere işlevleri Yes
GeneratedField (hesaplanan sütunlar) Evet (Django 5.0 ve üzeri)
CompositePrimaryKey Kısmi (Django 5.2 ve üzeri; sınırlamalara bakın)
db_comment Evet (Django 4.2 ve üzeri)
Kapsayıcı dizinler (include) Evet (Django 4.2 ve üzeri)
NthValue Hayı

SQL Server özellikleri

Feature mssql-django desteği
Şifrelenmiş bağlantılar (TLS) Yes
Always Encrypted (Her Zaman Şifreli) Yes
Microsoft Entra kimlik doğrulama Yes
Birden Çok Etkin Sonuç Kümesi (MARS) Evet (pyodbc üzerinden)
Saklanan prosedürler Evet (cursor.execute üzerinden)
SNAPSHOT İzolasyon Evet (veritabanı düzeyinde yapılandırma gerektirir)
Salt okunur yönlendirme Yes

Bağımlılık gereksinimleri

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

Bağımlılık Purpose Gerekli sürüm
Django Web çerçevesi >= 3.2
pyodbc Python için ODBC veritabanı sürücüsü >= 3.0
pytz Saat dilimi desteği (eski; modern Django, USE_TZ=True ile birlikte yerleşik zoneinfo kullanır) Any

mssql-django arka uç ayrıca ana sistemde SQL Server için Microsoft ODBC Sürücüsünün kurulu olmasını gerektirir. Daha fazla bilgi için bkz . mssql-django'yu yükleme.

Sürümlendirme ve geriye dönük uyumluluğu bozan değişiklikler ilkesi

  • İkincil sürümler (1.6, 1.7): Yeni Django sürüm desteği, yeni özellikler ve hata düzeltmeleri ekleyin. Geriye dönük uyumluluğu koruyun.
  • Yama sürümleri (1.7.1, 1.7.2, 1.7.3): Yalnızca hata düzeltmelerini ekleyin.

Ekip, sürüm notlarında hataya neden olan değişiklikleri belgelemektedir. Sürüme özgü notlar için mssql-django'daki yenilikler bölümüne göz atın.

Güncel kalma

mssql-django Arka uç, Django sürümlerini takip etmek için yeni sürümler yayımlar. Django'yu yükseltirken güncelleştirmeleri denetleyin.

Yüklü sürümü denetleme

Şu anda hangi sürümün yüklü olduğunu doğrulayın:

pip show mssql-django

En son sürüme yükseltme

En son sürüme güncelleştirin:

pip install --upgrade mssql-django

Güncelleştirmelere abone olma

Destek alın

Microsoft, GitHub ve topluluk kanalları aracılığıyla desteklermssql-django.

GitHub Sorunları

hataları bildirin ve GitHub özellikleri isteyin:

Bir sorun bildirirken Django sürümünüzü, Python sürümünüzü, SQL Server sürümünüzü, ODBC sürücü sürümünüzü ve sorunun en düşük çoğaltmasını ekleyin.

Contribute

Topluluk katkıları kabul edilir. Katkıda Bulunan Lisans Sözleşmesi (CLA) ve gönderim süreci hakkında daha fazla bilgi için katkıda bulunma kılavuzuna bakın.

Community

İlgili içerik

  • Last updated on