EF Core Azure Cosmos DB 공급자

이 데이터베이스 공급자를 설치하면 Entity Framework Core를 Azure Cosmos DB에서 사용할 수 있습니다. 공급자는 Entity Framework Core 프로젝트의 일부로 유지 관리됩니다.

이 섹션을 읽기 전에 Azure Cosmos DB 설명서를 숙지하는 것이 좋습니다.

설치

Microsoft.EntityFrameworkCore.Cosmos NuGet 패키지를 설치합니다.

dotnet add package Microsoft.EntityFrameworkCore.Cosmos

Install-Package Microsoft.EntityFrameworkCore.Cosmos

시작

다른 공급자와 마찬가지로, 첫 번째 단계는 UseCosmos를 호출하는 것입니다.

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    => optionsBuilder.UseCosmos(
        "https://localhost:8081",
        "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
        databaseName: "OrdersDB");

이 예제에서 Order는 소유된 형식 StreetAddress에 대한 참조를 포함하는 간단한 엔터티입니다.

public class Order
{
    public int Id { get; set; }
    public int? TrackingNumber { get; set; }
    public string PartitionKey { get; set; }
    public StreetAddress ShippingAddress { get; set; }
}

public class StreetAddress
{
    public string Street { get; set; }
    public string City { get; set; }
}

데이터 저장 및 쿼리는 일반적인 EF 패턴을 따릅니다.

using (var context = new OrderContext())
{
    await context.Database.EnsureDeletedAsync();
    await context.Database.EnsureCreatedAsync();

    context.Add(
        new Order
        {
            Id = 1, ShippingAddress = new StreetAddress { City = "London", Street = "221 B Baker St" }, PartitionKey = "1"
        });

    await context.SaveChangesAsync();
}

using (var context = new OrderContext())
{
    var order = await context.Orders.FirstAsync();
    Console.WriteLine($"First order will ship to: {order.ShippingAddress.Street}, {order.ShippingAddress.City}");
    Console.WriteLine();
}

연결 및 인증

EF Core용 Azure Cosmos DB 공급자에는 UseCosmos 메서드의 여러 오버로드가 있습니다. 이러한 오버로드는 데이터베이스에 연결할 수 있는 다양한 방법과 연결의 보안을 보장하는 다양한 방법을 지원합니다.

Azure Cosmos DB 옵션

또한 단일 연결 문자열을 사용하여 Azure Cosmos DB 공급자를 구성하고 연결을 사용자 지정하는 다른 옵션을 지정할 수 있습니다.

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    => optionsBuilder.UseCosmos(
        "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
        databaseName: "OptionsDB",
        options =>
        {
            options.ConnectionMode(ConnectionMode.Gateway);
            options.WebProxy(new WebProxy());
            options.LimitToEndpoint();
            options.Region(Regions.AustraliaCentral);
            options.GatewayModeMaxConnectionLimit(32);
            options.MaxRequestsPerTcpConnection(8);
            options.MaxTcpConnectionsPerEndpoint(16);
            options.IdleTcpConnectionTimeout(TimeSpan.FromMinutes(1));
            options.OpenTcpConnectionTimeout(TimeSpan.FromMinutes(1));
            options.RequestTimeout(TimeSpan.FromMinutes(1));
        });

위의 코드는 몇 가지 가능한 옵션을 보여 주세요. 이러한 옵션은 동시에 사용할 수 없습니다. 위에서 언급한 각 옵션의 영향에 대한 자세한 내용은 Azure Cosmos DB 옵션 설명서를 참조하세요.