Campo Django para mapeamentos do tipo SQL Server

Este artigo documenta como os tipos de campo do modelo Django mapeiam para os tipos de dados do SQL Server ao usar o mssql-django backend.

Tabela de mapeamento de tipos de campo

Comportamentos específicos do SQL Server

Alguns tipos de campo Django apresentam comportamento específico da plataforma quando usados com SQL Server.

Limitação do AutoField

Alterar um campo de modelo de ou para AutoField no momento da migração não é suportado. Se precisar mudar o tipo de chave primária, crie um novo campo e migre os dados manualmente.

BooleanField e bit

Armazena 0 do SQL Server e 1. Django mapeia True/False esses valores. NULL é suportado por BooleanField(null=True).

DateTimeField e suporte a fusos horários

Quando USE_TZ=True estiver nas configurações do Django, DateTimeField use o deslocamento de data-hora para armazenar datas com base em fusos horários. Quando USE_TZ=False, ele usa datetime2.

Se você ativar USE_TZ após criar as colunas, deve migrar manualmente as colunas datetime2 existentes para o datetimeoffset. Para mais informações, veja Suporte a fusos horários no mssql-django.

CampoTextVs Campo Carbonífero

SQL Server mapeia ambos TextField e CharField para nvarchar. TextField usa nvarchar(max) enquanto CharField usa nvarchar(N) onde N é max_length.

Todos os campos de string usam nvarchar (Unicode)

O mssql-django backend mapeia todos os campos de string de Django (CharField, TextField, EmailField, URLField, SlugField, e outros) para nvarchar, o tipo de string Unicode. Não há opção embutida para usar varchar (não Unicode) em vez disso.

Isso é por design. O tratamento de strings do Django é Unicode em todo o processo, e o nvarchar garante que todos os caracteres sejam armazenados corretamente, independentemente do idioma ou codificação. Usar nvarchar evita perda de dados por incompatibilidades no conjunto de caracteres.

Concessões:

• O nvarchar usa 2 bytes por caractere, comparado a 1 byte por caractere para varchar com colações de um byte.
• Limites de tamanho de chave de índice se aplicam (900 bytes para índices não clusterizados). Uma coluna nvarchar(450) atinge o limite de 900 bytes (450 x 2 bytes), enquanto uma coluna varchar(900) atinge o mesmo limite usando caracteres de um byte.
• Se seus dados forem exclusivamente ASCII, o nvarchar duplica o armazenamento em comparação ao varchar.

Se você precisar de colunas varchar:

Para bancos de dados legados ou requisitos rigorosos de armazenamento, crie um campo personalizado que substitua db_type:

from django.db import models

class VarcharField(models.CharField):
    def db_type(self, connection):
        return f"varchar({self.max_length})"

class LegacyProduct(models.Model):
    sku = VarcharField(max_length=50)  # Creates varchar(50) instead of nvarchar(50)

    class Meta:
        managed = False  # For existing tables
        db_table = "LegacyProduct"

Conteúdo relacionado

• JSONField com SQL Server
• Migrações de banco de dados com mssql-django
• Limitações e recursos não suportados no mssql-django
• Referência de campo do modelo Django