Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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 2.0, mevcut genel erişilebilirlik (GA) sürümüdür.
Important
Sürüm 2.0, veritabanı aliası pyodbckullansa bile 1.15.0 veya daha yeni sürümleri gerektirirmssql-python. 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.
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 |
|---|---|---|---|---|
| 2.0 | Eylül 2026 | Şu anki | 5.2 - 6.1 | Etkinleştirilebilir mssql-python sürücüsü, Python 3.10 - 3.14, zoneinfo, pytz yerine geçer, MARS ve inspectdb düzeltmeleri |
| 1.8.0 | Ağustos 2026 | Previous | 3.2 - 6.1 | Django 6.1 desteği, quote_name sorgu derleyici değişikliği, yabancı anahtar içörnemesi ON DELETE kuralını döndürüyor |
| 1.7.4 | Temmuz 2026 | Previous | 3.2 - 6.0 |
GROUP BY gerçek parametreli escape edilmiş %% sabitleri ve ham sorgulardaki IntegerChoices parametreleri için düzeltmeler |
| 1.7.3 | Haziran 2026 | Previous | 3.2 - 6.0 |
FA001
Authentication= dışındaki modlar için düzeltme, alt sınıf ActiveDirectoryMsiDatabaseWrapper 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.
mssql-django 2.0 aşağıdaki kombinasyonları test eder:
| Django sürümü | Python sürümleri |
|---|---|
| 6.1 | 3.12, 3.13, 3.14 |
| 6.0 | 3.12, 3.13, 3.14 |
| 5.2 | 3.10, 3.11, 3.12, 3.13 |
Django 3.2'den 5.1'e ve Python 3.8 ile 3.9 desteğinin sonuna ulaştı ve test edilmedi. Bu sürümlerdeki projeler 1.8.0 sürümünde kalıyor mssql-django .
Important
Her zaman desteklenen bir Python sürümü kullanın. Eski Python sürümleri güvenlik güncelleştirmelerini almaz.
SQL Server ve Azure SQL uyumluluğu
mssql-django2.0, desteklenen tüm Microsoft SQL sürümlerini destekler. Backend'in tanımadığı yeni bir SQL Server büyük sürümü, versiyon doğrulamasında başarısız olmak yerine backend'in bildiği en son yetenek setini kullanarak bağlanır.
| Ürün veya hizmet | Destek durumu |
|---|---|
| SQL Server | Tamamen desteklenir |
| Azure Sanal Makineleri Üzerinde SQL Server | Tamamen desteklenir |
| Azure SQL Veritabanı | Tamamen desteklenir |
| Azure SQL Yönetilen Varlık | Tamamen desteklenir |
| Fabric'de SQL veritabanı | Tamamen desteklenir |
| Microsoft Fabric Warehouse | Sadece bağlantılar.
pyodbc yolunda, extra_params içinde MARS_Connection=no değerini ayarlayın. Django göçleri ve diğer SQL Server özellikleri desteklenmiyor. |
| Azure Synapse Analytics | Sadece bağlantılar. Django göçleri ve diğer SQL Server özellikleri desteklenmiyor. |
Veritabanı sürücüsü uyumluluğu
mssql-django2.0, her veritabanı takma adı için seçilen iki Python veritabanı sürücüsünden biri üzerinden bağlanır. Daha fazla bilgi için, mssql-django için veritabanı sürücüsünü seç sayfasına bakınız.
| Python sürücüsü | Destek durumu | Connectivity |
|---|---|---|
pyodbc |
Tam olarak desteklenir (varsayılan) | SQL Server için Microsoft ODBC Driver 17 veya 18, ayrı olarak yüklenmiş |
mssql-python |
Tam olarak desteklenir (python_driver seçeneğini etkinleştirerek) |
Yerleşik, ayrı bir kurulum gerektirmez |
ODBC sürücüsü uyumluluğu
pyodbc yolunda, arka uç varsayılan olarak SQL Server için ODBC Driver 18'i kullanır ve 18. sürüm yüklü değilse otomatik olarak ODBC Driver 17'yi kullanır. Veritabanı yapılandırmanızdaki seçenekle varsayılanı driver geçersiz kılın. Açık bir değer geri düşmez.
| 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ü |
pyodbc yolunda desteklenir |
mssql-python yolu, driver seçeneğini yok sayar.
Yükleme yönergeleri için bkz. SQL Server için ODBC Sürücüsünü İndirme.
İşletim sistemi uyumluluğu
mssql-django 2.0, mssql-python gerektirir; bu nedenle paket yalnızca uyumlu bir mssql-python dağıtımı varsa kurulur. Bu gereklilik, her veritabanı takma adında pyodbckullanılsa bile geçerlidir.
| İşletim Sistemi | Architecture | Destek durumu |
|---|---|---|
| Windows 11, Windows Server 2019, 2022 ve 2025 | x64 | Destekleniyor |
| Windows 11, Windows Server 2022 ve 2025 | ARM64 | Python 3.11 ve daha sonraki sürümlerle destekleniyor |
| macOS 15 ve daha sonraki sürümler | Intel, Apple silikon | Destekleniyor |
| Glibc 2.28 veya daha yeni Linux sürümleri, örneğin Ubuntu 22.04 ve 24.04, Debian 11 ve 12 ile Red Hat Enterprise Linux 8 ve 9 | x64, ARM64 | Destekleniyor |
| musl 1.2 veya sonraki bir sürümünü kullanan Linux dağıtımları, örneğin Alpine Linux | x64, ARM64 | Destekleniyor |
| SUSE Linux Enterprise Server | ARM64 | Desteklenmiyor |
Desteklenmeyen bir platformdaki mssql-django projeler ise 1.8.0 sürümünde kalır, bu da mssql-pythonzorunlu değildir.
pyodbc yolunda, Microsoft ODBC Driver for SQL Server'ı ayrı yükleyin. Kurulum adımları işletim sistemine göre değişir. Platforma özgü kurulum için bkz . mssql-django'yu yükleme .
Ö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 |
Yes |
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 yolunda. Arka uç, takma ad Windows'ta bir Microsoft ODBC sürücüsü kullandığında MARS'ı etkinleştirir. Yol mssql-python MARS'ı asla etkinleştirmez ve anahtar kelimeyi MARS_Connection reddeder. |
| 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 | >=5.2,<6.2 |
pyodbc |
Python için varsayılan ODBC veritabanı sürücüsü | >=3.0 |
mssql-python |
Python veritabanı sürücüsü. Koşulsuz olarak yüklenir ve yalnızca bir takma ad bunu etkinleştirdiğinde kullanılır. | >=1.15.0 |
tzdata |
Standart kütüphane zoneinfo modülü için IANA saat dilimi veritabanı, işletim sistemi sağlamadığı durumlarda kullanılır |
Any |
Yol pyodbc ayrıca ana sistemde SQL Server için Microsoft ODBC Sürücüsü gerektirir.
mssql-python yolunun ayrı bir ODBC sürücüsü kurulumu yoktur. 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
- Ana sürümler (2.0): Desteklenen Python, Django, SQL Server ve platform matrisini değiştirebilir ve bağımlılıkları ekleyebilir veya kaldırabilir. Bozucu değişiklikler sadece büyük bir versiyonda görülür.
- İ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, 1.7.4): Sadece hata düzeltmeleri içerir.
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
- Yayın bildirimleri için GitHub deposunu izleyin.
- Yeni sürümler için PyPI'ye bakın.
- Her sürüm için değişiklik günlüğü'ne bakın.
Destek alın
Microsoft, GitHub ve topluluk kanalları aracılığıyla desteklermssql-django.
GitHub Sorunları
hataları bildirin ve GitHub özellikleri isteyin:
Bir sorunu bildirdiğinizde, Django sürümünü, Python sürümünüzü, SQL Server sürümünüzü, Python veritabanı sürücüsünü ve onun sürümünü ve sorunun minimum bir tekrarı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
- Stack Overflow: Soruları
djangovesql-serverile etiketleyin. - Django belgeleri
- Azure Python Geliştirici Merkezi