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 pacote mssql-django é o back-end oficial do banco de dados do Django com suporte da 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 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 banco de dados utiliza pyodbc. O pacote é instalado apenas em plataformas que possuem uma distribuição compatível mssql-python . Projetos em outras plataformas permanecem na versão 1.8.0.
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 |
|---|---|---|---|---|
| 2.0 | Setembro de 2026 | Atual | 5.2 - 6.1 | Driver opt-in mssql-python, Python 3.10 - 3.14, zoneinfo substitui pytz, correções de MARS e inspectdb |
| 1.8.0 | Agosto de 2026 | Anterior | 3.2 - 6.1 | Suporte ao Django 6.1, quote_name mudança no compilador de consultas, introspecção de chave estrangeira retorna a regra ON DELETE |
| 1.7.4 | Julho de 2026 | Anterior | 3.2 - 6.0 |
GROUP BY corrige literais %% com caractere de escape com parâmetros reais e para parâmetros IntegerChoices em consultas brutas |
| 1.7.3 | Junho de 2026 | Anterior | 3.2 - 6.0 | Correção de FA001 para modos Authentication= que não sejam ActiveDirectoryMsi, correção para DatabaseWrapperKeyError de subclasses (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, correção de fuso horário Now(), correção de compatibilidade .explain() |
| 1.7.1 | Abril de 2026 | Anterior | 3.2 - 6.0 | Correção para Banco de Dados SQL no Fabric, correção de AlterField de í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 | Sinalizador supports_comments, correções de AutoField |
| 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 ao Django 4.2, diferenciação de maiúsculas e minúsculas de 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.
mssql-django A versão 2.0 testa as seguintes combinações:
| Versão do Django | Versões do 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 |
Django 3.2 a 5.1 e Python 3.8 e 3.9 chegaram ao fim do suporte e não foram testados. Os projetos nessas versões permanecem na mssql-django 1.8.0.
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 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 backend não reconhece se conecta usando o conjunto de capacidades mais recente que o backend conhece, em vez de falhar na validação de versão.
| Produto ou serviço | Status de suporte |
|---|---|
| SQL Server | Suporte total |
| SQL Server em Máquinas Virtuais do Azure | Suporte total |
| Banco de Dados SQL do Azure | Suporte total |
| Instância Gerenciada de SQL do Azure | Suporte total |
| Banco de dados SQL no Fabric | Suporte total |
| Microsoft Fabric Warehouse | Apenas conexões. No caminho pyodbc, defina MARS_Connection=no em extra_params. Migrações do Django e outros recursos do SQL Server não são suportados. |
| Azure Synapse Analytics | Apenas conexões. Migrações do Django e outros recursos do SQL Server não são suportados. |
Compatibilidade de drivers de banco de dados
mssql-djangoO 2.0 se conecta por meio de dois drivers de banco de dados em Python, selecionados para cada alias de banco de dados. Para mais informações, veja Selecionar o driver de banco de dados para mssql-django.
| Driver Python | Status de suporte | Connectivity |
|---|---|---|
pyodbc |
Totalmente suportado (padrão) | Driver Microsoft ODBC 17 ou 18 para SQL Server, instalado separadamente |
mssql-python |
Totalmente suportado (ative com a opção python_driver) |
Embutido, sem instalação separada |
Compatibilidade do driver ODBC
No pyodbc caminho, o backend usa por padrão o Driver ODBC 18 para SQL Server e automaticamente volta ao ODBC Driver 17 se a versão 18 não estiver instalada. Substitua o valor padrão com a opção driver na configuração do banco de dados. Um valor explícito não recua.
| driver ODBC | Status de suporte |
|---|---|
| Microsoft ODBC Driver 18 para SQL Server | Totalmente suportado (padrão) |
| Microsoft ODBC Driver 17 para SQL Server | Totalmente compatível (fallback) |
| Driver ODBC do FreeTDS | Compatível com o caminho pyodbc |
O mssql-python caminho ignora a driver opção.
Para obter instruções de instalação, consulte Baixar o Driver ODBC para SQL Server.
Compatibilidade do sistema operacional
mssql-django A versão 2.0 requer mssql-python, então o pacote só se instala onde existe uma distribuição compatível mssql-python . Esse requisito se aplica mesmo quando todo alias de banco de dados usa pyodbc.
| Sistema operacional | Architecture | Status de suporte |
|---|---|---|
| Windows 11, Windows Server 2019, 2022 e 2025 | x64 | Suportado |
| 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 | Suportado |
| 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 | Suportado |
| Linux com musl 1.2 ou posterior, como o Alpine Linux | x64, ARM64 | Suportado |
| SUSE Linux Enterprise Server | ARM64 | Sem suporte |
Projetos em uma plataforma não suportada permanecem 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. As etapas de instalação variam conforme o sistema operacional. Consulte Install mssql-django para obter instruções de configuração específicas da plataforma.
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 |
Yes |
bulk_create / bulk_update |
Yes |
| Transações de banco de dados | Yes |
inspectdb por --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, no caminho pyodbc. O backend ativa o MARS quando o alias usa um driver Microsoft ODBC no Windows. O mssql-python caminho nunca ativa o MARS e rejeita a MARS_Connection palavra-chave. |
| 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 | >=5.2,<6.2 |
pyodbc |
Driver padrão de banco de dados ODBC para Python | >=3.0 |
mssql-python |
Driver de banco de dados em Python. Instalado incondicionalmente, e usado apenas quando um alias optar. | >=1.15.0 |
tzdata |
Banco de dados de fusos horários da IANA para o módulo da biblioteca padrão zoneinfo, usado quando o sistema operacional não fornece esse banco de dados |
Any |
O pyodbc caminho também requer o driver Microsoft ODBC para SQL Server no sistema host. O mssql-python caminho não possui instalação separada de drivers ODBC. Para obter mais informações, consulte Instalar mssql-django.
Política de controle de versão e alterações disruptivas
- Versões principais (2.0): Pode alterar o Python, Django, SQL Server e matriz de plataforma suportados, além de adicionar ou remover dependências. Mudanças recentes aparecem apenas em uma versão maior.
- 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, 1.7.4): Incluem apenas correções de bugs.
A equipe documenta alterações disruptivas 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:
Quando você reportar um problema, inclua sua versão do Django, versão do Python, versão do SQL Server, o driver do banco de dados em Python e sua versão, além de 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