$documents (estágio de agregação )

Definição

$documents: Novidades na versão 6.0.
Retorna documentos literais de valores de entrada.

Sintaxe

O estágio $documents tem a seguinte forma:

{ $documents: <expression> }

Limitações

Você só pode usar $documents em um agregação pipeline em nível de banco de dados.
Você deve usar $documents como o primeiro estágio de um pipeline de agregação .

Veja abaixo exemplos de uso.

Comportamento

$documents aceita qualquer expressão válida que se resolva em uma array de objetos. Isso inclui:

variáveis do sistema, como $$NOW ou $$SEARCH_META
$let expressões
variáveis no escopo de expressões $lookup

As expressões que não determinam um documento atual, como $myField ou $$ROOT, resultarão em um erro.

Exemplos

Testar um estágio do pipeline

Crie dados de teste e depuração para um estágio de pipeline sem criar coleções de teste.

db.aggregate(   [      { $documents: [ { x: 10 }, { x: 2 }, { x: 5 } ] },      { $bucketAuto: { groupBy: "$x", buckets: 4 } }   ])

A expressão de agregação não especifica uma coleção. Ela usa os dados de entrada destacados no estágio $documents como entrada para o estágio $bucketAuto.

[  { _id: { min: 2, max: 5 }, count: 1 },  { _id: { min: 5, max: 10 }, count: 1 },  { _id: { min: 10, max: 10 }, count: 1 }]

Use uma `$documents` etapa em uma `$lookup` etapa

Correlacione documentos em uma coleção com outros dados usando $documents para modificar a saída $lookup.

Crie a coleção locations.

db.locations.insertMany(   [      { zip: 94301, name: "Palo Alto" },      { zip: 10019, name: "New York" }   ] )

Use $documents como fonte de dados para transformar os documentos.

db.locations.aggregate(   [      { $match: {} },      { $lookup:         {            localField: "zip",            foreignField: "zip_id",            as: "city_state",            pipeline:              [                 { $documents:                    [                       { zip_id: 94301, name: "Palo Alto, CA" },                       { zip_id: 10019, name: "New York, NY" }                    ]                 }              ]         }      }   ] )

A saída correlaciona os dados na coleção locations com os valores no estágio de pipeline $documents.

[   {      _id: ObjectId("618949d60f7bfd5f5689490d"),      zip: 94301,      name: 'Palo Alto',      city_state: [ { zip_id: 94301, name: 'Palo Alto, CA' } ]   },   {      _id: ObjectId("618949d60f7bfd5f5689490e"),      zip: 10019,      name: 'New York',      city_state: [ { zip_id: 10019, name: 'New York, NY' } ]   }]

O campo zip corresponde ao campo zip_id
O parâmetro as cria um novo campo de saída

Para usar o driver MongoDB .NET/C# para adicionar um estágio $documents a uma agregação pipeline, chame o método UnionWith() em um objeto PipelineDefinition.

O exemplo abaixo cria um estágio de pipeline que gera três documentos:

var documentArray = new[]{    new BsonDocument {{ "title", "The Shawshank Redemption" }},    new BsonDocument {{ "title", "Back to the Future" }},    new BsonDocument {{ "title", "Jurassic Park" }},};
var pipeline = new EmptyPipelineDefinition<NoPipelineInput>()    .Documents(documentArray);

{ "title" : "The Shawshank Redemption" }{ "title" : "Back to the Future" }{ "title" : "Jurassic Park" }

Para usar o driver Node.js do MongoDB para adicionar um estágio $documents a um pipeline de agregação , use o operador $documents em um objeto de pipeline.

O exemplo a seguir cria um estágio de pipeline que cria três documentos. Em seguida, o exemplo executa o agregação pipeline:

const pipeline = [  {    $documents: [      { "title": "The Shawshank Redemption" },      { "title": "Back to the Future" },      { "title": "Jurassic Park" }    ]  }];
const cursor = collection.aggregate(pipeline);return cursor;

Saiba mais

Para obter detalhes sobre subqueries que usam a $lookup sintaxe, consulte Subqueries correlacionadas usando sintaxe concisa.

Voltar

$densify

$facet