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 mssql-django pacote é o backend oficial da base de dados Django suportada pela Microsoft para SQL Server, Base de Dados SQL do Azure, Azure SQL Managed Instance e base de dados SQL no Microsoft Fabric. É mantido ativamente no GitHub e lançado através do PyPI. Esta página aborda versionamento, compatibilidade de plataformas e política 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 2.0 é a versão atual de disponibilidade geral (GA).
Importante
A versão 2.0 requer mssql-python 1.15.0 ou posterior, mesmo quando um alias de base de dados usa pyodbc. O pacote instala-se apenas em plataformas que tenham uma distribuição compatível mssql-python . Os projetos noutras plataformas mantêm-se na versão 1.8.0.
Definições de estado de suporte
Use estes valores de estado na tabela de versões:
| Situação | Meaning |
|---|---|
| Atualidade | Recebe novas funcionalidades, correções de bugs e correções de segurança. |
| Anterior | Lançamento histórico. Continua disponível mas não recebe atualizações. |
Histórico de versões
| Versão | Data de lançamento | Situação | Versões Django | Principais características |
|---|---|---|---|---|
| 2.0 | Setembro de 2026 | Atualidade | 5.2 - 6.1 | Controlador opt-in mssql-python, Python 3.10 - 3.14, zoneinfo substitui o pytz, correções de MARS e inspectdb |
| 1.8.0 | Agosto de 2026 | Anterior | 3.2 - 6.1 | Suporte ao Django 6.1, alteração do compilador de consultas quote_name, a introspeção de chave estrangeira devolve a regra ON DELETE |
| 1.7.4 | Julho de 2026 | Anterior | 3.2 - 6.0 |
GROUP BY correções para literais %% escapados com parâmetros reais e para IntegerChoices parâmetros em consultas brutas |
| 1.7.3 | Junho de 2026 | Anterior | 3.2 - 6.0 |
FA001 correção para Authentication= modos diferentes de ActiveDirectoryMsi, correção de DatabaseWrapperKeyError em subclasse (regressão desde a versão 1.7.1) |
| 1.7.2 | Maio de 2026 | Anterior | 3.2 - 6.0 |
datetimeoffset correção de fuso horário, Now() correção de fuso horário, .explain() correção de compatibilidade |
| 1.7.1 | Abril de 2026 | Anterior | 3.2 - 6.0 | Correção da base de dados SQL no Fabric, correção do índice descendente AlterField |
| 1.7 | Março de 2026 | Anterior | 3.2 - 6.0 | Suporte para Django 6.0, Driver ODBC 18 por defeito, suporte para SQL Server 2025 |
| 1.6 | Agosto de 2025 | Anterior | 3.2 - 5.2 | Suporte a Django 5.1 e 5.2, funcionalidade JSON melhorada |
| 1.5 | Abril de 2024 | Anterior | 3.2 - 5.0 |
supports_comments sinalizador, AutoField correções |
| 1.4 | janeiro de 2024 | Anterior | 3.2 - 5.0 | Suporte ao Django 5.0, suporte a db_comment |
| 1.3 | Maio de 2023 | Anterior | 3.2 - 4.2 | Suporte para Django 4.2, sensível a maiúsculas minúsculas Replace |
| 1.2 | Dezembro de 2022 | Anterior | 3.2 - 4.1 | Suporte a Django 4.1, suporte a fusos horários, JSONField no Azure SQL Managed Instance |
| 1.1 | Julho de 2022 | Anterior | 3.2 - 4.0 | Lançamento inicial com suporte a Django 3.2 e 4.0 |
As versões anteriores à 1.1 foram pré-lançamento e não estão listadas.
Importante
Correções e novas funcionalidades só são incluídas em novas versões. As versões mais antigas continuam disponíveis no PyPI, mas não foram corrigidas no local. Para obter correções de bugs ou de segurança, atualize para a versão mais recente.
Para notas detalhadas de lançamento, veja O que há de novo no mssql-django.
Compatibilidade de versões entre Django e Python
Cada versão do Django suporta versões específicas de Python.
mssql-django O 2.0 testa as seguintes combinações:
| Versão Django | Versões Python |
|---|---|
| 6.1 | 3.12, 3.13, 3.14 |
| 6.0 | 3.12, 3.13, 3.14 |
| 5.2 | 3.10, 3.11, 3.12, 3.13 |
O Django 3.2 a 5.1 e o Python 3.8 e 3.9 chegaram ao fim do suporte e não foram testados. Os projetos nessas versões mantêm-se na mssql-django 1.8.0.
Importante
Use sempre uma versão Python suportada. Versões antigas de Python não recebem atualizações de segurança.
Compatibilidade com SQL Server e SQL do Azure
mssql-djangoA versão 2.0 suporta todas as versões suportadas do Microsoft SQL. Uma nova versão principal do SQL Server que o back-end não reconhece estabelece ligação utilizando o conjunto de capacidades mais recente de que o back-end tem conhecimento, em vez de falhar na validação da versão.
| Produto ou serviço | Estado do suporte |
|---|---|
| SQL Server | Totalmente suportado |
| SQL Server em Máquinas Virtuais do Azure | Totalmente suportado |
| Base de Dados SQL do Azure | Totalmente suportado |
| Azure SQL Managed Instance | Totalmente suportado |
| Banco de dados SQL no Fabric | Totalmente suportado |
| Armazém do Microsoft Fabric | Apenas ligações. No caminho pyodbc, defina MARS_Connection=no em extra_params. Migrações do Django e outras funcionalidades do SQL Server não são suportadas. |
| Azure Synapse Analytics | Apenas ligações. Migrações do Django e outras funcionalidades do SQL Server não são suportadas. |
Compatibilidade de drivers de base de dados
mssql-django 2.0 estabelece ligação através de um de dois controladores de base de dados Python, selecionado para cada pseudónimo da base de dados. Para mais informações, consulte Selecionar o driver da base de dados para mssql-django.
| driver para Python | Estado do suporte | Connectivity |
|---|---|---|
pyodbc |
Com suporte total (por defeito) | Microsoft ODBC Driver 17 ou 18 para SQL Server, instalado separadamente |
mssql-python |
Totalmente suportado (opte pela python_driver opção) |
Embutido, sem instalação separada |
Compatibilidade de drivers ODBC
No caminho pyodbc, o backend utiliza por predefinição o ODBC Driver 18 para SQL Server e reverte automaticamente para o ODBC Driver 17 se a versão 18 não estiver instalada. Substitua a predefinição com a opção driver na configuração da sua base de dados. Um valor explícito não recua.
| controlador ODBC | Estado do suporte |
|---|---|
| Microsoft ODBC Driver 18 para SQL Server | Com suporte total (por defeito) |
| Microsoft ODBC Driver 17 para SQL Server | Com suporte total (recurso de contingência) |
| Controlador ODBC FreeTDS | Suportado no caminho pyodbc |
O mssql-python caminho ignora essa driver opção.
Para instruções de instalação, consulte Download ODBC Driver for SQL Server.
Compatibilidade do sistema operativo
mssql-django A versão 2.0 requer mssql-python, pelo que o pacote instala-se apenas onde existe uma distribuição compatível mssql-python . Esse requisito aplica-se mesmo quando todos os alias de base de dados usam pyodbc.
| Sistema Operativo | Architecture | Estado do suporte |
|---|---|---|
| Windows 11, Windows Server 2019, 2022 e 2025 | x64 | Supported |
| Windows 11, Windows Server 2022 e 2025 | ARM64 | Suportado com Python 3.11 e versões posteriores |
| macOS 15 e versões posteriores | Intel, Apple Silicon | Supported |
| Linux com glibc 2.28 ou posterior, como Ubuntu 22.04 e 24.04, Debian 11 e 12, e Red Hat Enterprise Linux 8 e 9 | x64, ARM64 | Supported |
| Linux com musl 1.2 ou posterior, como o Alpine Linux | x64, ARM64 | Supported |
| SUSE Linux Enterprise Server | ARM64 | Não suportado |
Os projetos numa plataforma não suportada mantêm-se na mssql-django versão 1.8.0, que não requer mssql-python.
No pyodbc caminho, instale o driver Microsoft ODBC para SQL Server separadamente. Os passos de instalação variam consoante o sistema operativo. Consulte Instalar mssql-django para configuração específica da plataforma.
Compatibilidade de funcionalidades
As tabelas seguintes listam as funcionalidades do Django e do SQL Server e o seu estado de suporte no mssql-django backend. Para mais detalhes sobre funcionalidades não suportadas, consulte Limitações e funcionalidades não suportadas no mssql-django.
Funcionalidades do Django ORM
| Característica | Suporte para MSSQL-DJANGO |
|---|---|
| Migrations | Yes |
QuerySet API (Interface de Programação de Aplicações) |
Yes |
JSONField |
Yes |
bulk_create / bulk_update |
Yes |
| Transações em bases de dados | Yes |
inspectdb com --schema |
Yes |
DISTINCT ON |
Não |
__regex
/
__iregex Pesquisas |
Parcial (requer configuração do assembly CLR; indisponível no Base de Dados SQL do Azure) |
SmallAutoField |
Yes |
select_for_update() |
Sim (NOWAIT e SKIP_LOCKED; of não suportado) |
| Funções do Windows | Yes |
GeneratedField (colunas calculadas) |
Sim (Django 5.0 e posteriores) |
CompositePrimaryKey |
Parcial (Django 5.2 e posteriores; ver limitações) |
db_comment |
Sim (Django 4.2 e posteriores) |
Índices de cobertura (include) |
Sim (Django 4.2 e posteriores) |
NthValue |
Não |
Funcionalidades do SQL Server
| Característica | Suporte para MSSQL-DJANGO |
|---|---|
| Ligações encriptadas (TLS) | Yes |
| Sempre criptografado | Yes |
| Autenticação do Microsoft Entra | Yes |
| Vários conjuntos de resultados ativos (MARS) | Sim, no pyodbc caminho. O backend ativa o MARS quando o alias utiliza um driver Microsoft ODBC no Windows. O mssql-python caminho nunca ativa o MARS e rejeita a MARS_Connection palavra-chave. |
| Procedimentos armazenados | Sim (via cursor.execute) |
SNAPSHOT Isolamento |
Sim (requer configuração ao nível da base de dados) |
| Roteio de somente leitura | Yes |
Requisitos de dependência
O mssql-django pacote instala automaticamente as seguintes dependências:
| Dependência | Purpose | Versão necessária |
|---|---|---|
| Django | Estrutura Web | >=5.2,<6.2 |
pyodbc |
Controlador ODBC de base de dados predefinido para Python | >=3.0 |
mssql-python |
Controlador de base de dados para Python. Instalado incondicionalmente, e usado apenas quando um alias opta por aderir. | >=1.15.0 |
tzdata |
Base de dados de fusos horários da IANA para o módulo da biblioteca padrão zoneinfo, utilizada quando o sistema operativo não fornece uma base de dados desse tipo |
Any |
O pyodbc caminho também requer o driver Microsoft ODBC para SQL Server no sistema anfitrião. O mssql-python caminho não tem uma instalação separada de drivers ODBC. Para mais informações, consulte Instalar mssql-django.
Política para versionamento e quebra de alterações
- Versões principais (2.0): Pode alterar o Python, Django, SQL Server suportado e a matriz da plataforma, podendo adicionar ou remover dependências. Alterações urgentes aparecem apenas numa versão maior.
- Versões menores (1.6, 1.7): Incluir suporte a novas versões de Django, novas funcionalidades e correções de bugs. Mantenha a retrocompatibilidade.
- Versões de patch (1.7.1, 1.7.2, 1.7.3, 1.7.4): Incluem apenas correções de bugs.
A equipa documenta alterações urgentes nas notas de lançamento. Veja O que há de novo no mssql-django para notas específicas de cada versão.
Como manter-se atualizado
O mssql-django backend lança novas versões para acompanhar os lançamentos do Django. Verifique atualizações ao atualizar o Django.
Verifique a versão instalada
Verifique qual a versão atualmente instalada:
pip show mssql-django
Atualizar para a versão mais recente
Atualização da versão mais recente:
pip install --upgrade mssql-django
Subscrever atualizações
- Fique atento ao repositório do GitHub para notificações de lançamento.
- Consulta o PyPI para novas novidades.
- Revise o changelog de cada lançamento.
Obtenha suporte
A Microsoft suporta mssql-django através do GitHub e canais comunitários.
Problemas do GitHub
Reportar bugs e pedir funcionalidades no GitHub:
Quando reportar um problema, inclua a sua versão Django, versão Python, versão SQL Server, o driver da base de dados Python e a sua versão, e uma reprodução mínima do problema.
Contribute
As contribuições da comunidade são bem-vindas. Para mais informações sobre o Acordo de Licença de Contribuidor (CLA) e o processo de submissão, consulte o guia de contribuição.
Community
- Stack Overflow: Etiquetar as perguntas com
djangoesql-server. - Documentação Django
- Centro de Desenvolvedores do Azure Python