Apa yang baru di mssql-python

Artikel ini mencantumkan apa saja yang berubah di setiap rilis driver mssql-python, yang terbaru duluan. Setiap bagian membahas fitur baru, perubahan perilaku, dan perbaikan bug untuk satu versi.

Untuk versi yang saat ini didukung Microsoft, lihat Siklus hidup Dukungan.

mssql-python 1.18.0

Tanggal rilis: 18 November 2026

Enhancements

Nama aplikasi kustom

Atur APP atau Application Name di string koneksi Anda untuk mengidentifikasi beban kerja Anda dalam pemantauan sisi server. Misalnya, APP=orders-api muncul sebagai MSSQL-Python|orders-api dalam APP_NAME() dan sys.dm_exec_sessions.program_name. Koneksi sinkron, jalur async native eksperimental, dan salinan massal semuanya mengirim nama yang sama.

Nama defaultnya adalah MSSQL-Python. Sebelum versi ini, jalur asinkron dan salinan massal native mengirim mssql-python. Jika filter pemantauan cocok persis dengan mssql-python, perbarui filter tersebut.

Untuk informasi lebih lanjut, lihat Application name.

Pengambilan dan konversi baris yang lebih cepat

Pola pengambilan yang umum mengurangi pekerjaan berulang:

  • dict(row._mapping) tidak lagi membangun ulang lookup nama kolom setiap kali Anda memanggilnya.
  • fetchone(), fetchmany(1), fetchval(), dan melakukan iterasi pada kursor menggunakan kembali penyiapan dari pengambilan sebelumnya pada kursor tersebut.
  • fetchall() dan fetchmany() dengan konverter output melewati konversi teks internal sebelum memanggil konverter Anda. Konverter tetap berjalan dalam urutan yang sama dan menerima SQL NULL dengan cara yang sama.
  • Panggilan berulang fetchmany(1) pada hasil teks mempertahankan pengaturannya setelah setiap baris. Driver masih belum membaca baris terlebih dahulu.

Ketika fetch tidak dapat menggunakan jalur yang lebih cepat, driver akan menggunakan kode Python yang sudah ada. Tidak diperlukan perubahan pada aplikasi.

Kueri berparameter berulang yang lebih cepat

Driver mengonversi pyformat placeholder dalam satu kali proses dan menyimpan hasilnya, sehingga menjalankan pernyataan yang sama kembali melewati proses konversi. Ketika Anda menjalankan pernyataan yang sama lagi pada kursor yang sama, dan setiap parameter memiliki tipe dan ukuran yang sama dengan run sebelumnya, driver menggunakan ulang pernyataan prepared alih-alih mempersiapkannya lagi.

Untuk informasi lebih lanjut, lihat Build parameter query.

Runtime Rust yang diperbarui

Driver membutuhkan mssql-python-rs==0.5.0. Versi ini menghabiskan waktu lebih sedikit memproses teks SQL dan parameter pengiriman ketika Anda menggunakan penyedia opt-in mssql-odbc atau jalur async native.

Penyedia mssql-odbc sekarang menerapkan SQL_ATTR_CONNECTION_TIMEOUT pada permintaan yang mereset koneksi pooled. Sebelum versi ini, timeout hanya berlaku untuk pembersihan setelah permintaan dibatalkan.

Di macOS, Encrypt=Strict koneksi melalui TCP yang melalui runtime Rust, seperti mssql-odbc penyedia dan jalur async native, sekarang menggunakan Network.framework dari Apple untuk TLS. Koneksi ini dapat menegosiasikan TLS 1.3. Pengaturan lain Encrypt tidak berubah.

Penyedia mssql-odbc kini mendukung parameter bernilai tabel di tingkat ODBC, termasuk NULL sel dan nilai sel yang dikirim melalui streaming data-at-execution. mssql-python Kursor tidak memiliki API untuk meneruskan parameter bernilai tabel.

Penyedia msodbcsql18 tetap menjadi default. Untuk informasi lebih lanjut, lihat Gunakan driver mssql-odbc (Pratinjau) dan persyaratan Ketergantungan.

Pemulihan kesalahan perangkat lunak

Penutupan koneksi pooled Synapse

Menutup koneksi pooled dengan autocommit tidak lagi gagal pada pool SQL khusus Azure Synapse. Ketika driver mengembalikan koneksi ke pool, ia mengirim SET TRANSACTION ISOLATION LEVEL READ COMMITTED, yang tidak didukung oleh pool SQL khusus. driver tidak lagi mengirimkan statement tersebut.

Batas waktu checkout pool yang eksplisit

Jika Anda mengatur SQL_ATTR_CONNECTION_TIMEOUT waktu yang lebih singkat dari waktu masuk saat kedaluwarsa, pemeriksaan yang berjalan sebelum pool menggunakan kembali koneksi sekarang akan mempertahankan nilai Anda. Sebelum perbaikan ini, pemeriksaan menggantinya dengan timeout login yang lebih lama. Setelah pemeriksaan berhasil, driver mengembalikan nilai asli Anda.

Untuk informasi lebih lanjut, lihat Pemeriksaan kesehatan koneksi.

Penghentian Arrow reader

Sebelum perbaikan ini, menutup pembaca Arrow dari thread lain mengirim permintaan pembatalan meskipun tidak ada fetch yang berjalan. Permintaan itu menutup kursor, dan fetch berikutnya di thread pembacaan memunculkan ProgrammingError. Sekarang close() hanya membatalkan pengambilan yang sedang berjalan, dan mengembalikan kontrol setelah pengambilan berhenti. Pembaca dari kueri sebelumnya tidak dapat menutup atau membaca hasil yang lebih baru pada kursor yang sama. Error yang tidak disebabkan oleh penutupan tetap masuk ke kode Anda.

Untuk informasi lebih lanjut, lihat integrasi Apache Arrow.

Penanganan placeholder Pyformat

Driver tidak lagi mengganti %(name)s teks di dalam literal string, pengenal yang dikutip atau dikurung, atau komentar. Tanda persentase yang dilepas (%%) sekarang selalu menjadi tanda tunggal % dan tidak lagi menyebabkan ketidaksesuaian antara placeholder dan nilai parameter.

Perbaikan runtime Rust

Perbaikan ini ada di mssql-python-rs 0.5.0. Perbaikan tersebut berlaku untuk penyedia mssql-odbc dan jalur asinkron asli.

  • Timeout koneksi sekarang membatasi setiap permintaan tingkat koneksi, termasuk permintaan yang memeriksa koneksi dalam pool sebelum digunakan kembali.
  • Pernyataan yang dipersiapkan tidak lagi gagal ketika pengemudi membebaskan deskriptor pernyataan pada saat yang sama membuat rencana yang telah disiapkan tidak valid.
  • Pengemudi sekarang membersihkan handle pernyataan yang sudah disiapkan setelah permintaan dibatalkan.
  • Mengubah tingkat isolasi transaksi tidak lagi menghapus status kursor yang valid.
  • Membuka koneksi pada thread dengan tumpukan kecil tidak lagi menyebabkan tumpukan meluap.
  • Panjang yang terlalu besar dalam nilai skalar sql_variant sekarang menimbulkan kesalahan protokol. Sebelum perbaikan ini, panjang menjadi kembali ke awal dan byte yang belum dibaca dibiarkan di dalam stream. Nilai yang valid tidak terpengaruh.

Di mssql-odbc provider, nilai yang dikirim melalui streaming data-at-execution sekarang masuk ke posisi parameter yang terikat. Sebelum perbaikan ini, penyedia memindahkan nilai tersebut setelah parameter lain. Ketika Anda menjalankan parameter yang di-stream lalu array parameter pada pernyataan prepared yang sama, nilai-nilai bisa mencapai parameter yang salah.

Untuk detail rilis lengkap, lihat rilis mssql-python 1.18.0.

mssql-python 1.17.0

Tanggal rilis: 2 November 2026

Enhancements

Pratinjau terbaru penyedia native

Penyedia opt-in mssql-odbc di mssql-python-rs 0.4.0 menambahkan autentikasi terintegrasi Microsoft Entra ID, pembatalan statement yang sedang berjalan, dan streaming parameter besar Extensible Markup Language (XML) dan tipe yang ditentukan pengguna. Sistem ini juga menegosiasikan caching Domain Name System (DNS) yang dibantu server dan routing yang ditingkatkan ketika server mendukungnya. Perilaku failover multi-subnet default-nya kini memungkinkan upaya koneksi paralel untuk koneksi Transmission Control Protocol (TCP) yang berlaku.

Penyedia tetap dalam pratinjau. msodbcsql18 tetap menjadi penyedia default. Untuk kemampuan dan batasan saat ini, lihat Menggunakan driver mssql-odbc (Pratinjau).

Penggunaan ulang pool koneksi lebih cepat

Driver melewati pembersihan yang tidak perlu ketika dapat mengonfirmasi bahwa koneksi pooled sudah bersih. Koneksi dengan pekerjaan yang belum dikomitmenkan atau status sesi yang berubah masih perlu dibersihkan sebelum digunakan kembali. Checkout tetap memvalidasi koneksi dengan pergi-pulang ke server.

Untuk informasi lebih lanjut, lihat Siklus hidup Koneksi.

Pemulihan kesalahan perangkat lunak

Salin massal setelah peningkatan paket

Driver membutuhkan mssql-python-rs==0.4.0. Runtime yang diperbarui memperbaiki kegagalan penyalinan massal yang disebabkan oleh tata letak modul asli setelah upgrade. Menginstal atau meningkatkan mssql-python dengan dependensi akan menginstal runtime yang sesuai secara otomatis.

Untuk informasi lebih lanjut, lihat Persyaratan ketergantungan.

Penyalinan massal Unicode, nama tujuan, dan presisi datetime

bulkcopy() dan bulkcopy_arrow() menangani teks UTF-8 dengan benar serta memperbaiki kehilangan detik pecahan saat memuat nilai datetime2 . Sebagai contoh, timestamp nanodetik Arrow dapat mempertahankan digit fraksional ketujuh dalam tujuan datetime2(7), bukan dipotong menjadi mikrodetik. Objek Python datetime tetap terbatas pada presisi mikrodetik.

Nama tujuan dengan lebih dari tiga bagian sekarang memunculkan galat RuntimeError saat pencarian metadata, sebelum baris dikirim, bukan hanya terjadi error di sisi server.

Untuk informasi lebih lanjut, lihat Bulk copy dan integrasi Apache Arrow.

Pemulihan terbatas untuk koneksi dalam pool yang tidak responsif

Dengan penyedia default msodbcsql18 , checkout menerapkan timeout operasi koneksi native sementara selama validasi pooled. Aplikasi ini menggunakan timeout login positif, atau 15 detik jika timeout login nol atau tidak ditentukan. Setelah validasi gagal, driver membuang koneksi tersebut dan mencoba login pengganti alih-alih memvalidasi setiap koneksi yang masih diam.

Beberapa operasi validasi, pembersihan, dan penggantian login dapat melebihi waktu tunggu sementara. Ini bukan validasi total atau batas waktu connect(). Akuisisi token Microsoft Entra ID tidak dibatasi oleh timeout login.

Penyedia opt-in mssql-odbc tidak menjamin batas validasi yang sama. Untuk informasi lebih lanjut, lihat Pemeriksaan kesehatan koneksi dan Batasan penyedia asli.

Penghitungan baris yang akurat setelah nextset()

Cursor.nextset() memperbarui rowcount setiap hasil modifikasi data berikutnya dalam loop batch, prosedur tersimpan, atau Transact-SQL (T-SQL). Hasil yang menghasilkan baris dimulai dengan rowcount == -1 sebelum mengambil data. Rilis sebelumnya mempertahankan jumlah pernyataan pertama saat beralih ke hasil lain.

Untuk informasi lebih lanjut, lihat Jumlah baris.

Kompatibilitas Timestamp() DB-API

Argumen microsecond untuk Timestamp() bersifat opsional dan nilai defaultnya adalah nol. Panggilan enam argumen Timestamp(year, month, day, hour, minute, second) sekarang bekerja sesuai dengan ketentuan PEP 249.

Untuk informasi lebih lanjut, lihat DB-API konstruktor timestamp.

Untuk detail rilis lengkap, lihat rilis mssql-python 1.17.0.

mssql-python 1.16.0

Tanggal rilis: Oktober 2026

Enhancements

Dukungan Python 3.15

Python Package Index (PyPI) kini memiliki wheel untuk Python 3.15 di Windows, Linux, dan macOS. Rilis ini menghadirkan 41 wheel yang mencakup Python 3.10 hingga 3.15.

Untuk informasi lebih lanjut, lihat Siklus hidup dukungan.

paket Conda

Driver sekarang dipublikasikan ke microsoft saluran di Anaconda.org. Paket conda adalah satu paket mandiri yang mencakup biner driver ODBC dan runtime Rust:

conda install -c microsoft mssql-python

Di Linux, paket conda membutuhkan glibc 2.34 dan versi yang lebih baru. Di macOS, diperlukan macOS 15 dan versi yang lebih baru. Untuk daftar lengkap platform dan persyaratan, lihat Instal dari conda.

Penyedia native yang diaktifkan secara opt-in mssql-odbc

Anda sekarang dapat memilih penyedia ODBC berbasis Rust bernama mssql-odbc. Microsoft ODBC Driver 18 (msodbcsql18) tetap menjadi default. Pilih penyedia sebelum koneksi pertama dengan MSSQL_PYTHON_NATIVE_PROVIDER variabel lingkungan atau mssql_python.native_provider atribut. Kode aplikasi Anda tidak berubah.

Untuk informasi lebih lanjut, lihat Menggunakan driver mssql-odbc (Pratinjau).

Akses baris bergaya kamus dengan row._mapping

Masing-masing Row sekarang memiliki properti hanya-baca _mapping yang memetakan nama kolom ke nilai. Gunakan dict(row._mapping) untuk mengonversi baris menjadi kamus tanpa menggabungkan nilai dengan cursor.description.

Untuk informasi lebih lanjut, lihat objek baris.

Rust runtime dikirim dalam mssql-python-rs paket

Runtime Rust yang menggerakkan salinan massal kini dikirim dalam paket terpisah dengan versi yang sesuai mssql-python-rs, bukan di dalam wheel mssql-python. Perintah pip install mssql-python ini menginstalnya secara otomatis. Versi 0.3.0 dari paket ini menggunakan wheel antarmuka biner aplikasi stabil (ABI) CPython, sehingga setiap wheel melayani Python 3.10 dan versi yang lebih baru.

Untuk informasi lebih lanjut, lihat Persyaratan ketergantungan.

Paket pendamping yang diperbarui mssql-python-odbc

Driver sekarang memerlukan mssql-python-odbc versi 18.6.2.2. Wheel Linux dibagi berdasarkan pustaka C, sehingga lingkungan glibc dan musl (Alpine Linux) masing-masing hanya menginstal biner ODBC Driver 18.6 yang sesuai.

Pengambilan lebih cepat

Operasi pengambilan menggunakan waktu lebih sedikit di Python:

  • fetchmany() dan fetchall() membangun Row objek di jalur pengambilan asli ketika koneksi tidak memiliki konverter output dan tidak ada nilai uniqueidentifier yang dikonversi menjadi string.
  • date, time, dan nilai datetime dibangun dengan overhead yang lebih sedikit.
  • Metadata kolom digunakan kembali untuk hasil saat ini alih-alih dijelaskan kembali pada setiap pengambilan.
  • Fetch bersih melewati pemindaian diagnostik berulang.
  • Indeks bilangan bulat seperti row[0] menggunakan jalur pencarian langsung.
  • fetchval() melewatkan panggilan debug logging saat debug logging dinonaktifkan.

Tidak perlu perubahan aplikasi.

Pemulihan kesalahan perangkat lunak

Proses Windows bisa crash saat shutdown

Driver dapat melepaskan handle lingkungan ODBC-nya setelah finalisasi Python, yang berisiko terjadi pelanggaran akses saat proses Windows keluar. Pegangan tidak lagi dibebaskan setelah finalisasi.

Karakter U+FEFF dan U+FFFE di awal dihapus dari teks yang diambil

Ketika string yang diambil dimulai dengan U+FEFF atau U+FFFE, driver memperlakukan titik kode tersebut sebagai tanda urutan byte dan menghapusnya. Driver sekarang mengembalikan nilai lengkap untuk tipe terbatas seperti nvarchar(n) dan varchar(n). Tipe bernilai besar seperti nvarchar(max) tidak tercakup oleh perbaikan ini: U+FEFF di depan tetap dihapus, dan U+FFFE di depan menyebabkan nilai tersebut didekode dengan urutan byte yang salah.

Koneksi yang digabungkan dapat menjaga transaksi kosong tetap terbuka

Koneksi pooled dapat kembali ke pool dengan transaksi kosong terbuka atau dengan autocommit off. Driver sekarang membatalkan transaksi pada koneksi fisik dan mengaktifkan autocommit sebelum mengembalikan koneksi ke pool. Jika pembersihan itu gagal, driver akan membuang koneksi alih-alih memasukkannya ke pool.

Untuk informasi selengkapnya, lihat Pengumpulan koneksi.

Parameter tipe yang ditentukan pengguna tidak memiliki metadata tipe

Parameter yang Anda deklarasikan sebagai tipe yang didefinisikan pengguna SQL Server dengan setinputsizes() dan SQL_SS_UDT (-151), seperti geography dan geometry, sekarang akan mendapatkan metadata tipenya dari server sebelum pengikatan. Perbaikan mencakup nilai None dan pernyataan yang digunakan ulang untuk parameter yang dideklarasikan. None yang tidak dideklarasikan dan diteruskan ke kolom tipe yang ditentukan pengguna dalam pernyataan yang digunakan ulang masih tetap gagal.

setencoding() mengabaikan permintaan yang tidak didukung tanpa peringatan

Driver selalu mengirimkan perintah Transact-SQL (T-SQL) dan parameter str sebagai UTF-16LE. Panggilan setencoding() dengan encoding atau ctype yang berbeda dari UTF-16LE dengan SQL_WCHAR kini menghasilkan UserWarning alih-alih diabaikan secara diam-diam. Memanggil setencoding() tanpa argumen akan mengembalikan default tanpa peringatan.

Untuk informasi selengkapnya, lihat Mengelola koneksi.

logging native dapat menafsirkan metadata sebagai direktif format

Ketika pencatatan asli diaktifkan, nilai yang disediakan server seperti metadata kolom Arrow diteruskan ke logger asli sebagai string format. Driver sekarang mencatat nilai-nilai tersebut sebagai teks literal.

Salinan massal tidak secara konsisten memberi tanda kutip pada pengenal tujuan

Salinan massal sekarang mengutip dan melakukan escape pada nama tabel tujuan, nama kolom, dan kolasi secara konsisten. Nama multipart dan nama yang diapit tanda kurung siku yang mengandung spasi atau karakter ] berfungsi. Nama yang cacat, seperti kurung yang tidak tertutup atau nama tabel yang hilang, akan menimbulkan error sebelum baris apa pun dikirim.

Untuk informasi lebih lanjut, lihat Salinan massal.

mssql-python 1.15.0

Tanggal rilis: September 2026

Enhancements

setinputsizes() penanganan parameter berjalan dalam kode native

Penanganan parameter untuk setinputsizes() kini diproses melalui pipeline eksekusi C++ native, alih-alih melalui panggilan Python untuk tiap parameter. Statemen berparameter yang berukuran besar, dijalankan dalam batch, dan sering dieksekusi memerlukan lebih sedikit waktu untuk pemrosesan parameter di sisi Python. Tidak perlu perubahan aplikasi.

Untuk informasi lebih lanjut, lihat Pemetaan tipe data.

Binary() menerima memoryview objek

Binary() sekarang menerima a memoryview sebagai input biner, sehingga Anda dapat memberikan tampilan zero-copy dari buffer tanpa mengonversinya ke bytes terlebih dahulu.

Untuk informasi lebih lanjut, lihat Data biner.

Konstanta tipe SQL Server tersedia dari mssql_python modul

Konstanta tipe SQL Server sekarang diekspos langsung dari mssql_python modul, sehingga lebih mudah ditemukan saat Anda mendeklarasikan tipe parameter atau membaca metadata tipe.

Untuk informasi lebih lanjut, lihat Pemetaan tipe data.

Pemulihan kesalahan perangkat lunak

Pencatatan log secara bersamaan dapat menyebabkan proses macet

Jalur logging native memperoleh GIL dan mutex internal dalam urutan yang tidak konsisten, sehingga aplikasi multithreaded dengan driver logging aktif bisa mengalami deadlock. Urutan kunci telah diperbaiki.

Roda Windows ARM64 tidak menyertakan inti asli ARM64

Wheel Windows ARM64 tidak menyertakan biner ARM64 mssql_py_core yang sesuai, yang memengaruhi penyalinan massal di platform tersebut. Wheel kini tersedia dengan versi ARM64.

Untuk informasi lebih lanjut, lihat Salinan massal.

DLL Windows yang dibundel bergantung pada jalur pencarian proses

Driver dan DLL autentikasi yang disertakan dalam paket sekarang dimuat dari direktori lokal paket. Ketergantungan native dapat diselesaikan tanpa bergantung pada konfigurasi jalur pencarian proses secara menyeluruh, yang tidak dapat diandalkan di beberapa lingkungan penerapan.

Decimal parameter ditetapkan secara berbeda tergantung pada nilainya

Parameter Decimal sekarang diikat sebagai SQL_NUMERIC apa pun nilai runtime-nya, sehingga tipe parameter desimal tetap sama di semua nilai dan jalur eksekusi.

Untuk informasi lebih lanjut, lihat data desimal dan data uang.

Pengikatan parameter menggunakan pengenal tipe ODBC 2.x yang sudah usang

Parameter yang diketik sekarang menggunakan pengenal tipe ODBC 3.x sebagai pengganti padanan ODBC 2.x, yang menghindari ketidaksesuaian dengan konfigurasi driver saat ini.

Connection.getinfo(SQL_DATABASE_NAME) mengembalikan nilai yang belum didekode

Nilai yang dikembalikan untuk SQL_DATABASE_NAME sekarang didekode, sehingga nama basis data dikembalikan sebagai teks Python.

Untuk informasi lebih lanjut, lihat Manajemen koneksi.

Pembersihan kursor gagal saat interpreter dimatikan

Koneksi yang memegang kursor dalam status siklus hidup campuran membersihkannya dalam urutan yang bisa menyebabkan proses crash ketika sebagian dari pembersihan itu berjalan saat pemadaman interpreter. Pematian kini selesai dengan normal.

Untuk informasi lebih lanjut, lihat Manajemen kursor.

mssql-python 1.14.0

Tanggal rilis: Agustus 2026

Enhancements

Deteksi parameter dan pengikatan dijalankan dalam kode asli

Deteksi dan pengikatan tipe parameter kini dilakukan dalam satu pipeline native, alih-alih melalui pemanggilan Python untuk setiap parameter. Perubahan ini memperbaiki hambatan kinerja yang signifikan, dengan peningkatan throughput end-to-end yang lebih tinggi pada operasi besar seperti insert massal. Tidak perlu perubahan aplikasi.

Pemulihan kesalahan perangkat lunak

Argumen timeout untuk connect() menetapkan batas waktu kueri alih-alih batas waktu autentikasi

Argumen timeout sekarang mengatur SQL_ATTR_LOGIN_TIMEOUT dan membatasi upaya autentikasi, sesuai dengan yang dijelaskan oleh nama argumen dan dokumentasi. Pada versi sebelumnya, ini menjadi timeout kueri per pernyataan, sehingga connect(timeout=30) tidak membatasi berapa lama upaya koneksi dapat berjalan, dan kueri dibatalkan setelah 30 detik. Batas waktu kueri untuk setiap pernyataan tetap tersedia sebagai properti Connection.timeout.

Penting

Jika Anda meneruskan timeout ke connect() untuk membatalkan kueri yang berjalan lama, perilaku tersebut tidak lagi terjadi. Tetapkan Connection.timeout saja. Hal yang sama juga berlaku jika Anda mengandalkan connect(timeout=) untuk memperpanjang batas waktu koneksi yang digunakan bulkcopy() untuk koneksi internalnya: atur Connection.timeout sebelum Anda membuat kursor.

Untuk informasi lebih lanjut, lihat Timeout koneksi.

timeout=0 ditolak oleh bulkcopy()

timeout sebesar 0 menyebabkan galat validasi, meskipun 0 berarti tidak ada batas waktu di API penyalinan massal yang mendasarinya. Metode ini sekarang menerima 0 dan menonaktifkan batas waktu operasi. Nilai negatif, non-bilangan bulat, dan boolean tetap ditolak.

Untuk informasi lebih lanjut, lihat Salinan massal.

Pembersihan menggantikan eksepsi fetch Arrow yang asli

Ketika pengambilan data dari pembaca Arrow gagal, jalur pembersihan driver memunculkan kesalahan kedua yang menggantikan kesalahan asli, sehingga pemanggil melihat kegagalan pembersihan alih-alih penyebab kegagalan pengambilan data. Cleanup sekarang memeriksa status kursor terlebih dahulu dan mempertahankan pengecualian asli.

executemany() kesalahan konversi desimal mencantumkan nilai parameter

Kegagalan konversi desimal di executemany() menyebabkan nilai yang memicu kesalahan dilaporkan melalui pengecualian berantai, yang dapat menyebabkan data pelanggan masuk ke log aplikasi dan sistem pemantauan. Kesalahan sekarang hanya melaporkan indeks baris, indeks kolom, dan tipe nilai saja.

Untuk informasi selengkapnya, lihat Penanganan kesalahan.

Penyalinan massal untuk jenis Tampilan Panah ditolak

bulkcopy_arrow() tidak dapat mengonsumsi array Arrow View dengan panjang variabel, jadi kolom Polars string_view harus dikonversi DataFrame.to_arrow() terlebih dahulu. Nilai Tampilan String dan NULL kini langsung melewati Antarmuka Data Arrow C.

Untuk informasi lebih lanjut, lihat Integrasi Polars.

Pemuatan ekstensi Windows menggunakan arsitektur CPU host

Pada Windows, driver memilih ekstensi natifnya berdasarkan CPU host alih-alih interpreter yang sedang berjalan, sehingga Python x64 pada host ARM64 dimuat melalui jalur cadangan dan mengeluarkan pemberitahuan ke stdout. Loader sekarang menentukan arsitektur dari interpreter dan melaporkan mekanisme fallback sebagai peringatan.

mssql-python 1.13.0

Tanggal rilis: Agustus 2026

Enhancements

Biner pengandar ODBC hanya tersedia di mssql-python-odbc

Versi 1.13.0 menghapus libs/ fallback dari roda mssql-python dan mendeklarasikan mssql-python-odbc==18.6.2.1 di install_requires. Perintah pip install mssql-python ini masih menghasilkan driver yang berfungsi. Instal mssql-python-odbc secara eksplisit saat Anda menginstal dengan --no-deps, atau dari indeks privat yang tidak mencerminkannya.

Untuk informasi selengkapnya, lihat Penginstalan.

Salinan massal dari sumber Apache Arrow

Metode baru cursor.bulkcopy_arrow() ini memuat data yang sudah dalam format Apache Arrow, tanpa mengonversi setiap baris menjadi objek Python terlebih dahulu. Meneruskan sumber Arrow ke bulkcopy() sekarang memunculkan TypeError.

Untuk informasi lebih lanjut, lihat integrasi Apache Arrow dan Salinan Massal.

token_providerparameter untuk kredensial Microsoft Entra

Fungsi connect() dan kelas Connection menerima argumen token_provider, sehingga Anda dapat meneruskan objek kredensial seperti DefaultAzureCredential alih-alih menyebutkan mode autentikasi dalam string koneksi. Argumen ini tidak dapat digunakan bersamaan dengan kata kunci Authentication dan dengan token yang diteruskan melalui attrs_before, serta hanya mendukung cakupan cloud komersial Azure.

Untuk informasi selengkapnya, lihat Autentikasi Microsoft Entra.

Penggabungan koneksi yang mempertimbangkan identitas

Pool koneksi sekarang memisahkan koneksi berdasarkan identitas Microsoft Entra. Pada versi sebelumnya, pool hanya menggunakan string koneksi sebagai kunci, sehingga pool dapat memberikan koneksi yang diautentikasi sebagai satu pengguna untuk permintaan yang dibuat oleh pengguna lain. Driver juga hanya memperoleh token saat permintaan koneksi tidak menemukan koneksi di pool, dan menyegarkan koneksi dalam pool ketika tokennya akan kedaluwarsa dalam 5 menit.

Untuk informasi selengkapnya, lihat Pengumpulan koneksi.

Pemulihan kesalahan perangkat lunak

executemany() memasukkan nol baris saat NULL muncul setelah baris pertama

Panggilan executemany() yang mencampur nilai numerik non-NULL dan NULL tidak menyisipkan baris apa pun dan tidak memunculkan pengecualian saat NULL pertama muncul setelah baris pertama. Perilaku ini memengaruhi parameter tinyint, smallint, int, dan float . Driver sekarang menginisialisasi indikator ODBC untuk setiap parameter numerik berukuran tetap sebelum eksekusi array.

Sebuah SQL_WVARCHAR konverter output mengubah kolom non-string

Mendaftarkan satu konverter string juga mengonversi nilai int, desimal, dan tanggal, karena driver menggunakan konverter SQL_WVARCHAR sebagai fallback untuk setiap kolom yang tidak memiliki konverternya sendiri. Driver sekarang hanya menggunakan fallback tersebut ketika tipe Python yang dipetakan pada kolom adalah str atau bytes.

Konverter output yang terdaftar berdasarkan kode tipe SQL integer tidak pernah dijalankan

Konverter yang terdaftar dengan kode tipe SQL integer, seperti SQL_DECIMAL, disimpan tetapi tidak pernah dipanggil, karena driver hanya dikirim pada tipe Python di cursor.description. Driver sekarang mengirim kode bilangan bulat terlebih dahulu, lalu tipe Python, dan kemudian SQL_WVARCHAR cadangan.

Penting

Jika Anda mendaftarkan konverter dengan kode tipe SQL integer di versi sebelumnya, konverter tersebut mulai berjalan saat Anda melakukan upgrade. Tinjau sebelum Anda menerapkan, karena nilai kolom yang sebelumnya melewati tanpa perubahan kini telah diubah.

Untuk informasi selengkapnya, lihat Konverter jenis kustom.

Menutup pembaca Arrow tidak melepaskan kursor sisi server

Menutup pembaca Arrow membiarkan kursor di sisi server tetap teralokasi dan objek induk Cursor dalam keadaan tidak konsisten, karena cursor.arrow_reader() mengembalikan pyarrow.RecordBatchReader mentah. Metode ini sekarang mengembalikan pembungkus yang metodenya close() melepaskan kursor sisi server dan mengatur ulang status kursor, dan pembungkus berfungsi sebagai pengelola konteks.

Untuk informasi lebih lanjut, lihat integrasi Apache Arrow.

Kursor yang sebagian diinisialisasi diangkat AttributeError ke Cursor.__del__

Kursor yang inisialisatornya gagal memunculkan AttributeError sebagai pengecualian yang tidak dapat dimunculkan selama garbage collection.

Cursor.__init__ dimunculkan sebelum menetapkan atribut closed dan __del__, yang kemudian coba dibaca oleh hstmt. Penginisialisasi kini menetapkan kedua atribut sebelum kode apa pun yang dapat memicu pengecualian, dan __del__ melindungi panggilan logging-nya agar tetap aman selama penghentian interpreter.

mssql-python 1.12.0

Tanggal rilis: Juli 2026

Enhancements

Paket pendamping mandiri mssql-python-odbc

Biner driver ODBC kini diterbitkan secara terpisah sebagai mssql-python-odbc, paket pendamping khusus data yang dipatok ke versi 18.6.2. Anda tidak perlu mengubah kode apa pun, karena pip install mssql-python paket pendamping akan diinstal bersamanya. Loader native memprioritaskan paket pendamping dan akan beralih ke biner yang dibundel di dalam wheel mssql-python jika paket tersebut tidak tersedia.

Untuk informasi selengkapnya, lihat Penginstalan.

Pemulihan kesalahan perangkat lunak

cursor.bulkcopy() sekarang menggunakan timeout koneksi milik koneksi induk

bulkcopy() sekarang menggunakan timeout koneksi dari koneksi induknya, yang Anda atur dengan connect(..., timeout=<seconds>). Sebelumnya, koneksi terpisah yang dibuka salinan massal menggunakan timeout koneksi 15 detik yang sudah di-hardcode dan tidak bisa Anda override dari Python. Koneksi induk yang dibuat dengan timeout=0 masih mendapatkan default 15 detik.

Untuk informasi lebih lanjut, lihat Salinan massal.

cursor.bulkcopy() mendukung kolom tipe CLR yang ditentukan pengguna

cursor.bulkcopy() sebelumnya gagal dengan Protocol Error: Unsupported TDS type for bulk copy: 0xF0 untuk kolom tujuan mana pun yang menggunakan tipe pengguna common language runtime (CLR), termasuk tipe geografi, geometri, dan hierarchyid bawaan. Driver sekarang memetakan kolom CLR UDT ke varibinary (max) pada kabel dan mengalirkan byte yang Anda berikan sebagai payload UDT IBinarySerialize . Perbaikan ini dikirim di mssql_py_core 0.1.7.

Untuk informasi lebih lanjut, lihat Salinan massal dan Pemetaan tipe Data.

mssql-python 1.11.0

Tanggal rilis: Juli 2026

Enhancements

Semantik manajer konteks yang disempurnakan

with connection: sekarang menerapkan transaksi saat blok selesai tanpa error, dan membatalkan transaksi ketika pengecualian keluar dari blok.

Untuk informasi selengkapnya, lihat Manajemen transaksi.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki deadlock GIL di jalur teardown ODBC (conn.close() dan cursor.close()) dan di SQLDescribeParam untuk parameter bernilai None dalam konfigurasi terowongan SSH dan forwarder dalam proses.
  • Memperbaiki parameter NULL BINARY dan VARBINARY pada tabel sementara dan variabel tabel. Ketika resolusi jenis otomatis gagal, driver sekarang memancarkan peringatan Python dengan panduan eksplisit.cursor.setinputsizes()
  • Memperbaiki masalah import mssql_python yang gagal pada Apple Silicon dengan instalasi bersih (regresi pada versi 1.8.0). Dependensi dylib ODBC yang disertakan kini telah ditulis ulang untuk arsitektur arm64 dan x86_64.
  • Memperbaiki deadlock GIL di core Rust yang menyebabkan operasi penyalinan massal terhenti saat mengautentikasi dengan Authentication=ActiveDirectoryServicePrincipal.

mssql-python 1.10.0

Tanggal rilis: Juni 2026

Enhancements

Dukungan ActiveDirectoryServicePrincipal untuk salinan massal

cursor.bulkcopy() sekarang mendukung dukungan untuk penyalinan massal, sehingga Anda dapat melakukan penyisipan massal dengan kredensial service principal.

Untuk informasi lebih lanjut, lihat Salinan massal dan autentikasi Microsoft Entra.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki data non-ASCII VARCHAR dan CHAR di jalur pengambilan Arrow.
  • Memperbaiki batas waktu koneksi selama operasi pemuatan massal.

mssql-python 1.9.0

Tanggal rilis: Juni 2026

Enhancements

Objek baris dalam salinan massal

cursor.bulkcopy() sekarang menerima objek Row yang diambil secara langsung tanpa memerlukan konversi tuple manual.

Untuk informasi lebih lanjut, lihat Objek salinan massal dan Baris.

Pemulihan kesalahan perangkat lunak

  • Kemasan roda tetap sehingga simdutf selalu terhubung secara statis.
  • Memperbaiki sisipan besar DECIMAL di executemany().
  • Memperbaiki fallback tipe yang keliru untuk parameter NULL.
  • Memperbaiki round-trip pickle dan unpickle pada pengecualian.
  • Diperbaiki nextset() sehingga mempertahankan PRINT pesan di seluruh kumpulan hasil.
  • Memperbaiki penanganan Row pada jalur fallback executemany() data-at-execution.
  • Memperbaiki pemeriksaan tipe metode fetch untuk alat analisis statis.

mssql-python 1.8.0

Tanggal rilis: Mei 2026

Enhancements

Dukungan ActiveDirectoryMSI untuk salinan massal

cursor.bulkcopy() sekarang mendukung Authentication=ActiveDirectoryMSI untuk identitas terkelola yang ditetapkan sistem dan yang ditetapkan pengguna.

Untuk informasi lebih lanjut, lihat Salinan massal dan autentikasi Microsoft Entra.

Pengindeksan baris dengan kunci string

Anda sekarang dapat mengakses nilai baris berdasarkan nama kolom, misalnya row["col"], selain pengindeksan posisi dan akses atribut.

Untuk informasi lebih lanjut, lihat objek baris.

Peningkatan driver ODBC yang dibundel

Driver Microsoft ODBC yang dibundel untuk SQL Server diperbarui ke 18.6.2.1.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki masalah masa pakai atribut koneksi yang ditangguhkan dalam autentikasi berbasis token.
  • Memperbaiki penguraian string koneksi yang berulang dalam alur autentikasi.
  • Memperbaiki anotasi tipe executemany() untuk input sekuens.

mssql-python 1.7.1

Tanggal rilis: Mei 2026

Enhancements

Cakupan roda yang diperluas dan peningkatan performa

Rilis ini meliputi:

  • Paket wheel yang kompatibel dengan RHEL 8.
  • Mengembalikan roda macOS Python 3.10universal2.
  • Peningkatan penanganan UTF-16 melalui simdutf.
  • Jalur panas yang dioptimalkan execute() .

Dampak kinerja: Throughput eksekusi batch meningkat karena optimasi jalur panas dalam execute() metode.

Untuk informasi selengkapnya, lihat Penginstalan.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki kegagalan autentikasi sehingga memunculkan pengecualian DB-API mssql_python alih-alih RuntimeError.
  • Pelepasan GIL diperluas pada panggilan ODBC yang memblokir untuk eksekusi, pengambilan data, transaksi, dan atribut koneksi.
  • Memperbaiki kegagalan executemany() yang terjadi saat nilai desimal berganti tanda.
  • Memperbaiki decoding CP1252 VARCHAR yang tidak konsisten di seluruh platform.
  • Memperbaiki cursor.bulkcopy() kegagalan pada string kosong di kolom NVARCHAR(MAX) dan VARCHAR(MAX).

Note

Versi 1.7.0 ditarik karena masalah publikasi. Gunakan versi 1.7.1 atau yang lebih baru.

mssql-python 1.6.0

Tanggal rilis: April 2026

Enhancements

Sanitasi string koneksi berbasis parser

Sanitisasi string koneksi sekarang menggunakan parser alih-alih ekspresi reguler, sehingga string koneksi yang mengandung karakter khusus di kolom kata sandi dan nilai yang dikurung dapat diparser dengan benar.

Untuk informasi selengkapnya, lihat String koneksi.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki pelepasan GIL selama memblokir operasi koneksi dan pemutusan ODBC.
  • Memperbaiki kerusakan pada setinputsizes() dengan petunjuk SQL_DECIMAL dan SQL_NUMERIC.
  • Memperbaiki perilaku yang salah fetchone() untuk metode katalog ODBC.
  • Memperbaiki kesalahan status kursor yang tidak valid saat reset_cursor=False digunakan.
  • Memperbaiki executemany() petunjuk tipe untuk urutan parameter berbasis mapping.
  • Menambahkan pelindung lintasan jalur untuk setup_logging(log_file_path=...).

mssql-python 1.5.0

Tanggal rilis: April 2026

Fitur baru

Dukungan untuk mengambil data Apache Arrow

Tiga metode kursor baru menyediakan pengambilan data kolumnar berperforma tinggi melalui Arrow C Data Interface:

  • cursor.arrow() mengembalikan sebuah pyarrow.Table lengkap.
  • cursor.arrow_batch() mengembalikan satu pyarrow.RecordBatch.
  • cursor.arrow_reader() mengembalikan pyarrow.RecordBatchReader untuk streaming.

Metode-metode ini tidak membuat objek Python untuk setiap nilai. Untuk dokumentasi lengkap, lihat Integrasi Apache Arrow.

Dukungan tipe sql_variant

Driver sekarang mendeteksi kolom sql_variant saat pengambilan data, menentukan tipe dasar yang mendasarinya, dan mengembalikan nilai Python dengan tipe yang benar, bukan byte mentah.

Note

sql_variant menggunakan jalur pengambilan streaming, yang mungkin sedikit memengaruhi performa dibandingkan kolom bertipe tetap.

Untuk informasi lebih lanjut, lihat Pemetaan tipe data.

Dukungan UUID asli

Pengaturan baru native_uuid mengontrol apakah UNIQUEIDENTIFIER kolom dikembalikan sebagai uuid.UUID objek (default) atau sebagai string huruf besar yang kompatibel dengan pyodbc. Konfigurasikan di tingkat modul atau per koneksi.

Untuk informasi selengkapnya, lihat Konfigurasi modul.

Baris kelas ekspor publik

Kelas Row sekarang diekspor pada level teratas untuk anotasi tipe.

Untuk informasi lebih lanjut, lihat objek baris.

Pemulihan kesalahan perangkat lunak

  • Memperbaiki deteksi positif palsu ? dalam identifier yang diapit tanda kurung, literal string, dan komentar.
  • Memperbaiki pengikatan parameter NULL untuk VARBINARY kolom (tidak lagi menimbulkan kesalahan konversi implisit).
  • Memperbaiki masalah hilangnya mikrodetik pada nilai datetime.time saat konversi bolak-balik untuk kolom TIME(1) hingga TIME(7).
  • Memperbaiki jalur fetch Arrow agar menyertakan pecahan detik dengan benar untuk kolom TIME.
  • Memperbaiki masalah penyalinan massal dengan metode autentikasi Microsoft Entra ID (kolom kredensial usang tidak lagi menyebabkan kesalahan validasi).
  • Instans kredensial Azure Identity yang di-cache di tingkat modul untuk meningkatkan performa autentikasi.

mssql-python 1.4.0

Tanggal rilis: Februari 2026

Fitur baru

Dukungan salinan massal

Pemuatan data massal berkinerja tinggi kini tersedia melalui cursor.bulkcopy(). Metode ini menerima opsi untuk batch_size, timeout, column_mappings, keep_identity, check_constraintstable_lockkeep_nullsfire_triggersdan .use_internal_transaction

Untuk informasi lebih lanjut, lihat Salinan massal.

Improvements

  • Pengoptimalan performa untuk kumpulan hasil besar.
  • Mengurangi penggunaan memori selama operasi batch.
  • Pesan kesalahan yang ditingkatkan untuk kegagalan salin massal.

mssql-python 1.3.0

Tanggal rilis: Januari 2026

Fitur baru

Kelas pengaturan

Konfigurasikan perilaku seluruh modul melalui kelas baru Settings , yang mencakup lowercase pengaturan nama kolom di cursor.description.

Untuk informasi selengkapnya, lihat Konfigurasi modul.

Improvements

  • Penanganan batas waktu koneksi yang lebih baik saat failover Azure SQL.
  • Kompatibilitas yang ditingkatkan dengan Python 3.13.

mssql-python 1.2.0

Tanggal rilis: Januari 2026

Fitur baru

Metode penemuan skema

Metode kursor baru mengeksplorasi metadata basis data: tables(), , columns(), primaryKeys()foreignKeys(), procedures()statistics(), , dan getTypeInfo().

Untuk informasi lebih lanjut, lihat Penemuan skema.

Improvements

  • Peningkatan cache metadata untuk kueri skema yang berulang.
  • Penanganan kolom komputasi yang lebih baik dalam columns() hasil.

mssql-python 1.1.0

Tanggal rilis: Desember 2025

Fitur baru

Konverter keluaran khusus

Daftarkan fungsi kustom untuk mengubah nilai kolom saat pengambilan data, dengan add_output_converter(), get_output_converter(), remove_output_converter(), dan clear_output_converters().

Untuk informasi selengkapnya, lihat Konverter jenis kustom.

Improvements

  • Pesan kesalahan yang lebih baik untuk kegagalan konversi tipe.
  • Dukungan untuk fungsi konverter yang mengembalikan None.

mssql-python 1.0.0

Tanggal rilis: November 2025

Rilis GA awal

Rilis ketersediaan umum pertama mssql-python, driver Python asli Microsoft untuk SQL Server.

Untuk informasi lebih lanjut, lihat driver mssql-python.

Fitur inti

  • Arsitektur DDBC: Konektivitas Database Langsung tanpa memerlukan instalasi driver ODBC.
  • Kepatuhan DB-API 2.0: Antarmuka basis data Python standar.
  • Connection pooling: Manajemen connection pool bawaan.
  • Autentikasi Microsoft Entra: Dukungan penuh untuk autentikasi berbasis identitas Azure.
  • Enkripsi TLS: Koneksi aman dengan validasi sertifikat.

Fitur koneksi

  • 21 kata kunci string koneksi.
  • 9 mode otentikasi (SQL, Windows, dan 7 metode Microsoft Entra ID).
  • Kontrol penerapan otomatis.
  • Metode eksekusi: execute(), executemany(), dan batch_execute().
  • Atribut koneksi melalui set_attr() dan getinfo().
  • Dukungan pengelola konteks.

Fitur kursor

  • Metode pengambilan standar: fetchone(), fetchmany(), fetchall().
  • Metode yang diperluas: fetchval(), skip().
  • Metode eksekusi: execute() dan executemany().
  • Objek baris dengan akses atribut dan indeks.
  • Navigasi beberapa kumpulan hasil dengan nextset().

Dukungan jenis data

  • Semua tipe bawaan SQL Server.
  • Pemetaan tipe Python↔SQL.
  • Konstanta jenis SQL untuk pengetikan eksplisit (misalnya, mssql_python.SQL_DECIMAL).
  • Penanganan nilai NULL di Python None.

Dukungan transaksi

  • Penerapan dan pengembalian manual.
  • Mode komit otomatis.
  • Kontrol tingkat isolasi.
  • Deteksi dan penanganan kebuntuan.

Modus autentikasi

Mode Deskripsi
autentikasi SQL Server Nama pengguna dan kata sandi
Autentikasi Windows Trusted_Connection
ActiveDirectoryDefault DefaultAzureCredential
ActiveDirectoryInteractive Login berbasis browser
Kode Perangkat Active Directory Alur kode perangkat
ActiveDirectoryPassword Nama pengguna dan kata sandi Microsoft Entra (tidak digunakan lagi; menggunakan ROPC)
ActiveDirectoryMSI Identitas yang dikelola
ActiveDirectoryServicePrincipal Kepala layanan
Terintegrasi dengan Active Directory Windows Kerberos

Upgrade

Dari pyodbc

Untuk panduan migrasi terperinci, lihat Bermigrasi dari pyodbc.

Perbedaan utama:

  • Baik gaya parameter ? (qmark) maupun %(name)s (pyformat) didukung. Kueri Anda yang sudah ada ? tetap berfungsi tanpa perubahan.
  • Tidak ada metode callproc(). Gunakan EXECUTE pernyataan sebagai gantinya.
  • Pool koneksi bawaan.
  • Tidak ada dependensi driver ODBC eksternal.

Dari pymssql

Untuk panduan migrasi terperinci, lihat Bermigrasi dari pymssql.

Perbedaan utama:

  • Ganti %s dan %d parameter penanda dengan ? atau %(name)s.
  • Gunakan string koneksi alih-alih argumen posisi.
  • Tidak ada dependensi FreeTDS.
  • Beberapa kursor simultan per koneksi.
  • Objek baris dengan akses atribut mengganti as_dict=True.

Antara versi mssql-python

Tingkatkan driver untuk mendapatkan fitur dan perbaikan baru.

pip install --upgrade mssql-python

Periksa catatan rilis untuk mengetahui perubahan yang merusak sebelum memutakhirkan sistem produksi.

Peta strategi

Untuk fitur mendatang dan peta jalan pengembangan, lihat repositori GitHub.