Relaciones entre modelos y desnormalización

Datos de muestra

Los ejemplos de esta guía definen modelos que representan las siguientes colecciones en la sample_mflix database:

• moviesAlmacena información sobre películas.

• embedded_movies: Extiende movies con incrustaciones de gráficos vectoriales

• usersAlmacena información sobre los espectadores de películas.

• commentsAlmacena información sobre los comentarios de las películas.

Para obtener más información sobre la base de datos sample_mflix, consulte Consulte el conjunto de datos de ejemplo de Mflix en la documentación de MongoDB Atlas.

Integrar modelos relacionados

Utilice un modelo integrado cuando se cumplan todas las siguientes condiciones:

• Los datos relacionados siempre se leen junto con el documento principal.

• Los datos relacionados pertenecen a un único progenitor y no se comparten entre varios documentos.

• El número de elementos relacionados es limitado y predecible.

Para incrustar datos relacionados, defina una clase de modelo incrustado como una subclase EmbeddedModel de, luego use un EmbeddedModelField para almacenarlo en el modelo padre.

El siguiente ejemplo define un modelo incrustado Director y luego define un modelo Movie que almacena una instancia del modelo Director:

from django.db import models
from django_mongodb_backend.models import EmbeddedModel
from django_mongodb_backend.fields import EmbeddedModelField
class Director(EmbeddedModel):
    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
class Movie(models.Model):
    title = models.CharField(max_length=200)
    director = EmbeddedModelField(Director, null=True, blank=True)

Para obtener más información sobre los modelos integrados, consulte Almacene los datos del modelo incrustado en la guía Crear modelos.

Almacenar datos de arreglo

Utilice un ArrayField para almacenar una lista de valores escalares relacionados directamente en el documento principal. Los datos del array se almacenan en el mismo documento de MongoDB y se recuperan en una única operación de lectura sin realizar $lookup operaciones. Utilice esta estrategia cuando se cumplan las siguientes condiciones:

• Los valores relacionados son escalares simples, como cadenas de caracteres o números enteros.

• El tamaño del array es limitado y predecible.

El siguiente ejemplo define un modelo Movie que almacena una lista de cadenas en el campo cast:

from django.db import models
from django_mongodb_backend.fields import ArrayField
class Movie(models.Model):
    title = models.CharField(max_length=200)
    cast = ArrayField(models.CharField(max_length=100), blank=True)

Para almacenar matrices de documentos estructurados en lugar de valores escalares, utilice un EmbeddedModelArrayField. Para obtener más información, consulte la sección «Almacenar datos de matrices de modelos incrustados» en la guía «Crear modelos».

ForeignKey

Utilice un campo para crear una relación de muchos a uno entre dos modelos. Cada documento del modelo que hace referencia se vincula a un documento del modelo referenciado. Pase los siguientes argumentos ForeignKey al ForeignKey() constructor:

• to: La clase del modelo a la que enlazar

• on_delete: El comportamiento de eliminación cuando se elimina el documento referenciado

El siguiente ejemplo vincula un modelo Comment con un modelo Movie mediante un campo ForeignKey. Al eliminar un documento sample_mflix.movies, también se eliminan todos los documentos sample_mflix.comments relacionados:

from django.db import models
class Movie(models.Model):
    title = models.CharField(max_length=200)
class Comment(models.Model):
    movie = models.ForeignKey(
        Movie,
        on_delete=models.CASCADE,
    )
    text = models.TextField()

OneToOneField

Utilice un campo para crear una relación uno a uno entre dos modelos. Cada documento del modelo de referencia se vincula con exactamente un documento del modelo referenciado. Pase los siguientes argumentos OneToOneField al OneToOneField() constructor:

• to: La clase del modelo a la que enlazar

• on_delete: El comportamiento de eliminación cuando se elimina el documento referenciado

El siguiente ejemplo define un modelo EmbeddedMovie que se vincula a un modelo Movie mediante un campo OneToOneField. Al eliminar un documento sample_mflix.movies, su documento sample_mflix.embedded_movies vinculado también se elimina:

from django.db import models
from django_mongodb_backend.fields import ArrayField
class Movie(models.Model):
    title = models.CharField(max_length=200)
class EmbeddedMovie(models.Model):
    movie = models.OneToOneField(
        Movie,
        on_delete=models.CASCADE,
    )
    plot_embedding = ArrayField(models.FloatField(), blank=True)

Campo de muchos a muchos

Utilice un campo para crear una relación de muchos a muchos entre dos modelos. Cada documento de cualquiera de los modelos puede vincularse a varios documentos del otro modelo. Pase la clase del modelo al que se vinculará como primer argumento ManyToManyField al ManyToManyField() constructor.

El siguiente ejemplo vincula un modelo Viewer con un modelo Movie. Cada espectador puede ver varias películas, y cada película puede ser vista por varios espectadores:

from django.db import models
class Movie(models.Model):
    title = models.CharField(max_length=200)
class Viewer(models.Model):
    name = models.CharField(max_length=100)
    email = models.CharField(max_length=200)
    watched = models.ManyToManyField(Movie, blank=True)