Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Consultas em uma array

Você pode fazer queries de arrays no MongoDB usando os seguintes métodos:


➤ Use o menu suspenso Selecione a linguagem no canto superior direito para definir a linguagem dos exemplos a seguir ou selecione MongoDB Compass.


Esta página fornece exemplos de operações de query em campos de array utilizando o método db.collection.find() em mongosh.

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar este conjunto de dados em sua implantação do MongoDB autogerenciado, consulte Carregar o conjunto de dados de amostra. Se você fez alguma modificação nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

Para especificar uma condição de igualdade em uma array, utilize o documento de query { <field>: <value> } onde <value> é a array exata para corresponder, incluindo a ordem dos elementos.

As seguintes queries de exemplo para todos os documentos onde genres é uma array com exatamente dois elementos, "Action" e "Comedy", na ordem especificada:

db.movies.find( { genres: ["Action", "Comedy"] } )

Para localizar uma array que contenha "Action" e "Comedy", independentemente da ordem ou de outros elementos da array, use o operador $all:

db.movies.find( { genres: { $all: ["Action", "Comedy"] } } )

Para consultar se o campo de array contém pelo menos um elemento com o valor especificado, utilize o filtro { <field>: <value> } onde <value> é o valor do elemento.

As seguintes consultas de exemplo para todos os documentos onde o array genres contém a string "Short" como um de seus elementos:

db.movies.find( { genres: "Short" } )

Para especificar condições sobre os elementos no campo de array, use operador de query no documento de filtro de query:

{ <array field>: { <operator1>: <value1>, ... } }

As seguintes queries de exemplo para todos os documentos onde a array cast contém pelo menos um elemento que corresponde à expressão regular ^A:

db.movies.find( { cast: { $regex: "^A" } } )

Ao especificar condições compostas em elementos de array, você pode consultar documentos onde:

  • Um único elemento do array atende a todas as condições especificadas

  • Diferentes elementos de array atendem coletivamente a todas as condições, com cada elemento satisfazendo uma ou mais condições

As seguintes queries de exemplo para documentos onde o array cast contém elementos que, em alguma combinação, satisfazem as condições da query. Um elemento pode satisfazer a condição $regex: "^A" e outro elemento pode satisfazer a condição $ne: "Adam Sandler", ou um único elemento pode satisfazer ambos:

db.movies.find( { cast: { $regex: "^A", $ne: "Adam Sandler" } })

Use o operador $elemMatch para especificar vários critérios em elementos de array de forma que pelo menos um elemento de array satisfaça todos os critérios especificados.

O exemplo a seguir query documentos em que o array cast contém pelo menos um elemento que corresponde à expressão regular ^A e não é igual a "Adam Sandler":

db.movies.find( { cast: { $elemMatch: { $regex: "^A", $ne: "Adam Sandler" } } })

Use a notação de ponto para especificar condições de query para um elemento em um determinado índice ou posição da array. A array usa indexação baseada em zero.

Observação

Quando você consulta usando notação de ponto, o campo e o campo aninhado devem estar entre aspas.

O exemplo a seguir consulta todos os documentos em que o primeiro elemento do array cast é igual a "Tom Hanks":

db.movies.find( { "cast.0": "Tom Hanks" } )

Use o operador $size para consultar arrays por número de elementos.

O exemplo a seguir seleciona documentos em que genres tem 3 elementos:

db.movies.find( { genres: { $size: 3 } } )

O exemplo nesta seção utiliza o conjunto de dados de filmes de amostra. Para saber como carregar o conjunto de dados de amostra em sua implantação do MongoDB Atlas, consulte Carregue dados de amostra.

Para fazer uma query de um array no MongoDB Atlas, siga estas etapas:

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Clusters sob o título Database.

    A página Clusters é exibida.

2
  1. Para o cluster que contém os dados de amostra, clique em Browse Collections.

  2. No painel de navegação esquerdo, selecione o banco de dados sample_mflix.

  3. Selecione a collection movies.

3

Para consultar um documento que contenha um array, especifique um documento de filtro de query. Um documento de filtro de query usa operadores de query para especificar condições de pesquisa. Use os seguintes documentos de exemplo para consultar campos de array na coleção sample_mflix.movies.

Para aplicar um filtro de query, copie um documento de exemplo na barra de pesquisa Filter e clique em Apply.

Para especificar uma condição de igualdade em uma array, utilize o documento de query { <field>: <value> } onde <value> é a array exata para corresponder, incluindo a ordem dos elementos. O exemplo a seguir encontra documentos em que genres contém a array ["Action", "Comedy"] na ordem especificada:

{ genres: ["Action", "Comedy"] }

Para localizar uma array que contenha Action e Comedy, independentemente da ordem ou de outros elementos da array, use o operador $all:

{ genres: { $all: ["Action", "Comedy"] } }

Para exemplos de consulta adicionais, consulte:

Documentação