Relaciones de modelo y desnormalización

Datos de muestra

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

• movies: almacena información sobre películas

• embedded_moviesExtiende movies con incrustaciones de gráficos vectoriales

• users: Almacena información acerca de los espectadores de películas

• comments: Almacena información sobre los comentarios de películas

Para obtener más información sobre la base de datos sample_mflix, consulte Conjunto de datos de Mflix de muestra en la documentación de MongoDB Atlas.

Incorporar 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 solo padre y no se comparten entre varios documentos.

• La cantidad de elementos relacionados está limitada y es predecible.

Para integrar datos relacionados, define una clase de modelo incrustado como una subclase de EmbeddedModel, luego utiliza un EmbeddedModelField para almacenarlo en el modelo principal.

El siguiente ejemplo define un modelo Director incrustado 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 embebidos, consulta Almacenar datos integrados del modelo 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 de la matriz se almacenan en el mismo documento de MongoDB y se recuperan en una sola operación de lectura sin realizar operaciones $lookup. Utiliza esta estrategia cuando se cumplan las siguientes condiciones:

• Los valores relacionados son escalares simples, como cadenas o enteros.

• El tamaño del arreglo está limitado y es predecible.

El siguiente ejemplo define un modelo de 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 arreglos de documentos estructurados en lugar de valores escalares, utilice un EmbeddedModelArrayField en su lugar. Para obtener más información, consulta almacenar datos de arreglos de modelos integrados en la guía Crear modelos.

ForeignKey

Utiliza un campo ForeignKey para crear una relación de muchos a uno entre dos modelos. Cada documento en el modelo de referencia se vincula a un documento en el modelo referenciado. Pasa los siguientes argumentos al constructor ForeignKey():

• toLa clase de modelo para enlazar

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

El siguiente ejemplo vincula un modelo Comment a un modelo Movie utilizando un campo ForeignKey. Cuando borras un sample_mflix.movies documento, también se borran todos los sample_mflix.comments documentos 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

Usa un campo OneToOneField para crear una relación uno a uno entre dos modelos. Cada documento en el modelo de referencia está vinculado a exactamente un documento en el modelo referenciado. Pase los siguientes argumentos al constructor de OneToOneField():

• toLa clase de modelo para enlazar

• on_deleteComportamiento 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. Cuando eliminas un documento de sample_mflix.movies, también se elimina su documento vinculado de sample_mflix.embedded_movies:

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)

ManyToManyField

Utiliza un campo ManyToManyField para crear una relación de muchos a muchos entre dos modelos. Cada documento en cualquiera de los modelos puede estar vinculado a varios documentos en el otro modelo. Pasa la clase del modelo con la que se va a vincular como el primer argumento en el constructor de ManyToManyField().

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)