SQL Server の値の生成

[アーティクル]
09/14/2023

このページでは、SQL Server プロバイダーに固有の値生成の構成とパターンについて説明します。まず、値の生成に関する概要ページを読むことをお勧めします。

IDENTITY 列

規則により、add で値が生成されるように構成された数値列は、SQL Server IDENTITY 列として設定されます。

シードとインクリメント

既定では、IDENTITY 列は 1 (シード) から開始され、行が追加されるごとに 1 ずつ増分されます (インクリメント)。次のように、別のシードとインクリメントを構成できます。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.BlogId)
        .UseIdentityColumn(seed: 10, increment: 10);
}

IDENTITY 列への明示的な値の挿入

既定では、SQL Server では IDENTITY 列に明示的な値を挿入することはできません。これを行うには、次のように、SaveChanges() を呼び出す前に手動で IDENTITY_INSERT を有効にする必要があります。

using (var context = new ExplicitIdentityValuesContext())
{
    context.Blogs.Add(new Blog { BlogId = 100, Url = "http://blog1.somesite.com" });
    context.Blogs.Add(new Blog { BlogId = 101, Url = "http://blog2.somesite.com" });

    context.Database.OpenConnection();
    try
    {
        context.Database.ExecuteSqlRaw("SET IDENTITY_INSERT dbo.Blogs ON");
        context.SaveChanges();
        context.Database.ExecuteSqlRaw("SET IDENTITY_INSERT dbo.Blogs OFF");
    }
    finally
    {
        context.Database.CloseConnection();
    }
}

Note

SQL Server プロバイダー内で自動的にこれを行うための機能要求が、バックログに用意されています。

シーケンス

IDENTITY 列の代わりに、標準のシーケンスを使用することもできます。これはさまざまなシナリオで役立つことがあります。たとえば、複数の列が 1 つのシーケンスから既定値を取り出す必要があるような場合です。

シーケンスの概要ページで詳しく説明されているように、SQL Server ではシーケンスを作成して使用できます。 HasDefaultValueSql() を介してシーケンスを使用するには、お客様がプロパティを構成する必要があります。

GUID

GUID 主キーの場合、プロバイダーは、SQL Server の NEWSEQUENTIALID 関数と同様に、最適なシーケンシャル値を自動的に生成します。クライアントでの値の生成は、一部のシナリオでより効率的です。つまり、キーを参照する依存オブジェクトも挿入される場合、データベースで生成される値を取得するための追加のラウンドトリップは必要ありません。

EF で非キーのプロパティに対して同じシーケンシャル GUID 値を生成するには、次のように構成します。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>().Property(b => b.Guid).HasValueGenerator(typeof(SequentialGuidValueGenerator));
}

RowVersion

SQL Server には rowversion データ型があり、行が更新されるたびに自動的に変更されます。これは、同じ行が複数のトランザクションによって同時に更新されるケースを管理するための、コンカレンシートークンとしてとても役立ちます。

コンカレンシートークンとその使用方法を完全に理解するには、コンカレンシーの競合に関する専用ページを参照してください。 byte[] プロパティを rowversion 列にマップするには、次のように構成します。

データの注釈
Fluent API

public class Person
{
    public int PersonId { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }

    [Timestamp]
    public byte[] Version { get; set; }
}

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Person>()
        .Property(p => p.Version)
        .IsRowVersion();
}

次の方法で共有