Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O driver mssql-python é o driver oficial Python da Microsoft para SQL Server, Base de Dados SQL do Azure, Azure SQL Managed Instance e base de dados SQL em Microsoft Fabric. O driver é mantido ativamente no GitHub e lançado através do PyPI. Este artigo aborda versionamento, compatibilidade da plataforma e prazos de suporte.
Suporte de versões
Use sempre a versão mais recente para obter novas funcionalidades, melhorias de desempenho e correções de segurança. Novas capacidades são apenas adicionadas à 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 | Situação | Principais características |
|---|---|---|---|
| 1.11.0 | Julho de 2026 | Atualidade | Confirmação/reversão do gestor de contexto, correção para Apple Silicon, correção na cópia em massa do principal de serviço |
| 1.10.0 | Junho de 2026 | Anterior | Cópia em lote com ActiveDirectoryServicePrincipal, correções ao VARCHAR do Arrow |
| 1.9.0 | Junho de 2026 | Anterior | Cópia em massa com objetos Row, melhoria na tipagem de parâmetros NULL |
| 1.8.0 | Maio de 2026 | Anterior | Cópia em massa com ActiveDirectoryMSI, indexação por chave de cadeia de caracteres 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 da cadeia de ligação baseada no analisador sintático, correções de concorrência de ligação/desligação |
| 1.5.0 | Abril de 2026 | Anterior | Busca de setas, sql_variant, UUID nativo |
| 1.4.0 | Fevereiro de 2025 | Anterior | Suporte para cópia em lote (BCP) |
| 1.3.0 | Janeiro de 2025 | Anterior | Definições, classe, 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 da disponibilidade geral |
Importante
Apenas a versão atual (1.11.0) recebe novas funcionalidades e correções de bugs. As versões anteriores mantêm-se funcionais, mas não recebem atualizações. Atualize para a versão mais recente para a melhor experiência.
Compatibilidade de versões em Python
O driver mssql-python requer Python 3.10 ou posterior. Se estás a começar um novo projeto, aponta para a versão mais recente de Python suportada na matriz de compatibilidade para a janela de suporte mais longa. Se estiveres limitado a uma versão mais antiga do Python (3.9 ou anterior), usa o pyodbc em vez disso.
| Versão em Python | Estado do suporte |
|---|---|
| Python 3.14 | Suportado |
| Python 3.13 | Suportado |
| Python 3.12 | Suportado |
| Python 3.11 | Suportado |
| Python 3.10 | Suportado (mínimo) |
| Python 3.9 e anteriores | Não suportado |
Importante
Use sempre uma versão Python suportada. Versões antigas de Python não recebem atualizações de segurança.
Compatibilidade com versões 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 | Estado do suporte |
|---|---|
| Todas as versões suportadas do Microsoft SQL Server | Totalmente suportado |
Serviços SQL do Azure
| Service | Estado do suporte |
|---|---|
| Base de Dados SQL do Azure | Totalmente suportado |
| Azure SQL Managed Instance | Totalmente suportado |
| Azure Synapse Analytics (pools dedicados) | Suportado |
Microsoft Fabric
| Endpoint | Estado do suporte |
|---|---|
| Banco de dados SQL no Fabric | Totalmente suportado |
| Armazém de Dados Fabric | Suportado |
| Endpoint de análise SQL (Lakehouse) | Suportado |
| Endpoint de análise SQL (base de dados espelhada) | Suportado |
Compatibilidade do sistema operativo
O driver mssql-python usa DDBC (Direct Database Connectivity) e não requer que o driver Microsoft ODBC esteja instalado. Remover a dependência externa simplifica a implementação, especialmente em contentores e pipelines CI/CD.
| Sistema Operativo | Arquitetura | Estado do suporte |
|---|---|---|
| Windows 11 | x64, ARM64 | Suportado |
| Windows Server 2019, 2022, 2025 | x64 | Suportado |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Suportado |
| Debian 11, 12 | x64, ARM64 | Suportado |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Suportado |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Suportado |
| Linux alpino | x64 | Suportado |
Compatibilidade de funcionalidades
As tabelas seguintes listam as funcionalidades do SQL Server e o seu estado de suporte na versão atual (1.11.0) do driver mssql-python. Se uma funcionalidade de que precisas não for suportada (como Always Encrypted ou MARS), considera usar o pyodbc em vez disso. Para informações sobre funcionalidades adicionadas em versões anteriores, veja O que há de novo no mssql-python.
Funcionalidades do SQL Server
| Feature | Suporte MSSQL-Python |
|---|---|
| Ligações encriptadas (TLS) | Suportado |
| Sempre criptografado | Não suportado |
| Autenticação do Microsoft Entra | Suportado |
| Vários conjuntos de resultados ativos (MARS) | Não suportado |
| Cópia em massa (BCP) | Suportado |
| Obtenção do Apache Arrow | Suportado |
| sql_variant Colunas | Suportado |
| UUID nativo | Suportado |
| Resiliência da conexão | Suportado |
| Roteio de somente leitura | Suportado |
Conformidade com a DB-API 2.0
| Feature | Support |
|---|---|
| Interface do módulo | Compliant |
| Interface de conexão | Compliant |
| Interface de cursor | Maioritariamente cumpridor |
| Objetos tipo | Compliant |
| Exceções | Compliant |
callproc() |
Não implementado |
Note
O callproc() método não está implementado. Chame procedimentos armazenados utilizando 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 uma instalação do driver Microsoft ODBC.
Migração a partir de pyodbc
O driver mssql-python simplifica a implementação (sem necessidade de driver ODBC) e fornece pooling de ligações incorporado. As principais diferenças a ter em conta ao migrar:
| Consideração | Notes |
|---|---|
| Estilo de parâmetros | O PYODBC utiliza qmark parâmetros posicionais. O MSSQL-Python utiliza, por defeito, parâmetros nomeados pyformat e também suporta qmark para compatibilidade. |
| Acesso por fila | O acesso a atributos é suportado em ambos. |
| Procedimentos armazenados | Use EXECUTE (não callproc). |
| Agrupamento de conexões | Agregação de ligações integrada no controlador mssql-python. |
Consulte Migrar a partir de pyodbc para obter orientações detalhadas.
Migração do pymssql
O driver pymssql já não é mantido ativamente. O driver mssql-python oferece uma alternativa suportada com sintaxe de ligação semelhante, mas com funcionalidades modernas como pooling de ligações incorporadas e autenticação Microsoft Entra.
| Consideração | 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 por fila | Ambos suportam padrões de acesso do tipo dicionário e por atributo. |
| Procedimentos armazenados | Utilize EXECUTE (não callproc). |
Consulte Migrar a partir do pymssql para orientações detalhadas.
Política de alterações de última hora
- Versões principais (2.0, 3.0): Alterações principais de versão significam alterações de API que falham.
- Versões menores (1.4, 1.5): Incluem novas funcionalidades e mantêm compatibilidade retroativa.
- Versões de patch (1.4.1, 1.4.2): Incluem apenas correções de bugs.
A equipa documenta alterações urgentes nas notas de atualização e fornece guias de migração.
Como manter-se atualizado
O driver mssql-python lança versões menores com frequência. Verifique atualizações regularmente, especialmente antes das implementações em produção.
Verifique a versão instalada
Verifique qual a versão do driver que 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 as funcionalidades e correções de segurança mais recentes.
pip install --upgrade mssql-python
Subscrever atualizações
- Observa o repositório do GitHub.
- Consulta o PyPI para novas novidades.
- Revise o changelog de cada lançamento.
Obter apoio
Problemas do GitHub
Reportar bugs e pedir funcionalidades no GitHub:
Documentation
Community
- Stack Overflow: Marque as perguntas com
mssql-python. - Discussões no GitHub: Use para perguntas e discussões gerais.