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 mssql-django pacote é o back-end oficial do banco de dados Django com suporte Microsoft para SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure e banco de dados SQL no Microsoft Fabric. Ele é mantido ativamente em GitHub e liberado por meio do PyPI. Esta página aborda controle de versão, compatibilidade de plataforma e política 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.7.3 é a atual versão de disponibilidade geral (GA).
Definições de status de suporte
Use estes valores de status na tabela de versão:
| Status | Meaning |
|---|---|
| Atual | Recebe novos recursos, correções de bug e correções de segurança. |
| Anterior | Lançamento histórico. Permanece disponível, mas não recebe atualizações. |
Histórico de versões
| Versão | Data de lançamento | Status | Versões do Django | Características principais |
|---|---|---|---|---|
| 1.7.3 | Junho de 2026 | Atual | 3.2 - 6.0 |
FA001 correção para Authentication= modos que não sejam ActiveDirectoryMsi, correção para subclasses de DatabaseWrapperKeyError (regressão na versão 1.7.1) |
| 1.7.2 | Maio de 2026 | Anterior | 3.2 - 6.0 |
Correção de fuso horário datetimeoffset , 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 para banco de dados SQL no Fabric, correção do AlterField para índice em ordem decrescente |
| 1.7 | Março de 2026 | Anterior | 3.2 - 6.0 | Suporte ao Django 6.0, ODBC Driver 18 como padrão, suporte ao SQL Server 2025 |
| 1.6 | Julho 2025 | Anterior | 3.2 - 5.2 | Suporte ao Django 5.1 e 5.2, funcionalidade JSON aprimorada |
| 1.5 | Abril de 2024 | Anterior | 3.2 - 5.0 |
supports_comments indicador, AutoField correções |
| 1.4 | Janeiro de 2024 | Anterior | 3.2 - 5.0 | Suporte ao Django 5.0, db_comment suporte |
| 1.3 | Maio de 2023 | Anterior | 3.2 - 4.2 | Suporte ao Django 4.2, diferenciação entre maiúsculas e minúsculas Replace |
| 1.2 | Dezembro de 2022 | Anterior | 3.2 - 4.1 | Suporte do Django 4.1, suporte a fuso horário, JSONField em Instância Gerenciada de SQL do Azure |
| 1.1 | Julho de 2022 | Anterior | 3.2 - 4.0 | Versão inicial com suporte do Django 3.2 e 4.0 |
As versões anteriores à 1.1 eram pré-lançamento e não estavam listadas.
Importante
Correções e novos recursos são fornecidos apenas em novas versões. As versões mais antigas permanecem disponíveis no PyPI, mas não são corrigidas no local. Para obter correções de bug ou correções de segurança, atualize para a versão mais recente.
Para obter notas detalhadas sobre a versão, confira As novidades no mssql-django.
Compatibilidade de versão do Django e Python
Cada versão do Django dá suporte a versões Python específicas. Ao escolher suas versões, verifique a compatibilidade entre Django, Python emssql-django:
| Versão do Django | Versões do 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
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 mssql-django back-end funciona com todas as versões com suporte do SQL Server.
Serviços SQL do Azure
| Serviço | Status de suporte |
|---|---|
| Banco de Dados SQL do Azure | Suporte total |
| Instância Gerenciada de SQL do Azure | Suporte total |
Microsoft Fabric
| Endpoint | Status de suporte |
|---|---|
| Banco de dados SQL no Fabric | Suporte total |
Compatibilidade do driver ODBC
O mssql-django back-end requer um driver ODBC externo, ao contrário do mssql-python driver que usa a DDBC (Conectividade Direta de Banco de Dados).
A partir da mssql-django 1.7, o back-end usa como padrão o ODBC Driver 18 para SQL Server e retorna automaticamente ao ODBC Driver 17 se a versão 18 não estiver instalada. Você pode substituir isso especificando a opção driver na configuração do banco de dados.
| driver ODBC | Status de suporte |
|---|---|
| Microsoft ODBC Driver 18 para SQL Server | Totalmente suportado (padrão) |
| Microsoft ODBC Driver 17 para SQL Server | Totalmente suportado (fallback) |
| Driver ODBC do FreeTDS | Suportado |
Para obter instruções de instalação, consulte Baixar o Driver ODBC para SQL Server.
Compatibilidade do sistema operacional
O mssql-django backend funciona em qualquer ambiente que ofereça suporte a Python e ao driver ODBC. As etapas de instalação do driver ODBC variam de acordo com o sistema operacional. Consulte Install mssql-django para obter instruções de configuração específicas da plataforma.
| Sistema operacional | Architecture | Status de suporte |
|---|---|---|
| Windows 11 | x64, ARM64 | Suportado |
| Windows Server 2019 de 2022, 2025 | x64 | Suportado |
| Ubuntu 22.04, 24.04 | x64, ARM64 | Suportado |
| Debian 11, 12 | x64, ARM64 | Suportado |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Suportado |
| macOS 14, 15 | Intel, Apple Silicon (ARM64) | Suportado |
| Linux alpino | x64 | Com suporte (requer camada de compatibilidade glibc ou FreeTDS) |
Compatibilidade de recursos
As tabelas a seguir listam os recursos do Django e do SQL Server e seu status de suporte no backend mssql-django. Para obter mais detalhes sobre recursos sem suporte, consulte Limitações e recursos sem suporte no mssql-django.
Funcionalidades do ORM do Django
| Característica | Suporte a mssql-django |
|---|---|
| Migrations | Yes |
QuerySet Interface de Programação de Aplicações (API) |
Yes |
JSONField |
Sim (SQL Server 2016+) |
bulk_create / bulk_update |
Yes |
| Transações de banco de dados | Yes |
inspectdb com --schema |
Yes |
DISTINCT ON |
Não |
__regex
/
__iregex consultas |
Parcial (requer a instalação do assembly CLR; indisponível no Banco de Dados SQL do Azure) |
SmallAutoField |
Yes |
select_for_update() |
Sim (NOWAIT e SKIP_LOCKED; of não suportado) |
| Funções da janela | Yes |
GeneratedField (colunas computadas) |
Sim (Django 5.0 e posterior) |
CompositePrimaryKey |
Parcial (Django 5.2 e posterior; veja limitações) |
db_comment |
Sim (Django 4.2 e posterior) |
Índices de cobertura (include) |
Sim (Django 4.2 e posterior) |
NthValue |
Não |
Recursos do SQL Server
| Característica | Suporte a mssql-django |
|---|---|
| TLS (conexões criptografadas) | Yes |
| Sempre Criptografado | Yes |
| autenticação do Microsoft Entra | Yes |
| Múltiplos Conjuntos de Resultados Ativos (MARS) | Sim (por meio de pyodbc) |
| Procedimentos armazenados | Sim (por meio de cursor.execute) |
SNAPSHOT Isolamento |
Sim (requer configuração no nível do banco de dados) |
| Roteamento somente para 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 da Web | >= 3,2 |
pyodbc |
Driver de banco de dados ODBC para Python | >= 3,0 |
pytz |
Suporte a fuso horário (legado; o Django moderno usa o suporte interno zoneinfo com USE_TZ=True) |
Any |
O mssql-django backend também requer que o Microsoft ODBC Driver for SQL Server esteja instalado no sistema hospedeiro. Para obter mais informações, consulte Instalar mssql-django.
Política de controle de versão e alterações interruptivas
- Versões secundárias (1.6, 1.7): inclua o suporte à nova versão do Django, novos recursos e correções de bug. Manter a compatibilidade com versões anteriores.
- Versões de patch (1.7.1, 1.7.2, 1.7.3): inclua apenas correções de bug.
A equipe documenta alterações interruptivas nas notas de versão. Confira as novidades no mssql-django para obter anotações específicas da versão.
Como se manter atualizado
O mssql-django backend lança novas versões para acompanhar os lançamentos do Django. Verifique se há atualizações ao atualizar o Django.
Verificar a versão instalada
Verifique qual versão está instalada no momento:
pip show mssql-django
Atualizar para a versão mais recente
Atualize para a versão mais recente:
pip install --upgrade mssql-django
Assinar atualizações
- Acompanhe o repositório no GitHub para receber notificações de lançamento.
- Verifique se há novas versões no PyPI .
- Consulte o registro de alterações de cada versão.
Obter suporte
Microsoft dá suporte mssql-django por meio de canais de GitHub e de comunidade.
Problemas de GitHub
Relatar bugs e recursos de solicitação no GitHub:
Ao relatar um problema, inclua sua versão do Django, Python versão, SQL Server versão, versão do driver ODBC e uma reprodução mínima do problema.
Contribute
As contribuições da comunidade são bem-vindas. Para obter mais informações sobre o CLA (Contrato de Licença de Colaborador) e o processo de envio, consulte o guia de contribuição.
Community
- Stack Overflow: marcar perguntas com
djangoesql-server. - Documentação do Django
- Central de Desenvolvedores do Python do Azure