Funzionalità di colonna specifiche del provider SQL Server di Entity Framework Core

In questa pagina vengono fornite informazioni dettagliate sulle opzioni di configurazione della colonna specifiche del provider SQL Server.

Unicode e UTF-8

SQL Server 2019 ha introdotto il supporto UTF-8 , che consente di archiviare dati UTF-8 in char e varchar colonne configurandoli con regole di confronto UTF-8 speciali. EF Core 7.0 ha introdotto il supporto completo per il mapping alle colonne UTF-8 ed è possibile usarli anche nelle versioni precedenti di Entity Framework, con alcuni passaggi aggiuntivi.

EF Core 7.0

EF Core 7.0 include il supporto di prima classe per le colonne UTF-8. Per configurarle, è sufficiente configurare il tipo di colonna in char o varchar, specificare regole di confronto UTF-8 (che terminano con _UTF8) e specificare che la colonna deve essere 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();
}

Versioni precedenti

Nelle versioni di EF Core precedenti alla 7.0, le colonne UTF-8 non funzionano correttamente con il provider SQL Server di EF Core. Per eseguire il mapping di una proprietà stringa a una varchar(x) colonna, l'API Fluent o Data Annotation viene in genere usata per disabilitare Unicode (vedere questi documenti). Anche se questo causa la creazione del tipo di colonna corretto nel database, rende anche i parametri del database di invio di EF Core in un modo che non è compatibile con i dati UTF-8: DbType.AnsiString viene usato (firmando dati non Unicode), ma DbType.String è necessario per inviare correttamente i dati Unicode.

Di conseguenza, sarà necessario configurare la proprietà EF come colonna regolare nvarchar , assicurandosi che i parametri vengano inviati con il corretto DbType:

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

Dopo aver creato la migrazione per la colonna, modificarla e modificare manualmente il tipo della colonna da nvarchar a varchar.

Colonne di tipo sparse

Le colonne di tipo sparse sono colonne normali con un'archiviazione ottimizzata per i valori Null, riducendo i requisiti di spazio per i valori Null a costo di un sovraccarico maggiore per recuperare valori non Null.

Si consideri ad esempio una gerarchia di tipi mappata tramite la strategia TPH (Table-Per-Hierarchy). In TPH viene usata una singola tabella di database per contenere tutti i tipi in una gerarchia; Ciò significa che la tabella deve contenere colonne per ogni proprietà nell'intera gerarchia e per le colonne appartenenti a tipi rari, la maggior parte delle righe conterrà un valore Null per tale colonna. In questi casi, può essere opportuno configurare la colonna come sparse per ridurre i requisiti di spazio. La decisione se creare una colonna di tipo sparse deve essere presa dall'utente e dipende dalle aspettative per i dati effettivi nella tabella.

Una colonna può essere resa di tipo sparse tramite l'API Fluent:

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

Per altre informazioni sulle colonne di tipo sparse, vedere la documentazione di SQL Server.