Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O driver mssql-python é o driver oficial de Python da Microsoft para SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure e banco de dados SQL em Microsoft Fabric. O driver é mantido ativamente no GitHub e liberado via PyPI. Este artigo aborda versionamento, compatibilidade de plataforma e prazos de suporte.
Suporte a versões
Sempre use a versão mais recente para obter novos recursos, melhorias de desempenho e correções de segurança. Novos recursos são adicionados apenas à versão atual.
Versão atual
A versão 1.11.0 é a versão atual de disponibilidade geral (GA).
Histórico de versões
| Versão | Data de lançamento | Status | Características principais |
|---|---|---|---|
| 1.11.0 | Julho de 2026 | Atual | Commit/rollback em gerenciador de contexto, correção para Apple Silicon, correção de cópia em massa de service principal |
| 1.10.0 | Junho de 2026 | Anterior | Cópia em massa com ActiveDirectoryServicePrincipal, correções de VARCHAR no Arrow |
| 1.9.0 | Junho de 2026 | Anterior | Cópia em massa com objetos Row, tipagem melhorada do parâmetro NULL |
| 1.8.0 | Maio de 2026 | Anterior | Cópia em massa com ActiveDirectoryMSI, indexação por chave de string de linha |
| 1.7.1 | Maio de 2026 | Anterior | Rodas RHEL 8, concorrência mais ampla e correções Unicode |
| 1.6.0 | Abril de 2026 | Anterior | Sanitização de cadeia de conexão baseada em um analisador sintático, correções de concorrência em conexão/desconexão |
| 1.5.0 | Abril de 2026 | Anterior | busca do Arrow, sql_variant, UUID nativo |
| 1.4.0 | Fevereiro de 2025 | Anterior | Suporte a cópias em massa (BCP) |
| 1.3.0 | Janeiro de 2025 | Anterior | Classe de configurações, configuração do módulo |
| 1.2.0 | Novembro de 2024 | Anterior | Métodos de descoberta de esquemas |
| 1.1.0 | Setembro de 2024 | Anterior | Conversores de saída personalizados |
| 1.0.0 | Julho de 2024 | Anterior | Lançamento inicial para disponibilidade geral |
Importante
Apenas a versão atual (1.11.0) recebe novos recursos e correções de bugs. Versões anteriores continuam funcionais, mas não recebem atualizações. Atualize para a versão mais recente para a melhor experiência.
Compatibilidade de versão do Python
O driver mssql-python requer Python 3.10 ou posterior. Se você estiver começando um novo projeto, mire na versão mais recente de Python suportada na matriz de compatibilidade para a janela de suporte mais longa. Se você estiver limitado a uma versão antiga de Python (3.9 ou anterior), use o pyodbc em vez disso.
| Versão do Python | Status de suporte |
|---|---|
| Python 3.14 | Supported |
| Python 3.13 | Supported |
| Python 3.12 | Supported |
| Python 3.11 | Supported |
| Python 3.10 | Suportado (mínimo) |
| Python 3.9 e versões anteriores | Sem suporte |
Importante
Sempre use uma versão de Python com suporte. Versões de Python mais antigas não recebem atualizações de segurança.
Compatibilidade de versão do SQL Server
O driver mssql-python utiliza o protocolo TDS e funciona com todas as versões do SQL Server ativamente suportadas.
| Versão do SQL Server | Status de suporte |
|---|---|
| Todas as versões suportadas do Microsoft SQL Server | Suporte total |
Serviços SQL do Azure
| Service | Status de suporte |
|---|---|
| Banco de Dados SQL do Azure | Suporte total |
| Instância Gerenciada de SQL do Azure | Suporte total |
| Azure Synapse Analytics (pools dedicados) | Supported |
Microsoft Fabric
| Endpoint | Status de suporte |
|---|---|
| Banco de dados SQL no Fabric | Suporte total |
| Armazém de Dados Fabric | Supported |
| Endpoint de análise SQL (Lakehouse) | Supported |
| Endpoint de análise SQL (banco de dados espelhado) | Supported |
Compatibilidade do sistema operacional
O driver mssql-python usa DDBC (Direct Database Connectivity) e não exige a instalação do driver Microsoft ODBC. A remoção da dependência externa simplifica a implantação, especialmente em containers e pipelines de CI/CD.
| Sistema operacional | Architecture | Status de suporte |
|---|---|---|
| Windows 11 | x64, ARM64 | Supported |
| Windows Server 2019 de 2022, 2025 | x64 | Supported |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Supported |
| Debian 11, 12 | x64, ARM64 | Supported |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Supported |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Supported |
| Linux alpino | x64 | Supported |
Compatibilidade de recursos
As tabelas a seguir listam os recursos do SQL Server e seu status de suporte na versão atual (1.11.0) do driver mssql-python. Se algum recurso que você precisa não for suportado (como Always Encrypted ou MARS), considere usar pyodbc . Para informações sobre recursos adicionados em versões anteriores, veja O que há de novo em mssql-python.
Recursos do SQL Server
| Característica | Suporte a MSSQL-Python |
|---|---|
| TLS (conexões criptografadas) | Supported |
| Sempre Criptografado | Sem suporte |
| autenticação do Microsoft Entra | Supported |
| Múltiplos Conjuntos de Resultados Ativos (MARS) | Sem suporte |
| Cópia em massa (BCP) | Supported |
| Buscar flechas Apache | Supported |
| sql_variant colunas | Supported |
| UUID nativo | Supported |
| Resiliência de conexão | Supported |
| Roteamento somente para leitura | Supported |
Conformidade com a DB-API 2.0
| Característica | Support |
|---|---|
| Interface do módulo | Em conformidade |
| Interface de Conexão | Em conformidade |
| Interface de cursor | Majoritariamente em conformidade |
| Objetos tipo | Em conformidade |
| Exceções | Em conformidade |
callproc() |
Não implementado |
Note
O callproc() método não é implementado. Chame procedimentos armazenados usando instruções EXECUTE com métodos de consulta padrão.
Requisitos de dependência
O driver mssql-python tem dependências mínimas:
| Dependência | Purpose | Versão |
|---|---|---|
| azure-identity | Autenticação do Microsoft Entra ID | Obrigatório (>= 1.12.0) |
O driver mssql-python não requer instalação do driver Microsoft ODBC.
Migração do pyodbc
O driver mssql-python simplifica a implantação (não é necessário driver ODBC) e oferece pooling de conexões embutido. As principais diferenças para se planejar ao migrar:
| Consideration | Notes |
|---|---|
| Estilo de parâmetros | PYODBC utiliza qmark parâmetros posicionais. mssql-python usa por padrão parâmetros nomeados pyformat e também oferece suporte a qmark para compatibilidade. |
| Acesso a linhas | O acesso a atributos é suportado em ambos. |
| Procedimentos armazenados | Use EXECUTE (não callproc). |
| Agrupamento de conexões | Pool de conexões integrado ao driver mssql-python. |
Veja Migrar do pyodbc para orientações detalhadas.
Migração do pymssql
O driver pymssql não é mais mantido ativamente. O driver mssql-python oferece uma alternativa com suporte e sintaxe de conexão semelhante, além de recursos modernos, como pool de conexões integrado e autenticação com o Microsoft Entra.
| Consideration | Notes |
|---|---|
| Dependência do FreeTDS | Não necessário. O driver mssql-python usa DDBC. |
| Parâmetros de conexão | Estilo semelhante, mas nomes de parâmetros diferentes. |
| Acesso a linhas | Ambos suportam padrões de acesso no estilo de dicionário e por atributo. |
| Procedimentos armazenados | Use EXECUTE (não callproc). |
Veja Migrar a partir de pymssql para orientações detalhadas.
Política para alterações interruptivas
- Versões principais (2.0, 3.0): Alterações na versão principal indicam alterações incompatíveis na API.
- Versões menores (1.4, 1.5): Incluir novos recursos e manter a compatibilidade retroativa.
- Versões de patch (1.4.1, 1.4.2): Incluem apenas correções de bugs.
A equipe documenta mudanças urgentes nas notas de lançamento e fornece guias de migração.
Como se manter atualizado
O driver mssql-python lança versões menores com frequência. Verifique atualizações regularmente, especialmente antes das implantações em produção.
Verificar a versão instalada
Verifique qual versão do driver está atualmente instalada no seu ambiente:
import mssql_python
print(mssql_python.__version__)
Atualizar para a versão mais recente
Atualize para a versão mais recente para obter os recursos e correções de segurança mais recentes.
pip install --upgrade mssql-python
Assinar atualizações
- Fique de olho no repositório do GitHub.
- Verifique no PyPI as novas versões.
- Revise o changelog de cada lançamento.
Como obter suporte
Problemas de GitHub
Relatar bugs e recursos de solicitação no GitHub:
Documentation
Community
- Stack Overflow: Marque as perguntas com
mssql-python. - Discussões no GitHub: Use para perguntas gerais e discussões.