Siklus hidup dukungan untuk mssql-python

Driver mssql-python adalah driver Python resmi Microsoft untuk SQL Server, Azure SQL Database, Azure SQL Managed Instance, dan database SQL di Microsoft Fabric. Driver secara aktif dikelola di GitHub dan dirilis melalui PyPI. Artikel ini membahas penerapan versi, kompatibilitas platform, dan linimasa dukungan.

Dukungan versi

Selalu gunakan rilis terbaru untuk mendapatkan fitur baru, peningkatan performa, dan perbaikan keamanan. Kemampuan baru hanya ditambahkan ke rilis saat ini.

Versi saat ini

Versi 1.11.0 adalah rilis ketersediaan umum (GA) saat ini.

Riwayat versi

Versi Tanggal rilis Status Fitur utama
1.11.0 Juli 2026 Saat ini Penerapan / rollback pengelola konteks, perbaikan Apple Silicon, perbaikan salinan massal perkadaan layanan
1.10.0 Juni 2026 Previous Penyalinan massal dengan ActiveDirectoryServicePrincipal, perbaikan pada Arrow VARCHAR
1.9.0 Juni 2026 Previous Penyalinan massal dengan objek baris, penentuan tipe parameter NULL yang ditingkatkan
1.8.0 Mei 2026 Previous Penyalinan massal dengan ActiveDirectoryMSI, pengindeksan kunci string pada baris
1.7.1 Mei 2026 Previous RHEL 8 wheel, dukungan konkurensi yang lebih luas, dan perbaikan Unicode
1.6.0 April 2026 Previous Pembersihan string koneksi berbasis parser, perbaikan konkurensi pada penyambungan/pemutusan koneksi
1.5.0 April 2026 Previous Pengambilan panah, sql_variant, UUID asli
1.4.0 Februari 2025 Previous Dukungan untuk salin massal (BCP)
1.3.0 Januari 2025 Previous Kelas pengaturan, konfigurasi modul
1.2.0 Nopember 2024 Previous Metode penemuan skema
1.1.0 September 2024 Previous Konverter keluaran khusus
1.0.0 Juli 2024 Previous Rilis GA awal

Penting

Hanya versi saat ini (1.11.0) yang menerima fitur baru dan perbaikan bug. Versi sebelumnya tetap berfungsi tetapi tidak menerima pembaruan. Tingkatkan ke versi terbaru untuk pengalaman terbaik.

kompatibilitas versi Python

Driver mssql-python memerlukan Python 3.10 atau yang lebih baru. Jika Anda memulai proyek baru, targetkan rilis Python terbaru yang didukung di matriks kompatibilitas untuk jendela dukungan terpanjang. Jika Anda dibatasi ke versi Python yang lebih lama (3.9 atau lebih lama), gunakan pyodbc sebagai gantinya.

Versi Python Status dukungan
Python 3.14 Dukungan
Python 3.13 Dukungan
Python 3.12 Dukungan
Python 3.11 Dukungan
Python 3.10 Didukung (minimal)
Python 3.9 dan sebelumnya Tidak didukung

Penting

Selalu gunakan versi Python yang didukung. Versi Python yang lebih lama tidak menerima pembaruan keamanan.

kompatibilitas versi SQL Server

Driver mssql-python menggunakan protokol TDS dan bekerja dengan semua versi SQL Server yang didukung secara aktif.

Versi SQL Server Status dukungan
Semua versi Microsoft SQL Server yang didukung Didukung sepenuhnya

Layanan Azure SQL

Service Status dukungan
Azure SQL Database Didukung sepenuhnya
Azure SQL Managed Instance Didukung sepenuhnya
Azure Synapse Analytics (pool khusus) Dukungan

Microsoft Fabric

Titik Akhir Status dukungan
Basis data SQL dalam Fabric Didukung sepenuhnya
Fabric Data Warehouse Dukungan
Titik akhir analitik SQL (Lakehouse) Dukungan
Titik akhir analitik SQL (database cermin) Dukungan

Kompatibilitas sistem operasi

Driver mssql-python menggunakan DDBC (Direct Database Connectivity) dan tidak memerlukan Driver Microsoft ODBC untuk diinstal. Menghapus dependensi eksternal menyederhanakan penyebaran, terutama dalam kontainer dan alur CI/CD.

Sistem operasi Architecture Status dukungan
Windows 11 x64, ARM64 Dukungan
Server Windows 2019, 2022, 2025 x64 Dukungan
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Dukungan
Debian 11, 12 x64, ARM64 Dukungan
Red Hat Enterprise Linux 8, 9 x64, ARM64 Dukungan
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Dukungan
Alpine Linux x64 Dukungan

Kompatibilitas fitur

Tabel berikut mencantumkan fitur SQL Server dan status dukungannya dalam versi saat ini (1.11.0) dari driver mssql-python. Jika fitur yang Anda butuhkan tidak didukung (seperti Selalu Terenkripsi atau MARS), pertimbangkan untuk menggunakan pyodbc sebagai gantinya. Untuk informasi tentang fitur yang ditambahkan di versi sebelumnya, lihat Apa yang baru di mssql-python.

fitur SQL Server

Feature Dukungan mssql-python
Koneksi terenkripsi (TLS) Dukungan
Selalu Terenkripsi Tidak didukung
Microsoft Entra otentikasi Dukungan
Beberapa Set Hasil Aktif (MARS) Tidak didukung
Salinan massal (BCP) Dukungan
Pengambilan Panah Apache Dukungan
sql_variant kolom Dukungan
UUID bawaan Dukungan
Ketahanan koneksi Dukungan
Perutean baca-saja Dukungan

Kepatuhan terhadap DB-API 2.0

Feature Support
Antarmuka modul Sesuai
Antarmuka koneksi Sesuai
Antarmuka kursor Sebagian besar sesuai
Jenis objek Sesuai
Pengecualian Sesuai
callproc() Tidak diimplementasikan

Note

Metode callproc() ini belum diimplementasikan. Panggil prosedur tersimpan dengan menggunakan EXECUTE pernyataan dengan metode kueri standar.

Persyaratan dependensi

Driver mssql-python memiliki dependensi minimal:

Ketergantungan Kegunaan Versi
azure-identity Microsoft Entra ID otentikasi Wajib (>= 1.12.0)

Driver mssql-python tidak memerlukan penginstalan Driver Microsoft ODBC.

Migrasi dari pyodbc

Driver mssql-python menyederhanakan penyebaran (tidak diperlukan driver ODBC) dan menyediakan pengumpulan koneksi bawaan. Perbedaan utama yang harus direncanakan saat bermigrasi:

Consideration Catatan
Gaya parameter pyodbc menggunakan parameter posisional qmark. mssql-python secara default menggunakan parameter bernama pyformat dan juga mendukung qmark untuk kompatibilitas.
Akses baris Akses atribut didukung di keduanya.
Prosedur yang disimpan Gunakan EXECUTE (bukan callproc).
Pemanfaatan koneksi Pengumpulan bawaan di driver mssql-python.

Lihat Bermigrasi dari pyodbc untuk panduan mendetail.

Migrasi dari pymssql

Driver pymssql tidak lagi dipelihara secara aktif. Driver mssql-python menawarkan alternatif yang didukung dengan sintaks koneksi yang serupa, namun dilengkapi fitur modern seperti pooling koneksi bawaan dan autentikasi Microsoft Entra.

Consideration Catatan
Dependensi FreeTDS Tidak diperlukan. Driver mssql-python menggunakan DDBC.
Parameter koneksi Gaya serupa, tetapi nama parameter berbeda.
Akses baris Keduanya mendukung pola akses gaya kamus dan pola akses atribut.
Prosedur yang disimpan Gunakan EXECUTE (bukan callproc).

Lihat Bermigrasi dari pymssql untuk panduan terperinci.

Melanggar kebijakan perubahan

  • Versi utama (2.0, 3.0): Perubahan versi utama menandakan perubahan API yang merusak.
  • Versi minor (1.4, 1.5): Menyertakan fitur baru dan mempertahankan kompatibilitas mundur.
  • Versi patch (1.4.1, 1.4.2): Menyertakan perbaikan bug saja.

Tim mendokumentasikan perubahan yang melanggar dalam catatan rilis dan menyediakan panduan migrasi.

Cara tetap terkini

Driver mssql-python sering merilis versi minor. Periksa pembaruan secara berkala, terutama sebelum deploy ke produksi.

Periksa versi yang terinstal

Verifikasi versi driver mana yang saat ini diinstal di lingkungan Anda:

import mssql_python
print(mssql_python.__version__)

Tingkatkan ke versi terbaru

Perbarui ke rilis terbaru untuk mendapatkan fitur terbaru dan perbaikan keamanan.

pip install --upgrade mssql-python

Berlangganan pembaruan

  • Pantau repositori GitHub tersebut.
  • Periksa PyPI untuk rilis baru.
  • Tinjau log perubahan untuk setiap rilis.

Mendapatkan dukungan

Masalah GitHub

Laporkan bug dan fitur permintaan di GitHub:

Documentation

Community

  • Stack Overflow: Tandai pertanyaan dengan mssql-python.
  • Diskusi GitHub: Gunakan untuk pertanyaan dan diskusi umum.

Konten terkait

  • Last updated on