Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ten artykuł wymienia, co zmieniło się w każdej wersji sterownika mssql-python, najpierw najnowsze. Każda sekcja obejmuje nowe funkcje, zmiany zachowań oraz poprawki błędów w jednej wersji.
Aby poznać wersje, które Microsoft obecnie wspiera, zobacz cykl życia wsparcia.
mssql-python 1.18.0
Data wydania: 18 listopada 2026
Enhancements
Niestandardowe nazwy aplikacji
Ustaw APP lub Application Name w swoim parametry połączenia, aby zidentyfikować aplikację lub usługę w monitorowaniu po stronie serwera. Na przykład pojawia się APP=orders-api jako MSSQL-Python|orders-api w sys.dm_exec_sessions.program_name i APP_NAME(). Połączenia synchroniczne, eksperymentalna natywna ścieżka asynchroniczna oraz kopiowanie masowe wysyłają tę samą nazwę.
Domyślna nazwa to MSSQL-Python. Przed tą wersją natywne ścieżki asynchroniczne i kopiowanie zbiorcze wysyłały mssql-python. Jeśli filtr monitorujący dokładnie odpowiada mssql-python, zaktualizuj go.
Aby uzyskać więcej informacji, zobacz Application name.
Szybsze pobieranie i konwersja wierszy
Typowe wzorce pobierania wykonują mniej powtarzalnej pracy:
-
dict(row._mapping)nie przebudowuje już mechanizmu wyszukiwania nazw kolumn za każdym razem, gdy go wywołujesz. -
fetchone(),fetchmany(1),fetchval()oraz iterowanie po kursorze ponownie wykorzystują konfigurację z poprzedniego pobrania dla tego kursora. -
fetchall()ifetchmany()z konwerterami wyjściowymi pomijają wewnętrzną konwersję tekstu, zanim wywołają Twój konwerter. Konwertery nadal działają w tej samej kolejności i odbierają SQLNULLw ten sam sposób. - Powtarzane wywołania
fetchmany(1)na wynikach tekstowych zachowują swoją konfigurację po każdym wierszu. Sterownik nadal nie odczytuje wierszy z wyprzedzeniem.
Gdy pobieranie nie może użyć szybszej ścieżki, sterownik korzysta z istniejącego kodu Python. Nie jest wymagana żadna zmiana w aplikacji.
Szybsze powtarzające się zapytania parametryzowane
Sterownik konwertuje pyformat symbole zastępcze w jednym przebiegu i buforuje wynik, więc ponowne uruchomienie tego samego polecenia pomija konwersję. Gdy uruchomisz to samo polecenie ponownie na tym samym kursorze, a każdy parametr ma ten sam typ i rozmiar co poprzednie, sterownik używa przygotowanego polecenia ponownie, zamiast go przygotowywać.
Aby uzyskać więcej informacji, zobacz Budowanie parametryzowanych zapytań.
Zaktualizowano środowisko uruchomieniowe Rust
Sterownik wymaga mssql-python-rs==0.5.0. Ta wersja poświęca mniej czasu na przetwarzanie tekstu SQL i wysyłanie parametrów, gdy korzystasz z dostawcy opt-in mssql-odbc lub natywnej ścieżki asynchronicznej.
Dostawca mssql-odbc teraz stosuje SQL_ATTR_CONNECTION_TIMEOUT do żądania resetującego połączenie w grupie. Przed tą wersją limit czasu dotyczył tylko czyszczenia po anulowanym żądaniu.
Na macOS Encrypt=Strict połączenia przez TCP przechodzące przez środowisko uruchomieniowe Rust, takie jak dostawca mssql-odbc i natywna ścieżka asynchroniczna, teraz korzystają z Network.framework Apple dla TLS. Te połączenia mogą negocjować TLS 1.3. Inne Encrypt ustawienia się nie zmieniają.
Dostawca mssql-odbc obsługuje teraz parametry o wartościach tabelarycznych na poziomie ODBC, w tym NULL komórki i wartości komórek przesyłane za pomocą strumieniowego przesyłania danych podczas wykonywania. Kursor mssql-python nie ma interfejsu API do przekazywania parametrów tabelarycznych.
Dostawca msodbcsql18 pozostaje domyślny. Aby uzyskać więcej informacji, zobacz Użyj sterownika mssql-odbc (Podgląd) oraz wymagania dotyczące zależności.
Poprawki błędów
Zamykanie połączenia puli Synapse
Zamknięcie połączenia w puli z włączonym autocommit nie powoduje już błędu na dedykowanych pulach SQL Azure Synapse. Gdy sterownik przywrócił połączenie do puli, wysłał SET TRANSACTION ISOLATION LEVEL READ COMMITTED, czego dedykowane pule SQL nie obsługują. Sterownik już nie wysyła tej instrukcji.
Jawne limity czasu pobrania z puli
Jeśli ustawisz SQL_ATTR_CONNECTION_TIMEOUT krótszy czas niż limit logowania, sprawdzanie uruchamiane przed ponownym użyciem połączenia przez pulę zachowuje Twoją wartość. Przed tą poprawką kontrola zastąpiła ją dłuższym limitem czasu logowania. Po pomyślnym sprawdzeniu sterownik przywraca Twoją pierwotną wartość.
Aby uzyskać więcej informacji, zobacz Kontrole stanu połączenia.
Wyłączenie czytnika Arrow
Przed tą poprawką zamknięcie czytnika Arrow z innego wątku wysyłało żądanie anulowania nawet wtedy, gdy nie było uruchamianego pobierania. To żądanie zamknęło kursor, a kolejne pobranie w wątku odczytu zgłosiło ProgrammingError. Teraz close() anuluje tylko pobranie, które jest uruchomione, i wraca po zatrzymaniu pobierania. Czytnik z wcześniejszego zapytania nie może zamknąć ani odczytać późniejszego wyniku na tym samym kursorze. Błędy, których operacja zamknięcia nie spowodowała, nadal docierają do Twojego kodu.
Więcej informacji można znaleźć w artykule o integracji z Apache Arrow.
Obsługa symboli zastępczych w Pyformat
Sterownik już nie zastępuje tekstu %(name)s w literalach łańcuchowych, identyfikatorach ujętych w cudzysłów lub nawiasy ani komentarzach. Znak ucieczki procentowy (%%) staje się teraz zawsze pojedynczym % i nie powoduje już niezgodności między symbolami zastępczymi a wartościami parametrów.
Poprawki środowiska uruchomieniowego Rust
Te poprawki znajdują się w mssql-python-rs wersji 0.5.0. Dotyczą one dostawcy mssql-odbc i natywnej ścieżki asynchronicznej.
- Limit czasu połączenia ogranicza teraz każde żądanie dotyczące połączenia, w tym żądania sprawdzające połączenie z puli przed jego ponownym użyciem.
- Przygotowane instrukcje nie ulegają już niepowodzeniu, gdy sterownik zwolni deskryptor instrukcji, jednocześnie unieważniając przygotowany plan.
- Sterownik teraz czyści przygotowane uchwyty instrukcji po anulowaniu żądania.
- Zmiana poziomu izolacji transakcji nie usuwa już prawidłowego stanu kursora.
- Otwarcie połączenia na wątku z małym stosem nie przepełnia już stosu.
- Nadmiernie duża długość w wartości skalarnej
sql_variantpowoduje teraz błąd protokołu. Przed tą poprawką wartość długości zawijała się, a nieprzeczytane bajty pozostawały w strumieniu. Prawidłowe wartości nie są objęte wpływem.
W dostawcy mssql-odbc wartości wysyłane za pomocą strumieniowania data-at-execution trafiają teraz na swoje powiązane pozycje parametrów. Przed tą poprawką dostawca umieszczał je po pozostałych parametrach. Gdy uruchamiałeś parametry strumieniowe, a następnie tablicę parametrów na tej samej przygotowanej instrukcji, wartości mogły trafić do niewłaściwych parametrów.
Pełne szczegóły wydania znajdziesz w wydaniu mssql-python 1.18.0.
mssql-python 1.17.0
Data wydania: 2 listopada 2026
Enhancements
Zaktualizowany natywny dostawca podglądu
Dostawca opt-in mssql-odbc w mssql-python-rs wersji 0.4.0 dodaje zintegrowane uwierzytelnianie Microsoft Entra ID, anulowanie uruchomionych instrukcji oraz strumieniowanie dużych parametrów Extensible Markup Language (XML) oraz typów zdefiniowanych przez użytkownika. Negocjuje także buforowanie Domain Name System (DNS) wspomagane przez serwer oraz ulepszone routowanie, gdy serwer je obsługuje. Domyślne zachowanie przełączania awaryjnego dla wielu podsieci umożliwia teraz próby równoległego połączenia dla odpowiednich połączeń protokołu kontroli transmisji (TCP).
Dostawca jest nadal w wersji zapoznawczej.
msodbcsql18 pozostaje domyślnym dostawcą. Aktualne możliwości i ograniczenia można znaleźć w artykule Używanie sterownika mssql-odbc (Podgląd).
Szybsze ponowne wykorzystanie puli łączeń
Sterownik pomija redundantne czyszczenie, gdy może potwierdzić, że połączenie z puli jest już czyste. Połączenia z niezatwierdzonymi zmianami lub zmienionym stanem sesji nadal wymagają oczyszczenia przed ponownym użyciem. Kasa nadal potwierdza połączenie w ramach komunikacji tam i z powrotem z serwerem.
Więcej informacji można znaleźć w artykule Cykl życia połączenia.
Poprawki błędów
Kopiowanie masowe po aktualizacji pakietów
Sterownik wymaga mssql-python-rs==0.4.0. Zaktualizowane środowisko wykonawcze naprawia niepowodzenia kopiowania zbiorczego spowodowane układem natywnego modułu po aktualizacji. Instalacja lub aktualizacja mssql-python wraz z zależnościami automatycznie instaluje pasujące środowisko uruchomieniowe.
Więcej informacji można znaleźć w artykule Wymagania dotyczące zależności.
Kopiuj masowo Unicode, nazwy docelowe i precyzję daty i godziny
bulkcopy() i bulkcopy_arrow() poprawnie obsługują tekst UTF-8 oraz eliminują utratę ułamków sekund podczas ładowania wartości datetime2. Na przykład nanosekundowe znaczniki czasowe Arrow mogą zachowywać siódmą cyfrę ułamkową w docelowym typie datetime2(7), zamiast być skracane do mikrosekund. Obiekty Pythona datetime pozostają ograniczone do mikrosekundowej precyzji.
Nazwa docelowa z więcej niż trzema częściami powoduje teraz RuntimeError podczas wyszukiwania metadanych, zanim zostaną wysłane wiersze, zamiast doprowadzić do błędu po stronie serwera.
Więcej informacji można znaleźć w Kopia zbiorcza i integracja z Apache Arrow.
Ograniczone odzyskiwanie z nieodpowiadających połączeń puli
Przy domyślnym msodbcsql18 dostawcy proces checkout stosuje tymczasowy natywny limit czasu operacji połączenia podczas walidacji połączeń w puli. Stosuje dodatni timeout logowania lub 15 sekund, jeśli timeout logowania jest zerowy lub nieokreślony. Po nieudanej walidacji sterownik odrzuca to połączenie i próbuje zalogować się ponownie zamiast weryfikować każde pozostałe bezczynne połączenie.
Wielokrotne operacje walidacyjne, czyszczenie i zastępcze logowanie mogą przekroczyć tymczasowy limit czasu. To nie jest całkowita walidacja ani connect() ostateczny termin. Pozyskiwanie tokena Microsoft Entra ID nie jest ograniczone limitem czasu logowania.
Dostawca opt-in mssql-odbc nie gwarantuje tych samych granic walidacji. Więcej informacji można znaleźć w sekcji Sprawdzenia stanu połączenia oraz ograniczenia natywnych dostawców.
Dokładna liczba wierszy po nextset()
Cursor.nextset() odświeża rowcount dla każdego kolejnego wyniku modyfikacji danych w partii, procedurze składowanej lub pętli Transact-SQL (T-SQL). Wynik generujący wiersz zaczyna się od rowcount == -1 przed pobraniem. Wcześniejsze wydania zachowywały liczbę dla pierwszej instrukcji przy przechodzeniu do innego wyniku.
Więcej informacji można znaleźć w artykule Liczba rzędów.
Kompatybilność DB-API z Timestamp()
Argument microsecond do Timestamp() jest opcjonalny i domyślnie wynosi zero. Sześcioargumentowe Timestamp(year, month, day, hour, minute, second) wywołanie działa teraz zgodnie z definicją PEP 249.
Więcej informacji zawiera DB-API timestamp constructor.
Pełne szczegóły wydania można znaleźć w wersji mssql-python 1.17.0.
mssql-python 1.16.0
Data wydania: październik 2026
Enhancements
Wsparcie dla Python 3.15
Indeks pakietów Python (PyPI) ma teraz pakiety wheel dla Python 3.15 na Windows, Linux i macOS. Wydanie zawiera 41 pakietów wheel, które obejmują Python 3.10 do 3.15.
Więcej informacji można znaleźć w cyklu eksploatacji pomocy technicznej.
Pakiety Conda
Sterownik jest teraz opublikowany w kanale microsoft w serwisie Anaconda.org. Pakiet conda to jeden samodzielny pakiet, który zawiera pliki binarne sterownika ODBC oraz środowisko uruchomieniowe Rust:
conda install -c microsoft mssql-python
Na Linuksie pakiet conda wymaga wersji glibc 2.34 i nowszych. W systemie macOS wymagany jest system macOS 15 lub nowszy. Pełną listę platform i wymagań można znaleźć w artykule Instalacja z conda.
Dostawca natywny typu opt-in mssql-odbc
Możesz teraz wybrać dostawcę ODBC opartego na Rust o nazwie mssql-odbc. Microsoft ODBC Driver 18 (msodbcsql18) pozostaje domyślny. Wybierz dostawcę przed pierwszym połączeniem za pomocą zmiennej środowiskowej MSSQL_PYTHON_NATIVE_PROVIDER lub atrybutu mssql_python.native_provider. Kod aplikacji się nie zmienia.
Więcej informacji można znaleźć w artykule Korzystanie ze sterownika mssql-odbc (wersja zapoznawcza).
Dostęp do wierszy w stylu słownikowym z użyciem row._mapping
Każda z Row nich ma teraz właściwość tylko _mapping do odczytu, która mapuje nazwy kolumn na wartości. Użyj dict(row._mapping) do konwersji wiersza do słownika bez łączenia wartości za pomocą cursor.description.
Więcej informacji można znaleźć w artykule Obiekty wierszowe.
Środowisko uruchomieniowe Rust jest dostarczane w pakiecie mssql-python-rs
Runtime Rust, który obsługuje funkcję bulk copy, jest teraz dostarczany w osobnym pakiecie mssql-python-rs, dopasowanym wersją, zamiast wewnątrz pakietu mssql-python wheel. Polecenie pip install mssql-python instaluje go automatycznie. Wersja 0.3.0 pakietu korzysta ze stabilnych wheeli interfejsu binarnego aplikacji (ABI) CPython, więc każdy wheel obsługuje wersje Python 3.10 i nowsze.
Więcej informacji można znaleźć w artykule Wymagania dotyczące zależności.
Zaktualizowany mssql-python-odbc pakiet towarzyszący
Sterownik wymaga mssql-python-odbc teraz wersji 18.6.2.2. Pakiety wheel dla Linuksa są podzielone według biblioteki C, więc środowiska glibc i musl (Alpine Linux) instalują tylko odpowiadające sobie pliki binarne ODBC Driver 18.6.
Szybsze operacje pobierania
Operacje pobierania spędzają mniej czasu w Pythonie:
-
fetchmany()orazfetchall()budowaćRowobiekty na natywnej ścieżce pobierania, gdy połączenie nie ma konwerterów wyjściowych i wartości UniqueIdentifier nie są konwertowane na ciągi znaków. -
date,timeidatetimewartości są konstruowane przy mniejszym nakładzie. - Metadane kolumn są ponownie wykorzystywane dla bieżącego zbioru wyników zamiast być opisywane ponownie przy każdym pobieraniu.
- Czyste pobrania omijają powtarzające się skanowania diagnostyczne.
- Indeksy całkowitoliczbowe, takie jak
row[0], wykorzystują bezpośrednią ścieżkę wyszukiwania. -
fetchval()pomija wywołania debugowania, gdy logowanie debugowania jest wyłączone.
Nie jest potrzebna zmiana aplikacji.
Poprawki błędów
Procesy Windows mogą ulegać awarii podczas wyłączania
Sterownik mógł zwolnić swój uchwyt środowiska ODBC po finalizacji Python, co groziło błędem naruszenia dostępu po zakończeniu procesu Windows. Uchwyt nie jest już zwalniany po finalizacji.
Znaki wiodące U+FEFF i U+FFFE były usuwane z pobieranego tekstu
Gdy pobierany ciąg zaczynał się od U+FEFF lub U+FFFE, sterownik traktował ten punkt kodowy jako znak kolejności bajtów i usuwał go. Sterownik zwraca teraz wartość pełną dla typów ograniczonych, takich jak nvarchar(n) i varchar(n). Typy dużych wartości, takie jak , nvarchar(max) nie są objęte tą poprawką: wiodący U+FEFF jest nadal usuwany, a wiodący U+FFFE powoduje dekodowanie wartości z nieprawidłową kolejnością bajtów.
Połączenia z puli mogły utrzymać otwartą pustą transakcję
Połączenie w puli może wrócić do puli z otwartą pustą transakcją lub wyłączonym automatycznym zatwierdzaniem. Sterownik wycofuje teraz transakcję na fizycznym połączeniu i włącza automatyczne zatwierdzanie przed zwróceniem połączenia do puli. Jeśli to czyszczenie się nie powiedzie, sterownik odrzuca połączenie zamiast umieszczać je w puli.
Więcej informacji można znaleźć w artykule Pula połączeń.
Parametry typów zdefiniowane przez użytkownika nie miały metadanych typu
Parametry, które deklarujesz jako typy zdefiniowane przez użytkownika SQL Server za pomocą setinputsizes() i SQL_SS_UDT (-151), takie jak geography i geometry, teraz pobierają metadane swojego typu z serwera przed przypisaniem. Poprawka obejmuje wartości None i ponownie użyte instrukcje dla zadeklarowanych parametrów. Przekazanie niezadeklarowanego None do kolumny typu zdefiniowanego przez użytkownika w ponownie używanym wyrażeniu nadal kończy się niepowodzeniem.
setencoding() ignorował nieobsługiwane żądania bez ostrzeżenia
Sterownik zawsze wysyła instrukcje Transact-SQL (T-SQL) i parametry str jako UTF-16LE. Wywołanie setencoding() z kodowaniem lub ctype innym niż UTF-16LE przy użyciu SQL_WCHAR powoduje teraz wygenerowanie UserWarning zamiast być po cichu ignorowane. Wywołanie setencoding() bez argumentów przywraca domyślne dane bez ostrzeżenia.
Więcej informacji można znaleźć w sekcji Zarządzaj połączeniami.
Natywne logowanie mogło interpretować metadane jako dyrektywy formatowe
Po włączeniu natywnego logowania wartości dostarczane przez serwer, takie jak metadane kolumn Arrow, były przekazywane do natywnego loggera jako ciągi formatowe. Sterownik urządzenia teraz rejestruje te wartości jako dosłowny tekst.
Kopia masowa nie ujmowała konsekwentnie identyfikatorów docelowych w cudzysłów
Kopiowanie zbiorcze teraz konsekwentnie ujmuje w cudzysłowy i stosuje znaki ucieczki dla nazw tabel docelowych, nazw kolumn oraz sortowań. Nazwy wieloczęściowe i nazwy ujęte w nawiasy, które zawierają spacje lub znaki ], działają. Niepoprawna nazwa, taka jak niezamknięty nawias lub brakująca nazwa tabeli, powoduje błąd przed wysłaniem jakichkolwiek wierszy.
Więcej informacji można znaleźć w sekcji Kopia zbiorcza.
mssql-python 1.15.0
Data wydania: wrzesień 2026
Enhancements
setinputsizes() obsługa parametrów działa w natywnym kodzie
Obsługa parametrów setinputsizes() odbywa się teraz za pośrednictwem natywnego potoku wykonywania C++ zamiast wywołań Pythona dla każdego parametru. Szerokie, wsadowe i często wykonywane instrukcje parametryzowane wymagają mniej czasu na przetwarzanie parametrów po stronie Pythona. Nie jest potrzebna zmiana aplikacji.
Aby uzyskać więcej informacji, zobacz Mapowania typów danych.
Binary() akceptuje memoryview obiekty
Binary() teraz akceptuje memoryview jako dane wejściowe binarne, więc możesz przekazać widok bufora bez kopiowania bez uprzedniego konwertowania go na bytes.
Więcej informacji można znaleźć w artykule Dane binarne.
Stałe typu SQL Server są dostępne w mssql_python module
Stałe typu SQL Server są teraz dostępne bezpośrednio z modułumssql_python, co ułatwia ich znalezienie podczas deklarowania typów parametrów lub odczytu metadanych typów.
Aby uzyskać więcej informacji, zobacz Mapowania typów danych.
Poprawki błędów
Jednoczesne logowanie mogłoby zablokować proces
Natywne ścieżki logowania pobierały GIL i wewnętrzne mutexy w niespójnej kolejności, więc aplikacja wielowątkowa z włączonym logowaniem sterowników mogła się zablokować. Kolejność blokad została poprawiona.
Pakiety wheel dla Windows ARM64 nie zawierały natywnego rdzenia ARM64
Pakiet wheel dla Windows ARM64 nie zawierał odpowiadającego pliku binarnego ARM64 mssql_py_core, co wpływało na kopiowanie zbiorcze na tej platformie. Wheel obecnie dostarcza wersję ARM64.
Więcej informacji można znaleźć w sekcji Kopia zbiorcza.
Dołączone biblioteki DLL systemu Windows korzystały ze ścieżki wyszukiwania procesu
Biblioteki DLL sterownika i uwierzytelniania dołączone do pakietu są teraz ładowane z katalogów lokalnych pakietu. Natywne zależności są rozpoznawane bez zależności od konfiguracji ścieżki wyszukiwania obejmującej cały proces, która była zawodna w niektórych środowiskach wdrożeniowych.
Decimal parametry były wiązane inaczej w zależności od ich wartości
Parametr SQL_NUMERIC jest teraz wiązany jako Decimal niezależnie od jego wartości w czasie wykonywania, więc typowanie parametru jako dziesiętnego pozostaje takie samo dla wszystkich wartości i ścieżek wykonywania.
Aby uzyskać więcej informacji, zobacz Dane dziesiętne i pieniężne.
Wiązanie parametrów wykorzystało przestarzałe identyfikatory typów ODBC 2.x
Parametry typowane korzystają teraz z identyfikatorów typów ODBC 3.x zamiast ich odpowiedników ODBC 2.x, co pozwala uniknąć niezgodności z bieżącymi konfiguracjami sterowników.
Connection.getinfo(SQL_DATABASE_NAME) zwrócił wartość niezdekodowaną
Wartość zwracana dla SQL_DATABASE_NAME jest teraz zdekodowana, więc nazwa bazy danych wraca jako tekst Python.
Więcej informacji można znaleźć w artykule Zarządzanie połączeniami.
Czyszczenie kursora uległo awarii podczas zamykania interpretera
Połączenie zawierające kursory znajdujące się w różnych stanach cyklu życia porządkowało je w takiej kolejności, że mogło to doprowadzić do awarii procesu, gdy część tych działań była wykonywana podczas zamykania interpretera. Wyłączanie kończy się teraz normalnie.
Więcej informacji można znaleźć w artykule Zarządzanie kursorami.
mssql-python 1.14.0
Data wydania: sierpień 2026 r.
Enhancements
Wykrywanie parametrów i wiązanie uruchamiane w natywnym kodzie
Wykrywanie typów parametrów i wiązanie parametrów odbywają się teraz w ramach jednego natywnego potoku zamiast osobnych wywołań w Pythonie dla każdego parametru. Ta zmiana eliminuje istotne wąskie gardło wydajności, zapewniając większą poprawę przepustowości w całym procesie, zwłaszcza w większych operacjach, takich jak zbiorcze wstawianie. Nie jest potrzebna zmiana aplikacji.
Poprawki błędów
Argument timeout funkcji connect() ustawia limit czasu zapytania zamiast limitu czasu uwierzytelniania
Argument timeout teraz ustala SQL_ATTR_LOGIN_TIMEOUT i ogranicza próbę uwierzytelniania, co jest opisane w nazwie argumentu i dokumentacji. We wcześniejszych wersjach była to limitacja zapytań na każde zdanie, więc connect(timeout=30) nie ograniczała czasu trwania próby połączenia, a zapytania przerywano po 30 sekundach. Limit czasu zapytania dla każdej instrukcji pozostaje dostępny jako właściwość Connection.timeout.
Ważna
Jeśli przekazałeś timeout do connect(), aby przerwać długotrwałe zapytania, takie zachowanie już nie występuje. Zamiast tego ustaw Connection.timeout. To samo dotyczy sytuacji, gdy używasz connect(timeout=), aby wydłużyć limit czasu nawiązania połączenia, którego bulkcopy() używa do swojego połączenia wewnętrznego: ustaw Connection.timeout przed utworzeniem kursora.
Aby uzyskać więcej informacji, zobacz Limit czasu połączenia.
timeout=0 zostało odrzucone bulkcopy()
Wartość timeout parametru 0 spowodowała błąd walidacji, mimo że 0 oznacza brak limitu czasu w bazowym interfejsie API kopiowania zbiorczego. Metoda teraz akceptuje 0 i wyłącza limit czasu operacji. Wartości ujemne, niecałkowite i booleowskie są nadal odrzucane.
Więcej informacji można znaleźć w sekcji Kopia zbiorcza.
Operacja czyszczenia zastąpiła oryginalny wyjątek podczas pobierania z Arrow
Gdy pobieranie z czytnika Arrow kończyło się niepowodzeniem, procedura czyszczenia sterownika zgłaszała drugi błąd, który zastępował błąd pierwotny, przez co wywołujący widzieli błąd czyszczenia zamiast rzeczywistej przyczyny niepowodzenia pobierania. Proces czyszczenia teraz najpierw sprawdza stan kursora i zachowuje oryginalny wyjątek.
executemany() Błędy konwersji dziesiętnej uwzględniały wartości parametrów
Awaria konwersji typu decimal w executemany() powodowała zgłoszenie problematycznej wartości za pośrednictwem wyjątku w łańcuchu, co mogło spowodować zapisanie danych klientów w logach aplikacji i systemach monitorowania. Błąd teraz raportuje tylko indeks wiersza, indeks kolumn oraz typ wartości.
Aby uzyskać więcej informacji, zobacz Obsługa błędów.
Zbiorcze kopiowanie odrzuconych typów Arrow View
bulkcopy_arrow() nie mógł obsługiwać tablic Arrow View o zmiennej długości, więc kolumny Polars string_view musiały być najpierw konwertowane za pomocą DataFrame.to_arrow(). Wartości String View i wartości NULL są teraz przekazywane bezpośrednio za pośrednictwem Arrow C Data Interface.
Więcej informacji można znaleźć w artykule integracja Polars.
Ładowanie rozszerzeń Windows wykorzystywało architekturę procesora hosta
W systemie Windows sterownik wybierał swoje natywne rozszerzenie na podstawie procesora hosta, a nie uruchomionego interpretera, więc Python x64 na hoście ARM64 był ładowany za pośrednictwem ścieżki rezerwowej i wypisywał komunikaty na standardowe wyjście (stdout). Moduł ładujący teraz określa architekturę na podstawie interpretera i zgłasza mechanizmy awaryjne jako ostrzeżenia.
mssql-python 1.13.0
Data wydania: sierpień 2026 r.
Enhancements
Pliki binarne sterownika ODBC są dostarczane tylko w mssql-python-odbc
Wersja 1.13.0 usuwa awaryjne libs/ z koła mssql-python i deklaruje mssql-python-odbc==18.6.2.1 w install_requires. Komenda pip install mssql-python nadal generuje działający sterownik. Jawnie zainstaluj mssql-python-odbc podczas instalacji za pomocą --no-deps lub z prywatnego indeksu, który go nie odzwierciedla.
Aby uzyskać więcej informacji, zobacz Instalacja.
Kopia masowa ze źródeł Apache Arrow
Nowa cursor.bulkcopy_arrow() metoda ładuje dane już w formacie Apache Arrow, bez konieczności konwersji każdego wiersza na obiekty Python. Przepuszczenie źródła strzałki do bulkcopy() teraz podnosi TypeError.
Więcej informacji znajdziesz w sekcjach integracja Apache Arrow oraz kopiowanie zbiorcze.
token_providerparametr dla poświadczeń Microsoft Entra
Funkcja connect() i klasa Connection przyjmują argument token_provider, więc możesz przekazać obiekt poświadczeń, taki jak DefaultAzureCredential, zamiast określać tryb uwierzytelniania w parametrach połączenia. Ten argument nie może być używany jednocześnie ze słowem kluczowym Authentication ani z tokenami przekazywanymi przez attrs_before i obsługuje tylko zakres komercyjnej chmury Azure.
Aby uzyskać więcej informacji, zobacz Microsoft Entra authentication (Uwierzytelnianie w usłudze Microsoft Entra).
Pulowanie połączeń uwzględniające tożsamość
Pula połączeń teraz rozdziela połączenia na podstawie tożsamości Microsoft Entra. We wcześniejszych wersjach pula połączeń była indeksowana wyłącznie według parametrów połączenia, więc mogła przydzielić żądaniu wysłanemu przez jednego użytkownika połączenie uwierzytelnione jako inny użytkownik. Sterownik pobiera token również tylko wtedy, gdy żądanie połączenia nie zostanie obsłużone z puli, oraz odświeża połączenie z puli, gdy do wygaśnięcia jego tokenu pozostało mniej niż 5 minut.
Więcej informacji można znaleźć w artykule Pula połączeń.
Poprawki błędów
executemany() wstawiono zero wierszy, gdy po pierwszym wierszu pojawiały się wartości NULL
executemany() Wywołanie, w którym mieszano numeryczne wartości nie-NULL i NULL, nie wstawiało żadnych wierszy i nie zgłaszało wyjątku, gdy pierwszy NULL pojawiał się po pierwszym wierszu. To zachowanie wpływało na parametry tinyint, smallint, int i float . Sterownik teraz inicjalizuje wskaźniki ODBC dla każdego parametru numerycznego o stałej szerokości przed wykonaniem tablicy.
Konwerter SQL_WVARCHAR wyjściowy przekształcał kolumny niebędące ciągami znaków
Zarejestrowanie pojedynczego konwertera ciągu znaków powodowało także konwersję wartości int, decimal i date, ponieważ sterownik domyślnie używał konwertera SQL_WVARCHAR dla każdej kolumny, która nie miała własnego konwertera. Sterownik korzysta teraz z tego mechanizmu awaryjnego tylko wtedy, gdy odwzorowany typ Pythona dla kolumny to str lub bytes.
Konwertery wyjściowe zarejestrowane za pomocą liczbowego kodu typu SQL nigdy nie działały
Konwertery zarejestrowane przy użyciu całkowitoliczbowego kodu typu SQL, takie jak SQL_DECIMAL, były przechowywane, ale nigdy nie były wywoływane, ponieważ sterownik uwzględniał w cursor.description wyłącznie typ Pythona. Sterownik najpierw wysyła kod całkowitoliczbowy, potem typ Python, a następnie awaryjne.SQL_WVARCHAR
Ważna
Jeśli zarejestrowałeś konwertery za pomocą całkowitego kodu SQL we wcześniejszej wersji, te konwertery zaczynają działać po aktualizacji. Przejrzyj je przed wdrożeniem, ponieważ wartości kolumn, które wcześniej przechodziły bez zmian, są teraz przekształcone.
Więcej informacji można znaleźć w artykule Niestandardowe konwertery typów.
Zamknięcie czytnika Arrow nie uwalniało kursora po stronie serwera
Zamknięcie czytnika Arrow pozostawiało przydzielony kursor po stronie serwera oraz nadrzędny obiekt Cursor w niespójnym stanie, ponieważ cursor.arrow_reader() zwracał surowy pyarrow.RecordBatchReader. Metoda zwraca teraz obiekt opakowujący, którego metoda close() zwalnia kursor po stronie serwera i resetuje stan kursora, a obiekt ten działa również jako menedżer kontekstu.
Więcej informacji można znaleźć w artykule o integracji z Apache Arrow.
Częściowo zainicjalizowany kursor podniesiony AttributeError w Cursor.__del__
Kursor, którego inicjalizator zawiódł, wywoływał wyjątek AttributeError jako nie do podnieśienia podczas garbage collection.
Cursor.__init__ zgłosił wyjątek przed ustawieniem atrybutów closed i hstmt, które __del__ następnie próbował odczytać. Inicjalizator teraz ustawia oba atrybuty przed jakimkolwiek kodem, który może się podnieść, i __del__ chroni swoje wywołanie logowania, aby pozostać bezpieczne podczas wyłączania interpretera.
mssql-python 1.12.0
Data wydania: lipiec 2026
Enhancements
Samodzielny mssql-python-odbc pakiet towarzyszący
Pliki binarne sterownika ODBC są teraz publikowane osobno jako mssql-python-odbc, pomocniczy pakiet zawierający wyłącznie dane, przypisany do wersji 18.6.2. Nie musisz zmieniać żadnego kodu, bo pip install mssql-python instaluje się z nim pakiet towarzyszący. Natywny moduł ładujący najpierw wybiera pakiet towarzyszący, a jeśli nie jest on dostępny, używa plików binarnych dołączonych do pakietu mssql-python wheel.
Aby uzyskać więcej informacji, zobacz Instalacja.
Poprawki błędów
cursor.bulkcopy() teraz używa limitu czasu połączenia nadrzędnego
bulkcopy() teraz używa limitu czasu połączenia swojego nadrzędnego połączenia, który ustawisz za pomocą connect(..., timeout=<seconds>). Wcześniej oddzielne połączenie, które otwiera kopia masowa, wykorzystywało zakodowany na stałe 15-sekundowy limit połączenia, którego nie dało się obejść w Pythonie. Połączenie nadrzędne utworzone za pomocą timeout=0 nadal ma domyślną wartość 15 sekund.
Więcej informacji można znaleźć w sekcji Kopia zbiorcza.
cursor.bulkcopy() obsługuje kolumny typu zdefiniowanego przez użytkownika CLR
cursor.bulkcopy() wcześniej kończył się niepowodzeniem przy użyciu Protocol Error: Unsupported TDS type for bulk copy: 0xF0 w przypadku dowolnej kolumny docelowej używającej typu zdefiniowanego przez użytkownika środowiska Common Language Runtime (CLR), w tym wbudowanych typów geography, geometry i hierarchyid. Sterownik teraz mapuje kolumny CLR UDT na varbinary(max) na przewodzie i przesyła dostarczone bajty jako ładunek IBinarySerialize UDT. Poprawka pojawia się w mssql_py_core wersji 0.1.7.
Więcej informacji znajduje się w artykułach Kopiowanie masowe i Mapowania typów danych.
mssql-python 1.11.0
Data wydania: lipiec 2026
Enhancements
Ulepszona semantyka menedżera kontekstu
with connection: Teraz zatwierdza transakcję, gdy blok zostanie czysto zakończony, i cofa ją, gdy wyjątek opuści blok.
Aby uzyskać więcej informacji, zobacz Zarządzanie transakcjami.
Poprawki błędów
- Naprawiono zakleszczenie GIL w ścieżce zamykania ODBC (
conn.close()icursor.close()) oraz wSQLDescribeParamdla parametrów o wartościNonew konfiguracjach tunelu SSH i przekazywania w procesie. - Naprawiono parametry NULL
BINARYiVARBINARYw tabelach tymczasowych i zmiennych tabelowych. Gdy automatyczne określanie typu kończy się niepowodzeniem, sterownik generuje ostrzeżenie języka Python z jasnymi wskazówkamicursor.setinputsizes(). - Naprawiono problem z
import mssql_pythonna Apple Silicon przy czystej instalacji (regresja w wersji 1.8.0). Dołączone zależności ODBC dylib są teraz przepisywane ponownie dla architektur zarównoarm64, jak ix86_64. - Naprawiono zakleszczenie GIL w rdzeniu Rust, które powodowało zawieszanie się operacji kopiowania zbiorczego podczas uwierzytelniania za pomocą
Authentication=ActiveDirectoryServicePrincipal.
mssql-python 1.10.0
Data wydania: czerwiec 2026
Enhancements
ActiveDirectoryServicePrincipal wsparcie dla kopiowania masowego
cursor.bulkcopy() teraz obsługuje Authentication=ActiveDirectoryServicePrincipal, więc możesz wstawiać masowo z poświadczeniami Service Principal.
Więcej informacji można znaleźć w artykule Kopiowanie zbiorcze i uwierzytelnianie Microsoft Entra.
Poprawki błędów
- Naprawiono obsługę danych niebędących ASCII
VARCHARiCHARw ścieżce pobierania Arrow. - Stałe przerwy połączeń podczas operacji ładowania masowego.
mssql-python 1.9.0
Data wydania: czerwiec 2026
Enhancements
Obiekty wierszy w kopiowaniu zbiorczym
cursor.bulkcopy() teraz akceptuje pobrane obiekty Row bezpośrednio, zamiast wymagać ręcznej konwersji krotek.
Aby uzyskać więcej informacji, zobacz Kopiowanie zbiorcze i Obiekty wierszy.
Poprawki błędów
- Obudowa z kółkami stałymi, więc
simdutfzawsze jest statycznie połączona. - Stałe duże
DECIMALwstawki wexecutemany(). - Naprawiono nieprawidłowe określanie typu zastępczego dla parametrów NULL.
- Naprawiono cykle serializacji i deserializacji wyjątków.
- Naprawiono
nextset(), aby zachowywałPRINTkomunikaty między zestawami wyników. - Poprawiono obsługę
Roww ścieżce awaryjnejexecutemany()data-at-execution. - Naprawiono sprawdzanie typów metody fetch dla narzędzi do analizy statycznej.
mssql-python 1.8.0
Data wydania: maj 2026
Enhancements
Wsparcie ActiveDirectoryMSI dla kopiowania masowego
cursor.bulkcopy() teraz obsługuje Authentication=ActiveDirectoryMSI dla zarządzanych tożsamości przypisanych przez system i przez użytkownika.
Więcej informacji można znaleźć w artykule Kopiowanie zbiorcze i uwierzytelnianie Microsoft Entra.
Indeksowanie wierszy za pomocą klucza tekstowego
Teraz możesz uzyskać dostęp do wartości wierszy według nazwy kolumny, na przykład row["col"], oprócz indeksowania pozycyjnego i dostępu do atrybutów.
Więcej informacji można znaleźć w artykule Obiekty wierszowe.
Pakietowa aktualizacja sterownika ODBC
Dołączony sterownik Microsoft ODBC dla SQL Server został zaktualizowany do wersji 18.6.2.1.
Poprawki błędów
- Naprawiono problemy z odroczonym czasem życia atrybutów połączenia w uwierzytelnianiu opartym na tokenach.
- Naprawiono powtarzające się parsowanie parametry połączenia w ścieżce uwierzytelniania.
- Stałe
executemany()adnotacje typów dla wejść sekwencji.
mssql-python 1.7.1
Data wydania: maj 2026
Enhancements
Rozszerzone pokrycie kół i poprawa osiągów
Ta wersja obejmuje:
- Felgi kompatybilne z RHEL 8.
- Przywróciłem koła macOS Python 3.10
universal2. - Ulepszono obsługę UTF-16 za pośrednictwem
simdutf. - Zoptymalizowana
execute()ścieżka gorąca.
Wpływ na wydajność: Przepustowość wsadowego wykonywania poprawia się dzięki optymalizacjom ścieżek gorących w metodzie execute() .
Aby uzyskać więcej informacji, zobacz Instalacja.
Poprawki błędów
- Naprawiono niepowodzenia uwierzytelniania, tak aby zgłaszały wyjątki DB-API
mssql_pythonzamiastRuntimeError. - Rozszerzono zwalnianie GIL podczas blokujących wywołań ODBC dotyczących wykonywania, pobierania, transakcji i atrybutów połączenia.
- Naprawiono
executemany()problemy występujące, gdy wartości dziesiętne zmieniają znak. - Naprawiono niespójne dekodowanie CP1252
VARCHARna różnych platformach. - Naprawiono
cursor.bulkcopy()niepowodzenia spowodowane pustymi ciągami w kolumnachNVARCHAR(MAX)iVARCHAR(MAX).
Note
Wersja 1.7.0 została wycofana z powodu problemów z publikacją. Użyj wersji 1.7.1 lub nowzej.
mssql-python 1.6.0
Data wydania: kwiecień 2026
Enhancements
Oczyszczanie parametrów połączenia oparte na parserze
Sanityzacja łańcuchów połączeń obecnie wykorzystuje parser zamiast wyrażeń regularnych, więc ciągi połączeń zawierające specjalne znaki w polach hasła i wartości nawiasowe są poprawnie parsowane.
Aby uzyskać więcej informacji, zobacz Parametry połączenia.
Poprawki błędów
- Naprawiono zwolnienie GIL podczas blokowania operacji łączenia i rozłączania ODBC.
- Naprawiono awarie związane z
setinputsizes()oraz podpowiedziamiSQL_DECIMALiSQL_NUMERIC. - Naprawiono nieprawidłowe
fetchone()zachowanie metod katalogowych ODBC. - Naprawiono błędy nieprawidłowego stanu kursora, gdy używano
reset_cursor=False. - Stałe
executemany()wskazówki typu dla sekwencji parametrów opartych na mapowaniu. - Dodano ochronę przejścia ścieżki dla
setup_logging(log_file_path=...).
mssql-python 1.5.0
Data wydania: kwiecień 2026
Nowe funkcje
Obsługa pobierania Apache Arrow
Trzy nowe metody kursorów zapewniają wysokowydajne pobieranie danych kolumnowych za pośrednictwem interfejsu danych Arrow C:
-
cursor.arrow()Zwraca pełnepyarrow.Table. -
cursor.arrow_batch()Zwraca pojedynczypyarrow.RecordBatch. -
cursor.arrow_reader()Zwracapyarrow.RecordBatchReaderdo streamingu.
Te metody nie tworzą obiektu Python dla każdej wartości. Pełną dokumentację można znaleźć w artykule o integracji z Apache Arrow.
Obsługa typu sql_variant
Sterownik wykrywa teraz kolumny sql_variant podczas pobierania, ustala ich bazowy typ i zwraca wartości Pythona o poprawnym typie zamiast surowych bajtów.
Note
sql_variant kolumny korzystają ze ścieżki pobierania strumieniowego, co może mieć niewielki wpływ na wydajność w porównaniu z kolumnami typu stałego.
Aby uzyskać więcej informacji, zobacz Mapowania typów danych.
Natywne wsparcie UUID
Nowe native_uuid ustawienie decyduje, czy UNIQUEIDENTIFIER kolumny są zwracane jako uuid.UUID obiekty (domyślnie), czy jako ciągi znaków wielkich liter zgodnych z pyodbc. Konfiguruj to na poziomie modułu lub dla każdego połączenia.
Więcej informacji można znaleźć w sekcji Konfiguracja modułu.
Publiczny eksport klasy rzędowej
Klasa Row jest teraz eksportowana na poziomie głównym na potrzeby adnotacji typów.
Więcej informacji można znaleźć w artykule Obiekty wierszowe.
Poprawki błędów
- Naprawiono fałszywe wykrycia
?w identyfikatorach ujętych w nawiasy, literałach łańcuchowych i komentarzach. - Naprawiono wiązanie parametrów NULL dla kolumn
VARBINARY(nie powoduje już błędów niejawnej konwersji). - Naprawiono problem utraty mikrosekund przez wartości
datetime.timepodczas konwersji tam i z powrotem w kolumnach odTIME(1)doTIME(7). - Naprawiono ścieżkę pobierania Arrow, aby poprawnie uwzględniała ułamki sekund dla kolumn
TIME. - Naprawiłem kopiowanie masowe za pomocą metod uwierzytelniania Microsoft Entra ID (przestarzałe pola poświadczeń nie powodują już błędów walidacji).
- Buforowano instancje poświadczeń Azure Identity na poziomie modułu w celu zwiększenia wydajności uwierzytelniania.
mssql-python 1.4.0
Data wydania: luty 2026
Nowe funkcje
Wsparcie dla kopiowania masowego
Wysokowydajne zbiorcze ładowanie danych jest teraz dostępne za pośrednictwem cursor.bulkcopy(). Metoda akceptuje opcje dla batch_size, timeout, column_mappings, keep_identity, check_constraints, table_lock, keep_nulls, fire_triggersoraz .use_internal_transaction
Więcej informacji można znaleźć w sekcji Kopia zbiorcza.
Ulepszenia
- Optymalizacje wydajności dla dużych zbiorów wyników.
- Zmniejszone zużycie pamięci podczas operacji wsadowych.
- Ulepszone komunikaty o błędach dotyczące niepowodzeń podczas kopiowania zbiorczego.
mssql-python 1.3.0
Data wydania: styczeń 2026
Nowe funkcje
Klasa ustawień
Skonfiguruj zachowanie całego modułu za pomocą nowej klasy Settings, która zawiera ustawienie lowercase dla nazw kolumn w cursor.description.
Więcej informacji można znaleźć w sekcji Konfiguracja modułu.
Ulepszenia
- Lepsza obsługa limitu czasu połączenia podczas przełączania awaryjnego Azure SQL.
- Poprawa kompatybilności z Python 3.13.
MSSQL-Python 1.2.0
Data wydania: styczeń 2026 r.
Nowe funkcje
Metody odkrywania schematów
Nowe metody kursora badają metadane bazy danych: tables(), , primaryKeys()columns(), foreignKeys(), procedures(), , statistics()oraz getTypeInfo().
Więcej informacji można znaleźć w sekcji odkrywanie schematów.
Ulepszenia
- Ulepszone buforowanie metadanych dla powtarzających się zapytań schematów.
- Lepsza obsługa kolumn obliczeniowych w wynikach
columns().
mssql-python 1.1.0
Data wydania: grudzień 2025
Nowe funkcje
Niestandardowe przetworniki wyjściowe
Rejestruj niestandardowe funkcje do przekształcania wartości kolumn w trakcie pobierania za pomocą add_output_converter(), get_output_converter(), remove_output_converter() i clear_output_converters().
Więcej informacji można znaleźć w artykule Niestandardowe konwertery typów.
Ulepszenia
- Lepsze komunikaty o błędach przy niepowodzeniach konwersji typów.
- Obsługa funkcji konwerterów zwracających
None.
MSSQL-Python 1.0.0
Data wydania: listopad 2025 r.
Pierwsze wydanie GA
Pierwsza ogólnodostępna wersja mssql-python, natywnego sterownika Python Microsoft dla SQL Server.
Więcej informacji można znaleźć w sterowniku mssql-python.
Podstawowe funkcje
- Architektura DDBC: bezpośrednie połączenie z bazą danych bez konieczności instalacji sterownika ODBC.
- zgodność z DB-API 2.0: Standardowy interfejs bazy danych Python.
- Pula połączeń: Wbudowane zarządzanie pulą połączeń.
- Uwierzytelnianie Microsoft Entra: Pełne wsparcie dla uwierzytelniania opartego na tożsamości Azure.
- Szyfrowanie TLS: Bezpieczne połączenia dzięki walidacji certyfikatów.
Funkcje połączenia
- 21 słów kluczowych ciągu połączenia
- 9 trybów uwierzytelniania (SQL, Windows oraz 7 metod Microsoft Entra ID).
- Sterowanie trybem autocommit.
- Metody wykonania:
execute(),executemany(), orazbatch_execute(). - Atrybuty połączenia za pomocą
set_attr()igetinfo(). - Wsparcie dla menedżera kontekstu.
Funkcje kursora
- Standardowe metody pobierania:
fetchone(),fetchmany(), .fetchall() - Metody rozszerzone:
fetchval(), .skip() - Metody wykonania:
execute()orazexecutemany(). - Obiekty wierszowe z dostępem do atrybutów i indeksów.
- Nawigacja po wielu zestawach wyników za pomocą
nextset().
Obsługa typów danych
- Wszystkie natywne typy SQL Server.
- Mapowania typu Python ↔SQL.
- Stałe typu SQL do typowania jawnego (na przykład
mssql_python.SQL_DECIMAL). - Obsługa wartości NULL jak w Pythonie
None.
Obsługa transakcji
- Ręczne zatwierdzanie i wycofywanie.
- Tryb automatycznego zatwierdzania zmian.
- Kontrola poziomu izolacji.
- Wykrywanie i obsługa zakleszczeń.
Tryby uwierzytelniania
| Mode | Opis |
|---|---|
| Uwierzytelnianie programu SQL Server | Nazwa użytkownika i hasło |
| uwierzytelnianie Windows | Trusted_Connection |
| ActiveDirectoryDefault | DefaultAzureCredential |
| ActiveDirectoryInteractive | Logowanie przez przeglądarkę |
| ActiveDirectoryDeviceCode | Przepływ kodu urządzenia |
| ActiveDirectoryPassword | Microsoft Entra — nazwa użytkownika i hasło (przestarzałe; używa ROPC) |
| ActiveDirectoryMSI | Tożsamość zarządzana |
| ActiveDirectoryServicePrincipal | Główna usługa |
| ActiveDirectoryIntegrated | Windows Kerberos |
Upgrade
Z pyodbc
Szczegółowe wskazówki dotyczące migracji znajdują się w artykule Migrate from pyodbc.
Kluczowe różnice:
- Obsługiwane są zarówno style parametrów
?(qmark), jak i%(name)s(pyformat). Twoje istniejące?zapytania działają bez zmian. - Brak metody
callproc(). Zamiast tego używaj instrukcjiEXECUTE. - Wbudowane łączenie połączeń.
- Brak zewnętrznej zależności sterownika ODBC.
Z pymssql
Szczegółowe wskazówki dotyczące migracji znajdziesz w artykule Migrate from pymssql.
Kluczowe różnice:
- Zastąp
%si%dmarkery parametrów na?lub%(name)s. - Zamiast argumentów pozycyjnych używaj parametry połączenia.
- Brak zależności od FreeTDS.
- Wiele współbieżnych kursorów na połączenie.
- Obiekty wierszowe z dostępem do atrybutów zastępują
as_dict=True.
Między wersjami mssql-python
Zaktualizuj sterownik, aby uzyskać nowe funkcje i poprawki.
pip install --upgrade mssql-python
Sprawdź notatki do wydania pod kątem jakichkolwiek drobnych zmian przed aktualizacją systemów produkcyjnych.
Roadmap
Nadchodzące funkcje i plan rozwoju znajdziesz w repozytorium GitHub.