Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il driver mssql-python è il driver ufficiale Python di Microsoft per SQL Server, database SQL di Azure, Istanza gestita di SQL di Azure e database SQL in Microsoft Fabric. Il driver è attivamente mantenuto su GitHub e rilasciato tramite PyPI. Questo articolo tratta di versioning, compatibilità della piattaforma e tempistiche di supporto.
Supporto delle versioni
Usa sempre l'ultima versione per ottenere nuove funzionalità, miglioramenti di prestazioni e correzioni di sicurezza. Le nuove funzionalità vengono aggiunte solo alla versione corrente.
Versione corrente
La versione 1.11.0 è l'attuale versione disponibile in generale.
Cronologia delle versioni
| Versione | Data di rilascio | Condizione | Funzionalità principali |
|---|---|---|---|
| 1.11.0 | Luglio 2026 | Corrente | Commit/rollback del gestore di contesto, correzione per Apple Silicon, correzione della copia in blocco dell'entità servizio |
| 1.10.0 | Giugno 2026 | Previous | Copia in massa con ActiveDirectoryServicePrincipal, correzioni per Arrow VARCHAR |
| 1.9.0 | Giugno 2026 | Previous | Copia in blocco con oggetti riga, miglioramento della tipizzazione dei parametri NULL |
| 1.8.0 | Maggio 2026 | Previous | Copia in blocco con ActiveDirectoryMSI, indicizzazione delle righe tramite chiave stringa |
| 1.7.1 | Maggio 2026 | Previous | Ruote RHEL 8, concorrenza più ampia e correzioni Unicode |
| 1.6.0 | Aprile 2026 | Previous | Sanitizzazione della stringa di connessione basata su un parser, correzioni dei problemi di concorrenza nella connessione/disconnessione |
| 1.5.0 | Aprile 2026 | Previous | Arrow fetch, sql_variant, UUID nativo |
| 1.4.0 | Febbraio 2025 | Previous | Supporto per la copia in blocco (BCP) |
| 1.3.0 | Gennaio 2025 | Previous | Impostazioni, classe, configurazione del modulo |
| 1.2.0 | Novembre 2024 | Previous | Metodi di scoperta dello schema |
| 1.1.0 | Settembre 2024 | Previous | Convertitori di uscita personalizzati |
| 1.0.0 | Luglio 2024 | Previous | Versione iniziale GA |
Importante
Solo la versione attuale (1.11.0) riceve nuove funzionalità e correzioni di bug. Le versioni precedenti rimangono funzionali ma non ricevono aggiornamenti. Aggiorna all'ultima versione per la migliore esperienza.
compatibilità delle versioni di Python
Il driver mssql-python richiede Python 3.10 o versioni successive. Se stai iniziando un nuovo progetto, punta alla versione più recente di Python supportata nella matrice di compatibilità per la finestra di supporto più lunga. Se sei limitato a una versione più vecchia di Python (3.9 o precedente), usa invece pyodbc.
| Versione di Python | Stato del supporto |
|---|---|
| Python 3.14 | Supportato |
| Python 3.13 | Supportato |
| Python 3.12 | Supportato |
| Python 3.11 | Supportato |
| Python 3.10 | Supportato (minimo) |
| Python 3.9 e precedenti | Non supportato |
Importante
Usare sempre una versione di Python supportata. Le versioni precedenti Python non ricevono gli aggiornamenti della sicurezza.
compatibilità delle versioni di SQL Server
Il driver mssql-python utilizza il protocollo TDS e funziona con tutte le versioni di SQL Server attivamente supportate.
| Versione di SQL Server | Stato del supporto |
|---|---|
| Tutte le versioni supportate di Microsoft SQL Server | supporto completo |
Servizi di Azure SQL
| Service | Stato del supporto |
|---|---|
| Database SQL di Microsoft Azure | supporto completo |
| Istanza gestita di SQL di Azure (Istanza gestita di Azure SQL) | supporto completo |
| Azure Synapse Analytics (pool dedicati) | Supportato |
Microsoft Fabric
| Punto finale | Stato del supporto |
|---|---|
| Database SQL nell'ambiente Fabric | supporto completo |
| Fabric Data Warehouse | Supportato |
| Endpoint di analisi SQL (Lakehouse) | Supportato |
| Endpoint di analisi SQL (database con mirroring) | Supportato |
Compatibilità del sistema operativo
Il driver mssql-python utilizza DDBC (Direct Database Connectivity) e non richiede l'installazione del driver Microsoft ODBC. La rimozione della dipendenza esterna semplifica la distribuzione, soprattutto nei container e nelle pipeline CI/CD.
| Sistema operativo | Architecture | Stato del supporto |
|---|---|---|
| Windows 11 | x64, ARM64 | Supportato |
| Windows Server 2019, 2022, 2025 | x64 | Supportato |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Supportato |
| Debian 11, 12 | x64, ARM64 | Supportato |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Supportato |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Supportato |
| Alpine Linux | x64 | Supportato |
Compatibilità delle funzionalità
Le seguenti tabelle elencano le funzionalità di SQL Server e il loro stato di supporto nella versione attuale (1.11.0) del driver mssql-python. Se una funzionalità di cui hai bisogno non è supportata (come Always Encrypted o MARS), considera invece di usare pyodbc . Per informazioni sulle funzionalità aggiunte nelle versioni precedenti, vedi Cosa c'è di nuovo in mssql-python.
Caratteristiche di SQL Server
| Feature | Supporto MSSQL-Python |
|---|---|
| Connessioni crittografate (TLS) | Supportato |
| Sempre Crittografato | Non supportato |
| Autenticazione Microsoft Entra | Supportato |
| Set di risultati attivi multipli (MARS) | Non supportato |
| Copia massiva (BCP) | Supportato |
| Ritiro della freccia Apache | Supportato |
| sql_variant Colonne | Supportato |
| UUID nativo | Supportato |
| Resilienza della connessione | Supportato |
| Routing di sola lettura | Supportato |
Conformità a DB-API 2.0
| Feature | Support |
|---|---|
| Interfaccia del modulo | Compliant |
| Interfaccia di connessione | Compliant |
| Interfaccia del cursore | Per lo più conformi |
| Oggetti tipo | Compliant |
| Eccezioni | Compliant |
callproc() |
Non implementato |
Note
Il callproc() metodo non viene implementato. Richiama le stored procedure utilizzando istruzioni EXECUTE tramite i metodi di query standard.
Requisiti di dipendenza
Il driver mssql-python ha dipendenze minime:
| Dipendenza | Finalità | Versione |
|---|---|---|
| azure-identity | Autenticazione tramite Microsoft Entra ID | Richiesto (>= 1.12.0) |
Il driver mssql-python non richiede l'installazione di un driver Microsoft ODBC.
Migrazione da pyodbc
Il driver mssql-python semplifica il deployment (non è richiesto il driver ODBC) e offre un pool di connessione integrato. Le principali differenze da considerare durante la migrazione:
| Consideration | Notes |
|---|---|
| Stile dei parametri | PYODBC utilizza qmark parametri posizionali. mssql-python utilizza per impostazione predefinita i parametri denominati pyformat e supporta anche qmark per compatibilità. |
| Accesso alle righe | L'accesso agli attributi è supportato in entrambi. |
| Procedure memorizzate | Usa EXECUTE (no callproc). |
| Pool di connessioni | Pooling integrato nel driver mssql-python. |
Consulta Migrare da pyodbc per istruzioni dettagliate.
Migrazione da pymssql
Il driver pymssql non è più mantenuto attivamente. Il driver mssql-python offre un'alternativa supportata con una sintassi di connessione simile ma con funzionalità moderne come il pool di connessione integrato e l'autenticazione Microsoft Entra.
| Consideration | Notes |
|---|---|
| Dipendenza da FreeTDS | Non obbligatorio. Il driver mssql-python utilizza DDBC. |
| Parametri di connessione | Stile simile, ma nomi di parametri diversi. |
| Accesso alle righe | Entrambi supportano pattern di accesso in stile dizionario e tramite attributi. |
| Procedure memorizzate | Usa EXECUTE (no callproc). |
Vedi Migrare da pymssql per istruzioni dettagliate.
Politica di cambiamenti in anticipo
- Versioni principali (2.0, 3.0): I cambiamenti principali nelle versioni indicano cambiamenti in fase di aggiornamento nell'API.
- Versioni minori (1.4, 1.5): Includere nuove funzionalità e mantenere la retrocompatibilità.
- Versioni patch (1.4.1, 1.4.2): Includono solo correzioni di bug.
Il team documenta le ultime novità nelle note di rilascio e fornisce guide alla migrazione.
Come rimanere aggiornati
Il driver mssql-python rilascia frequentemente versioni minori. Controlla regolarmente gli aggiornamenti, soprattutto prima delle implementazioni in produzione.
Controllare la versione installata
Verifica quale versione del driver è attualmente installata nel tuo ambiente:
import mssql_python
print(mssql_python.__version__)
Eseguire l'aggiornamento alla versione più recente
Aggiorna all'ultima versione per ottenere le ultime funzionalità e correzioni di sicurezza.
pip install --upgrade mssql-python
Sottoscrivere gli aggiornamenti
- Tieni d'occhio il repository GitHub.
- Controlla PyPI per le nuove uscite.
- Rivedi il changelog di ogni release.
Ottenere supporto
Problemi di GitHub
Segnalare bug e richiedere funzionalità in GitHub:
Documentation
Community
- Stack Overflow: Aggiungi tag alle domande con
mssql-python. - Discussioni su GitHub: Da usare per domande e discussioni generali.