포함된 관계 및 수동 참조

내장된 문서 삽입 시기

관련 데이터가 일반적으로 상위 데이터의 컨텍스트에서 표시되고 내장된 데이터의 크기가 합리적으로 제한되는 경우 내장된 문서를 사용합니다. 여기에는 주소, 설정 또는 제한된 최근 항목 목록과 같은 작은 하위 값 집합이 포함됩니다. 문서를 임베드할 때 MongoDB Server 단일 데이터베이스 작업으로 관련 데이터를 검색하고 단일 문서 내에서 관련 데이터를 원자적으로 업데이트하여 성능을 향상시킬 수 있습니다.

다음 경우에 데이터 임베딩을 고려해 보세요.

• 애플리케이션은 일반적으로 부모 및 자식 데이터를 함께 읽습니다. 별도 호출하는 것보다 하나의 쿼리에서 모든 것을 가져오는 것이 더 효율적입니다.

• 관련 데이터는 명확한 상한 없이 증가하지 않습니다. 버든디드 데이터로 인해 문서가 무기한적으로 증가하거나 MongoDB의 16MB 문서 크기 제한에 도달하지 않습니다.

• 관련 데이터는 부모와 독립적으로 자주 변경되지 않습니다. 이로 인해 부모 문서를 다시 작성하는 데 소요되는 오버헤드가 줄어듭니다.

자세한 내용은 MongoDB Server 문서의 내장 데이터 를 참조하세요.

내장된 문서

소유한 엔티티는 다음과 같은 방법으로 지정할 수 있습니다.

• [소유] 속성: 서브문서의 모델 클래스에 [Owned] 데이터 주석 속성을 적용합니다. 이 방식은 선언적이고 간결하지만, 소유한 유형의 모든 사용에 전역적으로 적용되므로 유연성이 떠어집니다.

• Fluent API: DbContext 구성에서 OwnsOne() 또는 OwnsMany() 메서드를 호출합니다. 이 방법은 모델 클래스를 수정하지 않고도 특정 개체에 대해 관계를 다르게 구성할 수 있어 더 많은 제어와 유연성을 제공합니다.

다음 섹션에서는 단일 및 다중 소유 개체 모델링에 대한 이러한 접근 방법의 예시를 제공합니다.

[Owned]
public class Address
{
    public string Street { get; set; } = null!;
    public string City { get; set; } = null!;
    public string Country { get; set; } = null!;
}
public class Customer
{
    public ObjectId Id { get; set; }
    public string Name { get; set; } = null!;
    public Address Address { get; set; } = null!;
}

public class CustomerDbContext : DbContext
{
    public DbSet<Customer> Customers { get; set; } = null!;
    public CustomerDbContext(DbContextOptions options) : base(options) { }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        modelBuilder.Entity<Customer>(c =>
        {
            c.OwnsOne(c => c.Address);
            c.ToCollection("customers");
        });
    }
}

{
  "_id": ObjectId("..."),
  "Name": "John Doe",
  "Address": {
    "Street": "123 Main St",
    "City": "New York",
    "Country": "USA"
  }
}

[Owned]
public class Order
{
    public string Product { get; set; } = null!;
    public int Quantity { get; set; }
}
public class CustomerWithOrders
{
    public ObjectId Id { get; set; }
    public string Name { get; set; } = null!;
    public List<Order> Orders { get; set; } = new();
}

public class OrderDbContext : DbContext
{
    public DbSet<CustomerWithOrders> Customers { get; set; } = null!;
    public OrderDbContext(DbContextOptions options) : base(options) { }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        modelBuilder.Entity<CustomerWithOrders>(c =>
        {
            c.OwnsMany(c => c.Orders);
            c.ToCollection("customers");
        });
    }
}

{
  "_id": ObjectId("..."),
  "Name": "Jane Smith",
  "Orders": [
    { "Product": "Laptop", "Quantity": 1 },
    { "Product": "Mouse", "Quantity": 2 }
  ]
}

참조를 사용하는 경우

자식 세트가 매우 커질 수 있거나 관련 데이터가 자주 변경되는 경우 또는 부모와 독립적으로 관련 데이터를 정기적으로 쿼리하는 경우 참조를 사용합니다.

다음 경우 참조를 사용하는 것을 고려해 보세요.

• 관련 데이터는 명확한 상한 없이 증가합니다. 제한이 없는 배열은 성능 문제를 일으키고 MongoDB의 16MB 문서 크기 제한에 도달할 수 있습니다.

• 관련 엔터티를 자체적으로 쿼리해야 합니다. 부모 문서를 스캔하지 않고 하위 컬렉션을 직접 쿼리하고 인덱싱할 수 있습니다.

• 관련 데이터는 부모와 독립적으로 자주 변경됩니다. 내장된 데이터의 자주 업데이트는 매번 전체 부모 문서를 다시 작성해야 하므로 비효율적입니다.

• 애플리케이션은 일반적으로 부모 및 자식 데이터를 함께 읽지 않습니다. 참조를 사용하면 필요하지 않은 자식 데이터를 가져오는 것을 피할 수 있습니다.

• 관계는 다대다 관계이거나 다른 복잡한 관계입니다.

• 데이터를 복제하면 업데이트 오버헤드가 너무 많이 생긵니다.

자세히 학습하려면 MongoDB Server 문서의 참조 데이터 를 참조하세요.

참조 사용 방법

다음 예시는 관련 개체에 대한 참조를 저장하는 방법을 보여줍니다.

public class Author
{
    public ObjectId Id { get; set; }
    public string Name { get; set; } = null!;
}
public class Book
{
    public ObjectId Id { get; set; }
    public string Title { get; set; } = null!;
    // Store reference to Author by storing the Author's Id
    public ObjectId AuthorId { get; set; }
}

관련 개체를 조회하려면 다음 예시에 표시된 것처럼 참조된 컬렉션을 별도로 쿼리해야 합니다.

// Query a book and its author
var book = db.Books.FirstOrDefault(b => b.Title == "My Book");
var author = db.Authors.FirstOrDefault(a => a.Id == book!.AuthorId);

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 Microsoft API 문서를 참조하세요.

• [Owned]

• OwnsOne()

• OwnsMany()