Recursos de coluna específicos para o provedor do SQL Server do Entity Framework Core

Essa página detalha as opções de configuração de coluna específicas para o provedor do SQL Server.

Unicode e UTF-8

O SQL Server 2019 introduziu o suporte a UTF-8, que permite armazenar dados UTF-8 em colunas char e varchar, configurando-os com ordenações UTF-8 especiais. O EF Core 7.0 introduziu suporte completo para mapeamento para colunas UTF-8 e também é possível usá-las em versões anteriores do EF, com algumas etapas extras.

EF Core 7.0

O EF Core 7.0 inclui suporte de primeira classe para colunas UTF-8. Para configurá-los, basta configurar o tipo da coluna para char ou varcharespecificar um agrupamento UTF-8 (terminando com _UTF8) e especificar que a coluna deve ser Unicode:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Name)
        .HasColumnType("varchar(max)")
        .UseCollation("LATIN1_GENERAL_100_CI_AS_SC_UTF8")
        .IsUnicode();
}

Versões mais antigas

Em versões do EF Core anteriores à 7.0, as colunas UTF-8 não funcionam de forma pronta para uso com o provedor do SQL Server do EF Core. Para mapear uma propriedade de cadeia de caracteres para uma coluna varchar(x), a API de Anotação de Dados ou Fluente normalmente é usada para desabilitar o Unicode (consulte estes documentos). Embora isso faça com que o tipo de coluna correto seja criado no banco de dados, ele também faz com que o EF Core envie parâmetros de banco de dados de forma incompatível com os dados UTF-8: DbType.AnsiString é usado (significando dados que não são Unicode), mas DbType.String é necessário para enviar dados Unicode corretamente.

Como resultado, você precisará configurar a propriedade EF como uma coluna nvarchar regular, garantindo que os parâmetros sejam enviados com o DbType correto:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Name)
        .UseCollation("LATIN1_GENERAL_100_CI_AS_SC_UTF8");
}

Depois de criar a migração para a coluna, edite-a e altere manualmente o tipo da coluna de nvarchar para varchar.

Colunas esparsas

Colunas esparsas são colunas comuns que têm um armazenamento otimizado para valores nulos, reduzindo os requisitos de espaço para valores nulos ao custo de mais sobrecarga para recuperar valores não nulos.

Por exemplo, considere uma hierarquia de tipos mapeada por meio da estratégia tabela por hierarquia (TPH). Na TPH, uma única tabela de banco de dados é usada para manter todos os tipos em uma hierarquia. Isso significa que a tabela deve conter colunas para cada propriedade em toda a hierarquia e, para colunas pertencentes a tipos raros, a maioria das linhas conterá um valor nulo para essa coluna. Nesses casos, pode fazer sentido configurar a coluna como esparsa, a fim de reduzir os requisitos de espaço. A decisão de tornar uma coluna esparsa deve ser tomada pelo usuário e depende das expectativas de dados reais na tabela.

Uma coluna pode se tornar esparsa por meio da API fluente:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<RareBlog>()
        .Property(b => b.RareProperty)
        .IsSparse();
}

Para obter mais informações sobre colunas esparsas,consulte os documentos do SQL Server.