嵌入式关系和手册参考

何时嵌入文档

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

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

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

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

• 相关数据不会经常更改，且独立于父项。这样可以减少重写父文档所产生的开销。

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

如何嵌入文档

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

• [Owned] 属性：将 [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文档：

• [Owned]

• OwnsOne()

• OwsMany()