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.

$first (expressão)

$first

Retorna o primeiro elemento de um array.

Observação

Desambiguação

Esta página descreve $first quando usado como uma expressão, que retorna o primeiro elemento de um array.

Você também pode usar $first nestes outros contextos:

{ $first: <expression> }

O <expression> deve ser avaliado como uma array.

  • Se a expressão do operando avaliar como uma array, $first retorna o primeiro elemento dessa array.

  • Se o array estiver vazio, $first retorna null.

  • Se a expressão for avaliada como null ou se referir a um campo que está faltando, $first retorna null.

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.

O exemplo a seguir usa $first para retornar o ator principal de cada filme. No conjunto de dados sample_mflix, o array cast lista os atores em ordem de faturamento, portanto, o primeiro elemento é o ator principal:

db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Pulp Fiction", "Forrest Gump" ] } } }, { $addFields: { topBilledActor: { $first: "$cast" } } }, { $project: { _id: 0, title: 1, cast: 1, topBilledActor: 1 } }, { $sort: { title: 1 } }] )

No pipeline anterior:

  • $match filtros para três filmes específicos.

  • $addFields com $first cria um novo campo topBilledActor contendo o primeiro elemento do cast array.

  • $project inclui apenas os campos title, cast e topBilledActor na saída.

  • $sort classifica os resultados por título.