Relacionamentos de modelo e desnormalização

Dados de amostra

Os exemplos nesta guia definem modelos que representam as seguintes coleções no banco de dados do sample_mflix :

• movies: armazena informações sobre filmes

• embedded_movies: Estende movies com incorporações de gráficos vetoriais

• users: Armazena informações sobre os visualizadores de filmes

• comments: armazena informações sobre comentários do filme

Para saber mais sobre o sample_mflix banco de dados, consulte Amostra de conjunto de dados Mflix na documentação do MongoDB Atlas .

Incorporar modelos relacionados

Use um modelo incorporado quando todas as seguintes condições se aplicarem:

• Os dados relacionados são sempre lidos junto com o documento principal.

• Os dados relacionados pertencem a um único principal e não são compartilhados em vários documentos.

• O número de itens relacionados é limitado e previsível.

Para incorporar dados relacionados, defina uma classe de modelo incorporado como uma subclasse de EmbeddedModel e, em seguida, use um EmbeddedModelField para armazená-los no modelo principal.

O exemplo a seguir define um modelo embarcado Director e, em seguida, define um modelo Movie que armazena uma instância do 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 saber mais sobre modelos embarcados, consulte Armazenar dados de modelo embarcados no guia Criar modelos.

Armazenar dados de array

Use um ArrayField para armazenar uma lista de valores escalares relacionados diretamente no documento principal. Os dados da matriz são armazenados no mesmo documento MongoDB e recuperados em uma única operação de leitura sem executar $lookup operações. Use essa estratégia quando as seguintes condições se aplicarem:

• Os valores relacionados são escalares simples, como strings ou inteiros.

• O tamanho da array é limitado e previsível.

O exemplo seguinte define um modelo Movie que armazena uma lista de strings no 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 armazenar arrays de documentos estruturados em vez de valores escalares, use um EmbeddedModelArrayField. Para saber mais, consulte Armazenar dados de array de modelos incorporados no guia Criar modelos.

Chave estrangeira

Use um campo para criar um relacionamento de muitos para um entre dois modelos. Cada documento no modelo de referência vincula a um documento no modelo referenciado. Passe os seguintes argumentos para ForeignKey o ForeignKey() construtor:

• to: a classe de modelo à qual vincular

• on_delete: O comportamento de exclusão quando você exclui o documento referenciado

O exemplo seguinte vincula um modelo Comment a um modelo Movie usando um campo ForeignKey . Quando você exclui um documento sample_mflix.movies, todos os documentos sample_mflix.comments relacionados também são excluídos:

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

Use um campo para criar um relacionamento um-para-um entre dois modelos. Cada documento no modelo de referência vincula a exatamente um documento no modelo referenciado. Passe os seguintes argumentos para OneToOneField o OneToOneField() construtor:

• to: a classe de modelo à qual vincular

• on_delete: O comportamento de exclusão quando o documento referenciado é excluído

O exemplo seguinte define um modelo EmbeddedMovie que se vincula a um modelo Movie usando um campo OneToOneField . Quando você exclui um documento sample_mflix.movies, o documento sample_mflix.embedded_movies vinculado também é excluído:

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)

Campos manytomany

Use um campo para criar um relacionamento de muitos para muitos entre dois modelos. Cada documento em qualquer modelo pode ser vinculado a vários documentos no outro modelo. Passe a classe do modelo a ser vinculada como o primeiro argumento para ManyToManyField o ManyToManyField() construtor.

O exemplo seguinte vincula um modelo Viewer a um modelo Movie. Cada visualizador pode assistir a vários filmes, e cada filme pode ser assistido por vários visualizadores:

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)