포함된 관계 및 수동 참조

문서를 임베드해야 하는 경우

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

다음과 같은 경우 데이터 포함을 고려하세요.

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

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

• 관련 데이터는 상위 데이터와 독립적으로 자주 변경되지 않습니다. 이렇게 하면 상위 문서 다시 작성하는 데 드는 오버헤드 줄어듭니다.

자세한 학습 은 MongoDB Server 설명서에서 내장된 데이터를 참조하세요.

문서 임베드 방법

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

• [소유] 속성: [Owned] 하위 문서의 모델 클래스에 데이터 주석 속성을 적용합니다. 이 접근 방식은 선언적이며 간결하지만 소유된 유형의 모든 용도에 전역적으로 적용되므로 유연성이 떨어집니다.

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

다음 섹션에서는 단일 및 다중 소유 엔터티를 모델링하기 위한 이러한 접근 방식의 예를 제공합니다.

[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 설명서를 참조하세요.

• [소유]

• OwnersOne()

• OwnersMany()