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-python sürücüsü, Microsoft'un SQL Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği ve SQL veritabanı için resmi Python sürücüsüdür Microsoft Fabric. Sürücü GitHub'da aktif olarak tutulmakta ve PyPI üzerinden yayımlanmaktadır. Bu makale sürüm düzenleme, platform uyumluluğu ve destek zaman çizelgelerini ele alır.
Sürüm desteği
Yeni özellikler, performans iyileştirmeleri ve güvenlik düzeltmeleri 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.11.0, mevcut genel erişilebilirlik (GA) sürümüdür.
Sürüm geçmişi
| Sürüm | Yayınlanma tarihi | Statü | Temel özellikler |
|---|---|---|---|
| 1.11.0 | Temmuz 2026 | Şu anki | Bağlam yöneticisi işleme alma/geri alma, Apple Silicon düzeltmesi, hizmet sorumlusu toplu kopyalama düzeltmesi |
| 1.10.0 | Haziran 2026 | Previous | ActiveDirectoryServicePrincipal için toplu kopyalama ve Arrow VARCHAR düzeltmeleri |
| 1.9.0 | Haziran 2026 | Previous | Row nesneleriyle toplu kopyalama, geliştirilmiş NULL parametre tiplemesi |
| 1.8.0 | Mayıs 2026 | Previous | ActiveDirectoryMSI ile toplu kopyalama, Sıra dizisi anahtarı indeksleme |
| 1.7.1 | Mayıs 2026 | Previous | RHEL 8 tekerlekleri, daha geniş eşzamanlı çalışma ve Unicode düzeltmeleri |
| 1.6.0 | Nisan 2026 | Previous | Ayrıştırıcı tabanlı bağlantı dizesi temizleme, bağlanma/bağlantıyı kesme eşzamanlılık düzeltmeleri |
| 1.5.0 | Nisan 2026 | Previous | Ok getirme, sql_variant, yerel UUID |
| 1.4.0 | Şubat 2025 | Previous | Toplu kopya desteği (BCP) |
| 1.3.0 | Ocak 2025 | Previous | Ayarlar sınıfı, modül yapılandırması |
| 1.2.0 | Kasım 2024 | Previous | Şema keşif yöntemleri |
| 1.1.0 | Eylül 2024 | Previous | Özel çıkış dönüştürücüleri |
| 1.0.0 | Temmuz 2024 | Previous | İlk GA sürümü |
Important
Sadece mevcut sürüm (1.11.0) yeni özellikler ve hata düzeltmeleri alıyor. Önceki sürümler işlevsel olmaya devam ediyor ama güncelleme almıyor. En iyi deneyim için en son sürüme yükseltin.
Python sürüm uyumluluğu
mssql-python sürücüsü için Python 3.10 veya daha yeni bir model gereklidir. Yeni bir projeye başlıyorsanız, en uzun destek penceresi için uyumluluk matrisinde en yeni desteklenen Python sürümünü hedefleyin. Eğer daha eski bir Python sürümüne (3.9 veya daha öncesi) kısıtlıysanız, onun yerine pyodbc kullanın.
| Python sürümü | Destek durumu |
|---|---|
| Python 3.14 | Destekleniyor |
| Python 3.13 | Destekleniyor |
| Python 3.12 | Destekleniyor |
| Python 3.11 | Destekleniyor |
| Python 3.10 | Desteklenen (en az) |
| Python 3.9 ve daha eski sürümler | Desteklenmiyor |
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-python sürücüsü TDS protokolünü kullanır ve aktif olarak desteklenen tüm SQL Server sürümleriyle çalışır.
| SQL Server sürümü | Destek durumu |
|---|---|
| Microsoft SQL Server'ın desteklenen tüm sürümleri | Tamamen desteklenir |
Azure SQL hizmetleri
| Service | Destek durumu |
|---|---|
| Azure SQL Veritabanı | Tamamen desteklenir |
| Azure SQL Yönetilen Varlık | Tamamen desteklenir |
| Azure Synapse Analytics (dedicated pools) | Destekleniyor |
Microsoft Fabric
| Bitiş noktası | Destek durumu |
|---|---|
| Fabric'de SQL veritabanı | Tamamen desteklenir |
| Fabric Veri Ambarı | Destekleniyor |
| SQL analiz uç noktası (Lakehouse) | Destekleniyor |
| SQL analiz uç noktası (yansıtılmış veritabanı) | Destekleniyor |
İşletim sistemi uyumluluğu
mssql-python sürücüsü DDBC (Doğrudan Veritabanı Bağlantısı) kullanır ve Microsoft ODBC Sürücüsü'nün kurulmasını gerektirmez. Harici bağımlılığın kaldırılması, özellikle konteynerlerde ve CI/CD boru hatlarında dağıtımı basitleştirir.
| İşletim Sistemi | Architecture | Destek durumu |
|---|---|---|
| Windows 11 | x64, ARM64 | Destekleniyor |
| Windows Server 2019, 2022, 2025 | x64 | Destekleniyor |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Destekleniyor |
| Debian 11, 12 | x64, ARM64 | Destekleniyor |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Destekleniyor |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Destekleniyor |
| Alpine Linux | x64 | Destekleniyor |
Özellik uyumluluğu
Aşağıdaki tablolar, mssql-python sürücüsünün mevcut sürümünde (1.11.0) SQL Server özelliklerini ve destek durumunu listeler. İhtiyacınız olan bir özellik desteklenmiyorsa (örneğin Always Encrypted veya MARS), pyodbc kullanmayı düşünün. Önceki sürümlerde eklenen özellikler hakkında bilgi için mssql-python'da yenilikler neler var?
SQL Server özellikleri
| Özellik | mssql-python desteği |
|---|---|
| Şifrelenmiş bağlantılar (TLS) | Destekleniyor |
| Always Encrypted (Her Zaman Şifreli) | Desteklenmiyor |
| Microsoft Entra kimlik doğrulama | Destekleniyor |
| Birden Çok Etkin Sonuç Kümesi (MARS) | Desteklenmiyor |
| Toplu kopyalama (BCP) | Destekleniyor |
| Apache Arrow'ı getir | Destekleniyor |
| sql_variant sütunları | Destekleniyor |
| Native UUID | Destekleniyor |
| Bağlantı dayanıklılığı | Destekleniyor |
| Salt okunur yönlendirme | Destekleniyor |
DB-API 2.0 uyumu
| Özellik | Support |
|---|---|
| Modül arayüzü | Compliant |
| Bağlantı arayüzü | Compliant |
| İmleç arayüzü | Çoğunlukla uyumlu |
| Tip nesneleri | Compliant |
| İstisnalar | Compliant |
callproc() |
Uygulanmadı |
Note
Yöntem callproc() uygulanmamış. Standart sorgu yöntemleriyle EXECUTE ifadelerini kullanarak saklı yordamları çağırın.
Bağımlılık gereksinimleri
mssql-python sürücüsünün minimum bağımlılıkları vardır:
| Bağımlılık | Purpose | Sürüm |
|---|---|---|
| azure-identity | Microsoft Entra Id kimlik doğrulaması | Gerekli (>= 1.12.0) |
mssql-python sürücüsü Microsoft ODBC Sürücüsü kurulumu gerektirmez.
pyodbc'den geçiş
mssql-python sürücüsü, dağıtımı basitleştirir (ODBC sürücüsü gerekmez) ve yerleşik bağlantı havuzu sağlar. Göç ederken planlamanız gereken temel farklar:
| Consideration | Notlar |
|---|---|
| Parametre stili | PyoDBC konumsal parametreler kullanır qmark . MSSQL-Python varsayılan olarak adlandırılmış pyformat parametreleri kullanır ve uyumluluk için de destekler qmark . |
| Satır erişimi | Her ikisinde de öznitelik erişimi desteklenmektedir. |
| Saklanan prosedürler |
callproc değil, EXECUTE kullanın. |
| Bağlantı havuzlama | mssql-python sürücüsünde yerleşik havuzlama var. |
Ayrıntılı yönergeler için pyodbc'den geçiş bölümüne bakın.
pymssql’den geçiş
pymssql sürücüsü artık aktif olarak geliştirilmemektedir. mssql-python sürücüsü, benzer bağlantı sözdizimi ile desteklenen bir alternatif sunuyor ancak yerleşik bağlantı havuzu ve Microsoft Entra doğrulama gibi modern özelliklere sahip.
| Consideration | Notlar |
|---|---|
| FreeTDS bağımlılığı | Gerekli değil. mssql-python sürücüsü DDBC kullanır. |
| Bağlantı parametreleri | Benzer tarz ama farklı parametre isimleri. |
| Satır erişimi | Her ikisi de sözlük tarzı ve öznitelik erişim kalıplarını destekler. |
| Saklanan prosedürler |
EXECUTE kullanın (callproc değil). |
Detaylı rehberlik için Migrationate from pymssql sayfasına bakınız.
Uyumluluğu bozan değişiklikler politikası
- Büyük sürümler (2.0, 3.0): Büyük sürüm değişiklikleri, API değişikliklerinin bozulduğunu gösterir.
- Küçük sürümler (1.4, 1.5): Yeni özellikler ekleyin ve geriye dönük uyumluluğu korursunuz.
- Yama sürümleri (1.4.1, 1.4.2): Sadece hata düzeltmeleri içerir.
Ekip, geriye dönük uyumluluğu bozan değişiklikleri sürüm notlarında belgelendirir ve geçiş kılavuzları sunar.
Güncel kalma
mssql-python sürücüsü sık sık küçük sürümler çıkarır. Güncellemeleri düzenli olarak kontrol edin, özellikle üretim dağıtımlarından önce.
Yüklü sürümü denetleme
Hangi sürücü sürümünün şu anda ortamınızda kurulu olduğunu doğrulayın:
import mssql_python
print(mssql_python.__version__)
En son sürüme yükseltme
En son sürüme güncelleme yapın, en yeni özellikleri ve güvenlik düzeltmelerini edin.
pip install --upgrade mssql-python
Güncelleştirmelere abone olma
- GitHub deposunu izleyin.
- Yeni sürümler için PyPI'yi kontrol et.
- Her sürüm için değişiklik günlüğünü gözden geçirin.
Destek alma
GitHub Sorunları
hataları bildirin ve GitHub özellikleri isteyin:
Documentation
Community
- Stack Overflow: Soruları
mssql-pythonile etiketleyin. - GitHub Tartışmaları: Genel sorular ve tartışmalar için kullanılır.