Funkcje kolumn specyficzne dla dostawcy programu Entity Framework Core SQL Server

Ta strona zawiera szczegółowe informacje o opcjach konfiguracji kolumn specyficznych dla dostawcy programu SQL Server.

Unicode i UTF-8

Program SQL Server 2019 wprowadził obsługę protokołu UTF-8 , która umożliwia przechowywanie danych UTF-8 w char kolumnach i varchar przez skonfigurowanie ich przy użyciu specjalnych sortowania UTF-8. Program EF Core 7.0 wprowadził pełną obsługę mapowania na kolumny UTF-8 i można ich używać również w poprzednich wersjach ef, z dodatkowymi krokami.

EF Core 7.0

Program EF Core 7.0 zawiera najwyższej klasy obsługę kolumn UTF-8. Aby je skonfigurować, wystarczy skonfigurować typ kolumny na char lub varchar, określ sortowanie UTF-8 (kończące się na _UTF8), a następnie określ, że kolumna powinna mieć wartość 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();
}

Starsze wersje

W wersjach programu EF Core wcześniejszych niż 7.0 kolumny UTF-8 nie działają w wersji gotowej do użycia z dostawcą programu SQL Server programu EF Core. Aby zamapować właściwość ciągu na kolumnę varchar(x) , interfejs API fluent lub data annotation jest zwykle używany do wyłączania formatu Unicode (zobacz te dokumenty). Chociaż powoduje to utworzenie poprawnego typu kolumny w bazie danych, powoduje to również, że program EF Core wysyła parametry bazy danych w sposób niezgodny z danymi UTF-8: DbType.AnsiString jest używany (oznaczanie danych innych niż Unicode), ale DbType.String jest wymagane do prawidłowego wysyłania danych Unicode.

W związku z tym należy skonfigurować właściwość EF jako zwykłą nvarchar kolumnę, zapewniając, że parametry są wysyłane przy użyciu poprawnego DbTypeelementu :

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

Po utworzeniu migracji dla kolumny zmodyfikuj ją i ręcznie zmień typ kolumny z nvarchar na varchar.

Kolumny rozrzedłe

Kolumny rozrzedzonych to zwykłe kolumny, które mają zoptymalizowany magazyn dla wartości null, zmniejszając wymagania dotyczące miejsca dla wartości null kosztem większego obciążenia związanego z pobieraniem wartości innych niż null.

Rozważmy na przykład hierarchię typów mapowana za pomocą strategii TPH (table-per-hierarchy). W przypadku funkcji TPH jedna tabela bazy danych jest używana do przechowywania wszystkich typów w hierarchii; Oznacza to, że tabela musi zawierać kolumny dla każdej właściwości w całej hierarchii, a w przypadku kolumn należących do rzadkich typów większość wierszy będzie zawierać wartość null dla tej kolumny. W takich przypadkach warto skonfigurować kolumnę jako rozrzedliwą, aby zmniejszyć wymagania dotyczące miejsca. Decyzja o tym, czy należy podjąć rozrzedy kolumnę, musi zostać podjęta przez użytkownika i zależy od oczekiwań dotyczących rzeczywistych danych w tabeli.

Kolumnę można utworzyć rozrzedli za pośrednictwem interfejsu API Fluent:

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

Aby uzyskać więcej informacji na temat rozrzednych kolumn, zobacz dokumentację programu SQL Server.