Campo Django para mapeamentos do tipo SQL Server

Este artigo documenta como os tipos de campo dos modelos Django correspondem aos tipos de dados do SQL Server ao utilizar o mssql-django backend.

Tabela de mapeamento de tipos de campo

Comportamentos específicos do SQL Server

Alguns tipos de campos Django apresentam comportamentos específicos 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 precisares de alterar o tipo de chave primária, cria um novo campo e migra os dados manualmente.

BooleanField e bit

Armazenamento 0 do SQL Server e 1. O Django corresponde True/False a estes valores. NULL é suportado por BooleanField(null=True).

DateTimeField e suporte a fusos horários

Quando USE_TZ=True estiver nas definições do Django, DateTimeField usa o desfasamento de data-hora para guardar as datas com base no fuso horário. Quando USE_TZ=False, usa datetime2.

Se ativares USE_TZ depois de criar colunas, tens de migrar manualmente as colunas datetime2 existentes para datetimeoffset. Para mais informações, consulte Suporte a fusos horários no mssql-django.

TextField vs CharField

O 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 existe uma opção incorporada para usar varchar (não Unicode) em vez disso.

Isso é intencional. O tratamento das strings do Django é Unicode em todo o processo, e o nvarchar garante que todos os caracteres são armazenados corretamente, independentemente da linguagem ou codificação. Usar nvarchar evita a perda de dados devido a desajustes no conjunto de caracteres.

Compromissos:

• O nvarchar usa 2 bytes por carácter, comparado com 1 byte por carácter para varchar com colações de um byte.
• Aplicam-se limites de tamanho de chave de índice (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 os teus dados forem exclusivamente ASCII, o nvarchar duplica o armazenamento em comparação com o varchar.

Se precisares de colunas varchar:

Para bases de dados legadas ou requisitos rigorosos de armazenamento, crie um campo personalizado que sobreponha 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 bases de dados com mssql-django
• Limitações e funcionalidades não suportadas no mssql-django
• Referência de campo do modelo Django