Relaciones integradas y referencias manuales

Cuándo insertar documentos

Uso documentos incrustados cuando los datos relacionados suelen visualizarse en el contexto de su entidad superior y cuando los datos incrustados permanecen razonablemente limitados en tamaño. Esto incluye pequeños conjuntos de valores secundarios, como direcciones, configuraciones o una lista limitada de elementos recientes. Cuando insertas documentos, MongoDB Server puede mejorar el rendimiento al recuperar datos relacionados en una sola operación de base de datos y actualizar datos relacionados atómicamente dentro de un solo documento.

Considera la posibilidad de incrustación de datos en los siguientes casos:

• Normalmente, su aplicación lee los datos principales y subordinados juntos. Obtener todo en una sola consulta es más eficiente que hacer llamadas por separado.

• Los datos relacionados no crecen sin un límite superior claro. Los datos acotados no provocarán que los documentos crezcan indefinidamente ni que se alcance el límite de tamaño de documento de MongoDB, que es 16MB.

• Los datos relacionados no cambian con frecuencia ni de forma independiente del elemento padre. Esto supone menos sobrecarga por reescribir el documento principal.

Para obtener más información, consulta Datos integrados en la documentación del MongoDB Server.

Cómo integrar documentos

Puedes designar una entidad de propiedad de las siguientes formas:

• [Propiedad] Atributo: Aplica el atributo de anotación de datos [Owned] a la clase del modelo para el subdocumento. Este enfoque es declarativo y conciso, pero también menos flexible, porque se aplica globalmente a todos los usos del tipo poseído.

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

Las siguientes secciones proporcionan 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 usar referencias

Utiliza referencias cuando consultes regularmente los datos relacionados de forma independiente de sus padres, cuando el conjunto de hijos pueda crecer mucho o cuando los datos relacionados cambien con frecuencia.

Considera usar referencias en los siguientes casos:

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

• Se debe consultar la entidad relacionada de forma independiente. Puedes query e indexar la colección secundaria directamente sin escanear los documentos principales.

• Los datos relacionados cambian con frecuencia e independientemente del padre. Las actualizaciones frecuentes de los datos embebidos requieren reescribir todo el documento principal cada vez, lo cual es ineficiente.

• La aplicación normalmente no lee conjuntamente los datos de padre e hijo. Al usar referencias, evitas obtener datos secundarios innecesarios.

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

• Duplicar los datos generaría demasiada sobrecarga de actualizar.

Para obtener más información, consulta Datos de referencia en la documentación de MongoDB Server.

Cómo usar 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, debes query 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 discutidos en esta guía, consulte la siguiente documentación de la API de Microsoft:

• [Propio]

• OwnsOne()

• OwnsMany()