嵌入式关系和手册参考

何时嵌入式文档

当相关数据通常在其父级的上下文中显示且嵌入数据的大小保持在合理范围内时，请使用嵌入式文档。这包括少量的子值，例如地址、设置或有限的最近项目列表。嵌入式文档时，MongoDB Server 可以通过在单个数据库操作中检索相关数据以及在单个文档中原子更新相关数据来提高性能。

在以下情况下考虑嵌入数据：

• 您的应用程序通常会同时读取父和子数据。在一个查询中获取所有内容比单独调用更有效。

• 相关数据的增长没有明确的上限。有界数据不会导致文档无限增长或达到 MongoDB 的 16MB 文档大小限制。

• 相关数据不会频繁变化，也不会独立于父级变化。这样可以减少重写父级文档的开销。

要了解更多信息，请参阅 MongoDB Server 文档中的嵌入数据。

如何嵌入式文档

您可以通过以下方式指定所有的实体：

• [所有] 属性：将 [Owned] 数据注释属性应用于子文档的模型类。这种方法是声明性的和简洁的，但灵活性也较差，因为它全局应用于所有所有类型的用法。

• 流畅 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 文档：

• [ 所有 ]

• OwnsOne()

• OwnsMany()