Funkce sloupců specifické pro zprostředkovatele SQL Serveru Entity Framework Core

Tato stránka podrobně popisuje možnosti konfigurace sloupce, které jsou specifické pro poskytovatele SQL Serveru.

Unicode a UTF-8

SQL Server 2019 zavedl podporu UTF-8 , která umožňuje ukládání dat UTF-8 do char sloupců a varchar jejich konfigurací pomocí speciálních kolací UTF-8. EF Core 7.0 zavedla úplnou podporu pro mapování na sloupce UTF-8 a je možné je použít i v předchozích verzích EF s některými dalšími kroky.

EF Core 7.0

EF Core 7.0 obsahuje prvotřídní podporu sloupců UTF-8. Pokud je chcete nakonfigurovat, jednoduše nakonfigurujte typ sloupce na char nebo varcharzadejte kolaci UTF-8 (končící _UTF8na) a určete, že sloupec by měl být 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();
}

Starší verze

Ve verzích EF Core starších než 7.0 nefungují sloupce UTF-8 předem s poskytovatelem SQL Serveru EF Core. K namapování vlastnosti řetězce na varchar(x) sloupec se obvykle používá rozhraní FLUENT nebo Data Annotation API k zakázání kódu Unicode (viz tyto dokumenty). I když to způsobí, že se v databázi vytvoří správný typ sloupce, vytvoří ef Core parametry databáze způsobem, který není kompatibilní s daty UTF-8: DbType.AnsiString používá se (označuje data bez unicode), ale DbType.String je potřeba správně odesílat data Unicode.

V důsledku toho budete muset vlastnost EF nakonfigurovat jako běžný nvarchar sloupec, abyste zajistili, že se parametry odesílají se správným DbTypekódem:

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

Po vytvoření migrace sloupce ho upravte a ručně změňte typ sloupce na nvarcharvarchar.

Řídké sloupce

Řídké sloupce jsou běžné sloupce, které mají optimalizované úložiště pro hodnoty null, což snižuje požadavky na místo pro hodnoty null za cenu větší režie na načtení nenulových hodnot.

Představte si například hierarchii typu mapovanou prostřednictvím strategie TPH (table-per-hierarchy). V TPH se jednoúčelová tabulka databáze používá k uložení všech typů v hierarchii; to znamená, že tabulka musí obsahovat sloupce pro každou a každou vlastnost v celé hierarchii a pro sloupce patřící do vzácných typů bude většina řádků obsahovat hodnotu null pro tento sloupec. V těchto případech může být vhodné nakonfigurovat sloupec jako zhuštěný, aby se snížily požadavky na místo. Rozhodnutí, jestli má uživatel provést řídký sloupec, a závisí na očekávání skutečných dat v tabulce.

Sloupec může být řídký prostřednictvím rozhraní Fluent API:

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

Další informace o řídkých sloupcích najdete v dokumentaci k SQL Serveru.