Relaciones integradas y referencias manuales

Cuándo insertar documentos

Utilice documentos incrustados cuando los datos relacionados se visualizan habitualmente en el contexto de su documento principal y cuando el tamaño de los datos incrustados se mantiene razonablemente limitado. Esto incluye pequeños conjuntos de valores secundarios, como direcciones, configuraciones o una lista limitada de elementos recientes. Al incrustar documentos, MongoDB Server puede mejorar el rendimiento recuperando los datos relacionados en una sola operación de base de datos y actualizándolos de forma atómica dentro de un mismo documento.

Considere la posibilidad de incrustar datos en los siguientes casos:

• Normalmente, tu aplicación lee los datos del elemento padre y del elemento hijo conjuntamente. Obtener toda la información en una sola consulta es más eficiente que realizar llamadas separadas.

• Los datos relacionados no crecen sin un límite superior claro. Los datos limitados no harán que los documentos crezcan indefinidamente ni alcanzarán el límite de tamaño de documento de 16MB de MongoDB.

• Los datos relacionados no cambian con frecuencia y son independientes del documento principal. Esto reduce la sobrecarga que supone reescribir el documento principal.

Para obtener más información, consulte Datos incrustados en la documentación del servidor MongoDB.

Cómo insertar documentos

Puede designar una entidad de su propiedad de las siguientes maneras:

• [Propiedad] Atributo: Aplicar el [Owned] Atributo de anotación de datos a la clase del modelo para el subdocumento. Este enfoque es declarativo y conciso, pero también menos flexible, ya que se aplica globalmente a todos los usos del tipo en cuestión.

• API fluida: Llama a OwnsOne() los OwnsMany() métodos o en tu DbContext configuración. Este enfoque ofrece mayor control y flexibilidad, permitiéndote configurar la relación de forma diferente para entidades específicas sin modificar la clase del modelo.

Las siguientes secciones ofrecen ejemplos de estos enfoques para modelar entidades de propiedad única y múltiple.

[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 }
  ]
}

Cuándo utilizar referencias

Utilice referencias cuando consulte regularmente los datos relacionados independientemente de su elemento principal, cuando el conjunto de datos secundarios pueda llegar a ser muy grande o cuando los datos relacionados cambien con frecuencia.

Considere utilizar referencias en los siguientes casos:

• Los datos relacionados crecen sin un límite superior definido. Los arreglos sin límite pueden causar problemas de rendimiento y podrían alcanzar el límite de tamaño de documento de 16MB de MongoDB.

• Debes consultar la entidad relacionada por separado. Puedes consultar e indexar la colección secundaria directamente sin necesidad de escanear los documentos principales.

• Los datos relacionados cambian con frecuencia y de forma independiente del documento principal. Las actualizaciones frecuentes de los datos incrustados requieren reescribir todo el documento principal cada vez, lo cual resulta ineficiente.

• La aplicación no suele leer los datos del elemento padre y del elemento hijo conjuntamente. Al usar referencias, se evita obtener datos del elemento hijo que no se necesitan.

• La relación es de muchos a muchos o compleja de alguna otra manera.

• Duplicar los datos generaría una sobrecarga de actualización excesiva.

Para obtener más información,consulte los datos de referencia en la documentación del servidor MongoDB.

Cómo utilizar las referencias

El siguiente ejemplo muestra cómo almacenar una referencia a una entidad relacionada:

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; }
}

Para recuperar la entidad relacionada, debe consultar la colección referenciada por separado, como se muestra en el siguiente ejemplo:

// 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);

Documentación de la API

Para obtener más información sobre los métodos y tipos que se describen en esta guía, consulte la siguiente documentación de la API de Microsoft:

• [Propiedad]

• PoseeUno()

• Posee muchos()