Especificar uma query

API de Consulta

A API Django QuerySet fornece métodos que permitem recuperar objetos de modelo. Para executar uma query de banco de dados MongoDB , chame os métodos QuerySet no gerenciador do seu modelo. A classe Manager lida com operações de banco de dados e permite que você interaja com os dados do MongoDB fazendo referência a modelos do Django. Por padrão, o Django adiciona um Manager denominado objects a cada classe de modelo.

Quando você atribui um QuerySet a uma variável, o Django MongoDB Backend não executa a operação até que você avalie a variável. Depois de avaliar QuerySet, o Django salva os resultados da query no cache QuerySet. Futuras avaliações do QuerySet usam os resultados em cache.

Dados de amostra

Os exemplos neste guia usam o Movie modelo, que representa a sample_mflix.movies collection dos conjuntos de dados de amostra do Atlas . O modelo Movie contém um modelo Award incorporado como valor de seu campo awards. Essas classes de modelo têm as seguintes definições:

from django.db import models
from django_mongodb_backend.models import EmbeddedModel
from django_mongodb_backend.fields import EmbeddedModelField, ArrayField
class Award(EmbeddedModel):
    wins = models.IntegerField(default=0)
    nominations = models.IntegerField(default=0)
    text = models.CharField(max_length=100)
class Movie(models.Model):
    title = models.CharField(max_length=200)
    plot = models.TextField(blank=True)
    runtime = models.IntegerField(default=0)
    released = models.DateTimeField("release date", null=True, blank=True)
    awards = EmbeddedModelField(Award)
    genres = ArrayField(models.CharField(max_length=100), null=True, blank=True)
    imdb = models.JSONField(null=True)
    class Meta:
        db_table = "movies"
        managed = False
    
    def __str__(self):
        return self.title

O modelo Movie inclui uma classe Meta interna, que especifica os metadados do modelo, e um método __str__(), que define a representação de string do modelo. Para saber mais sobre essas funcionalidades de modelo, consulte Definir um modelo no guia Criar modelos.

python manage.py shell

from <your application name>.models import Movie, Award
from django.utils import timezone
from datetime import datetime

Recuperar todos os documentos

Para recuperar todos os documentos de uma collection, chame o método all() no gerenciador do seu modelo.

O exemplo a seguir chama o método all() para recuperar todos os documentos na coleção sample_mflix.movies:

Movie.objects.all()

<QuerySet [<Movie: The Great Train Robbery>, <Movie: A Corner in Wheat>,
<Movie: Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics>,
<Movie: Traffic in Souls>, <Movie: Gertie the Dinosaur>,
<Movie: In the Land of the Head Hunters>, <Movie: The Perils of Pauline>,
<Movie: The Italian>, <Movie: Regeneration>, <Movie: Civilization>,
'...(remaining elements truncated)...']>

Recuperar documentos correspondentes

Para fazer query de uma coleção para documentos que correspondam a um conjunto de critérios, chame o método filter() no gerenciador do seu modelo. Passe um filtro de query para o método filter() que especifica seus critérios de query.

O exemplo a seguir chama o método filter() para fazer query da collection sample_mflix.movies para documentos que tenham um valor runtime de 300:

Movie.objects.filter(runtime=300)

<QuerySet [<Movie: Wild Palms>, <Movie: Streets of Laredo>,
<Movie: The Way We Live Now>]>

Retrieve One Document

Para recuperar um documento de uma coleção, chame o método get() no gerenciador do seu modelo. Passe um filtro de query para o método get() que especifica seus critérios de query.

O exemplo a seguir chama o método get() para recuperar um documento que tem um valor title de "Finding Nemo":

Movie.objects.get(title="Finding Nemo")

<Movie: Finding Nemo>

Excluir Documentos Correspondentes

Para fazer query de uma coleção de documentos que não atendem aos seus critérios de pesquisa, chame o método exclude() no gerenciador do seu modelo. Passe os critérios de exclusão como um argumento para o método exclude().

O exemplo a seguir chama o método exclude() para excluir documentos lançados antes de datetime(1980, 1, 1) (janeiro de 1, 1980) dos resultados:

Movie.objects.exclude(released__lt=timezone.make_aware(datetime(1980, 1, 1)))

<QuerySet [<Movie: The Iron Horse>, <Movie: Le grand jeu>,
<Movie: The Devil Is a Woman>, <Movie: Children in the Wind>,
<Movie: Too Much Johnson>, <Movie: Dots>, <Movie: The Blood of Jesus>,
<Movie: The Land>, <Movie: The Brothers and Sisters of the Toda Family>,
<Movie: Begone Dull Care>, '...(remaining elements truncated)...']>

Executar queries de banco de dados brutas

Se quiser executar queries complexas que a API de query do Django não suporta, você pode usar o método raw_aggregate(). Esse método permite que você especifique seus critérios de query em um agregação pipeline do MongoDB , que você passa como argumento para raw_aggregate().

Para saber como executar queries de banco de dados bruto, consulte o guia Executar queries de banco de dados bruto.

Usar pesquisas de correspondência de texto

A tabela a seguir descreve alguns dos tipos de pesquisa que você pode usar para executar queries que incluem critérios correspondentes específicos para valores de texto:

Movie.objects.filter(plot__contains="coming-of-age")

<QuerySet [<Movie: Murmur of the Heart>, <Movie: Desert Bloom>,
<Movie: Girls Town>, <Movie: Get Real>, <Movie: Man of Steel>,
<Movie: The Holy Land>, <Movie: Secondhand Lions>, <Movie: How to Be Louise>,
<Movie: Mouth to Mouth>, <Movie: Che ne sarè di noi>, <Movie: Roll Bounce>,
'...(remaining elements truncated)...']>

Usar pesquisas de comparação

A tabela a seguir descreve alguns dos tipos de pesquisa que você pode usar para executar queries que avaliam um valor de campo em relação a um valor especificado:

Movie.objects.filter(runtime__lte=50)

<QuerySet [<Movie: The Great Train Robbery>, <Movie: A Corner in Wheat>,
<Movie: Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics>,
<Movie: Gertie the Dinosaur>, <Movie: From Hand to Mouth>,
<Movie: High and Dizzy>, <Movie: One Week>, <Movie: Now or Never>,
'...(remaining elements truncated)...']>

Combinar pesquisas

Você pode executar queries que usam vários conjuntos de critérios correspondentes das seguintes maneiras:

• Passe vários filtros de query para o seu método de query, separados por vírgulas. Para ver um exemplo, consulte Recuperando objetos na documentação do Django.

• Encadeie métodos de query juntos. Para saber mais, consulte Encadeamento de filtros na documentação do Django.

• Use Q objetos e separe cada objeto com um operador lógico. Para saber mais, consulte Pesquisas complexas com objetos Q na documentação do Django.

Movie.objects.filter(
    (Q(title__startswith="Funny") | Q(title__startswith="Laugh")) 
    & ~Q(genres__contains=["Comedy"])
)

<QuerySet [<Movie: Laugh, Clown, Laugh>, <Movie: Funny Games>]>

Classificar resultados

Você pode fornecer uma ordem de classificação para os resultados da query usando o método order_by(). Para especificar uma classificação ascendente com base nos valores de um determinado campo, passe o nome do campo como argumento. Para especificar uma classificação decrescente, passe o nome do campo prefixado com um símbolo de menos (-) como argumento.

Você pode passar vários nomes de campo , separados por vírgulas, para o método order_by(). O Django MongoDB Backend classifica os resultados de cada campo na ordem fornecida.

Movie.objects.filter(title__startswith="Rocky").order_by("released")

<QuerySet [<Movie: Rocky>, <Movie: Rocky II>, <Movie: Rocky III>,
<Movie: Rocky IV>, <Movie: Rocky V>, <Movie: Rocky Marciano>,
<Movie: Rocky Balboa>]>

Ignorar e limitar resultados

Você pode especificar o número de resultados que uma query retorna usando a sintaxe de fatia de matriz do Python, conforme mostrado no código a seguir:

Model.objects.filter(<query filter>)[<start>:<end>]

Substitua os placeholders <start> e <end> por valores inteiros que representam o subconjunto de resultados que você deseja retornar. O valor inicial é exclusivo e o valor final é inclusivo.

Se você omitir o valor <start>, a query retornará cada resultado, começando com a primeira correspondência, até retornar o número especificado pelo valor <end>.

Se você omitir o valor do <end>, a query retornará cada resultado, mas ignorará o número de resultados iniciais especificado por <start>.

Movie.objects.filter(released=timezone.make_aware(datetime(2010, 7, 16)))[2:4]

<QuerySet [<Movie: Inception>, <Movie: Winter's Bone>]>

Recuperar o primeiro resultado

Para recuperar o primeiro resultado de uma query que pode corresponder a vários resultados, encadeie o método first() ao método filter(). Passe um filtro de query para o método filter() que especifica seus critérios de query.

O exemplo a seguir chama os métodos filter() e first() para consultar a coleção sample_mflix.movies para o primeiro documento no qual o valor genres é ["Crime", "Comedy"]:

Movie.objects.filter(genres=["Crime", "Comedy"]).first()

<Movie: The Crew>

Consultar valores de modelos incorporados

Você pode executar operações em seu modelo que consultam campos de modelos incorporados. Para executar query desses campos, especifique o campo do modelo e cada nome de campo incorporado separados por sublinhados duplos (__) até chegar ao campo que deseja executar a query, conforme mostrado no código a seguir:

Model.objects.filter(<model field>__<embedded model field>=<value>)

Você também pode usar pesquisas de campo para refinar sua query de modelo embarcado. Adicione seu tipo de pesquisa após o campo do modelo incorporado que você está consultando, prefixado por sublinhados duplos.

Movie.objects.filter(awards__wins__gt=150)

<QuerySet [<Movie: The Lord of the Rings: The Return of the King>,
<Movie: No Country for Old Men>, <Movie: Slumdog Millionaire>,
<Movie: Boyhood>, <Movie: The Social Network>, <Movie: Inception>,
<Movie: Gravity>, <Movie: Gravity>, <Movie: The Artist>,
<Movie: 12 Years a Slave>, <Movie: Birdman: Or (The Unexpected Virtue of Ignorance)>]>

Valores de array de query

Você pode fazer query dos dados armazenados em um valor ArrayField usando a sintaxe de query padrão. O Django MongoDB Backend fornece tipos adicionais de pesquisa de campo para a consulta de valores ArrayField, que são descritos na tabela a seguir:

Movie.objects.filter(genres__overlap=["Adventure", "Family"])

<QuerySet [<Movie: The Poor Little Rich Girl>, <Movie: Robin Hood>,
<Movie: Peter Pan>, <Movie: The Thief of Bagdad>, <Movie: Clash of the Wolves>,
<Movie: Beau Geste>, <Movie: The Black Pirate>, <Movie: The Son of the Sheik>,
<Movie: Steamboat Willie>, <Movie: The Big Trail>, <Movie: The Champ>,
'...(remaining elements truncated)...']>

Valores de array de modelo incorporado de query

Você pode executar operações em seu modelo que consultam campos de uma array de modelos embarcados. Essas queries usam a mesma sintaxe descrita na seção Consultar valores de modelo incorporados:

Model.objects.filter(<model field>__<embedded model field>=<value>)

Você também pode usar pesquisas de campo para refinar sua query de modelo embarcado. Adicione seu tipo de pesquisa após o campo do modelo incorporado que você está consultando, prefixado por sublinhados duplos. No entanto, você só pode usar os seguintes tipos de pesquisa para executar query de um campo incorporado:

• exact

• iexact

• in

• gt

• gte

• lt

• lte

Movie.objects.filter(cast__len__gt=5)

Movie.objects.filter(cast__0__last_name="Winslet")

Movie.objects.filter(cast__0_2__last_name="Winslet")

Valores de modelo incorporado polimórfico de query

Para query dados armazenados em um valor de PolymorphicEmbeddedModelField, use a mesma sintaxe descrita na seção anterior Consultar valores de modelo incorporados. Você pode consultar campos compartilhados entre os modelos incorporados ou campos exclusivos a um modelo específico.

Movie.objects.filter(awards__wins=10)

Movie.objects.filter(awards__best_picture=True)

Valores de array de modelo incorporado polimórfico de query

Para query dados armazenados em um valor de PolymorphicEmbeddedModelArrayField, use a mesma sintaxe e operadores descritos na seção Consultar valores de array de modelo incorporado. Você pode consultar campos compartilhados entre os modelos incorporados ou campos exclusivos a um modelo específico.

Movie.objects.filter(awards__year__lt=2000)

Query JSON Values

Você pode fazer uma query dos dados armazenados em um valor JSONField usando a mesma sintaxe mostrada na seção Consultar valores de modelo incorporados. Encadeie cada campo e nome de campo aninhado juntos, separados por sublinhados duplos (__), até chegar ao campo que deseja fazer query.

O exemplo a seguir consulta o campo imdb com valor JSONFieldpara valores de seu campo votes aninhado que excedem 900000:

Movie.objects.filter(imdb__votes__gt=900000)

<QuerySet [<Movie: La nao capitana>, <Movie: The Godfather>,
<Movie: This Is Spinal Tap>, <Movie: Forrest Gump>, <Movie: Pulp Fiction>,
<Movie: The Shawshank Redemption>, <Movie: Se7en>,
<Movie: The Lord of the Rings: The Fellowship of the Ring>,
<Movie: The Matrix>, <Movie: Fight Club>,
<Movie: The Lord of the Rings: The Return of the King>,
<Movie: The Lord of the Rings: The Two Towers>, <Movie: The Shawshank Redemption>,
<Movie: Landet som icke èr>, <Movie: The Dark Knight>,
<Movie: The Danish Girl>, <Movie: The Dark Knight Rises>, <Movie: Inception>,
<Movie: Catching the Sun>, <Movie: Scouts Guide to the Zombie Apocalypse>,
'...(remaining elements truncated)...']>

from django.db.models.fields.json import KT
Movie.objects.annotate(score=KT("imdb__rating")).all().order_by("-score")

<QuerySet [<Movie: No Tomorrow>, <Movie: The Deposit>, <Movie: Man Down>,
<Movie: Convenience>, <Movie: Scouts Guide to the Zombie Apocalypse>,
<Movie: Another World>, <Movie: The Danish Girl>, <Movie: Ad Inexplorata>,
<Movie: Landet som icke èr>, <Movie: The Ghost and the Whale>,
<Movie: Coming to Terms>, <Movie: La nao capitana>, <Movie: All Eyes and Ears>,
<Movie: Catching the Sun>, <Movie: Manhattan Romance>, <Movie: Anomalisa>,
<Movie: Outliving Emily>, <Movie: Mary Loss of Soul>,
<Movie: The Childhood of a Leader>, <Movie: Krot na more>,
'...(remaining elements truncated)...']>

Valores de chave primária de query

Você pode usar o atalho de pesquisa pk para consultar valores de chave primária , que o MongoDB armazena como valores ObjectId.

O exemplo a seguir consulta a coleção sample_mflix.movies para um documento cuja chave primária é ObjectId("573a1394f29313caabce0d37"):

from bson import ObjectId
Movie.objects.get(pk=ObjectId("573a1394f29313caabce0d37"))

// Your ObjectId values might differ
<Movie: Vertigo>

O modelo Movie, que representa a collection sample_mflix.movies, usa o campo id como sua chave primária. O exemplo seguinte constrói a mesma query do código anterior utilizando o campo id :

from bson import ObjectId
Movie.objects.get(id=ObjectId("573a1394f29313caabce0d37"))