mssql-python için destek yaşam döngüsü

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-python ile etiketleyin.
  • GitHub Tartışmaları: Genel sorular ve tartışmalar için kullanılır.