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 1.7.3 é a versão atual de disponibilidade geral (GA).
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 |
|---|---|---|---|---|
| 1.7.3 | Junho de 2026 | Atualidade | 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. Ao escolher as suas versões, assegure a compatibilidade entre Django, Python e mssql-django:
| Versão Django | Versões Python |
|---|---|
| 6.0 | 3.12, 3.13, 3.14 |
| 5.2 | 3.10, 3.11, 3.12, 3.13 |
| 5.1 | 3.10, 3.11, 3.12, 3.13 |
| 5.0 | 3.10, 3.11, 3.12 |
| 4.2 | 3.8, 3.9, 3.10, 3.11, 3.12 |
| 4.1 | 3.8, 3.9, 3.10, 3.11 |
| 4.0 | 3.8, 3.9, 3.10 |
| 3.2 | 3.8, 3.9, 3.10 |
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 mssql-django backend funciona com todas as versões suportadas do SQL Server.
Serviços SQL do Azure
| Serviço | Estado do suporte |
|---|---|
| Base de Dados SQL do Azure | Totalmente suportado |
| Azure SQL Managed Instance | Totalmente suportado |
Microsoft Fabric
| Ponto final | Estado do suporte |
|---|---|
| Banco de dados SQL no Fabric | Totalmente suportado |
Compatibilidade de drivers ODBC
O mssql-django backend requer um driver ODBC externo, ao contrário do mssql-python driver que utiliza Connectividade Direta de Base de Dados (DDBC).
A partir da versão mssql-django 1.7, o backend passa a utilizar por predefinição o ODBC Driver 18 para SQL Server e recorre automaticamente ao ODBC Driver 17 se a versão 18 não estiver instalada. Podes ultrapassar isto especificando a driver opção na configuração da tua base de dados.
| 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 | Supported |
Para instruções de instalação, consulte Download ODBC Driver for SQL Server.
Compatibilidade do sistema operativo
O mssql-django backend corre em qualquer lugar onde Python e o driver ODBC sejam suportados. Os passos de instalação dos drivers ODBC variam consoante o sistema operativo. Consulte Instalar mssql-django para configuração específica da plataforma.
| Sistema Operativo | Architecture | Estado do suporte |
|---|---|---|
| Windows 11 | x64, ARM64 | Supported |
| Windows Server 2019, 2022, 2025 | x64 | Supported |
| Ubuntu 22.04, 24.04 | x64, ARM64 | Supported |
| Debian 11, 12 | x64, ARM64 | Supported |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Supported |
| macOS 14, 15 | Intel, Apple Silicon (ARM64) | Supported |
| Linux alpino | x64 | Suportado (requer camada de compatibilidade glibc ou FreeTDS) |
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 |
Sim (SQL Server 2016+) |
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 (via pyodbc) |
| Procedimentos armazenados | Sim (através de 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 | >= 3.2 |
pyodbc |
Driver de base de dados ODBC para Python | >= 3.0 |
pytz |
Suporte para fusos horários (legado; o Django moderno usa a funcionalidade integrada zoneinfo com USE_TZ=True) |
Any |
O mssql-django backend também requer que o Microsoft ODBC Driver for SQL Server seja instalado no sistema anfitrião. Para mais informações, consulte Instalar mssql-django.
Política para versionamento e quebra de alterações
- 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): 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:
Ao reportar um problema, inclua a sua versão do Django, versão do Python, versão do SQL Server, versão do driver ODBC 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