/ /

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

Definição

Observação

Desambiguação

The following page refers to the aggregation stage $unset. For the update operator $unset, see $unset.

$unset: Remove/exclui campos dos documentos.

Sintaxe

The $unset stage has the following syntax:

To remove a single field, the $unset takes a string that specifies the field to remove:
{ $unset: "<field>" }
To remove multiple fields, the $unset takes an array of fields to remove.
{ $unset: [ "<field1>", "<field2>", ... ] }

Considerações

`$unset` e a `$project`

The $unset is an alias for the $project stage that removes/excludes fields:

{ $project: { "<field1>": 0, "<field2>": 0, ... } }

Campos incorporados

Para remover/excluir um campo ou campos em um documento incorporado, você pode usar a notação de ponto, como em:

{ $unset: "<field.nestedfield>" }

{ $unset: [ "<field1.nestedfield>", ...] }

Exemplos

Criar uma coleção books de amostra com os seguintes documentos:

db.books.insertMany([
   { "_id" : 1, title: "Antelope Antics", isbn: "0001122223334", author: { last:"An", first: "Auntie" }, copies: [ { warehouse: "A", qty: 5 }, { warehouse: "B", qty: 15 } ] },
   { "_id" : 2, title: "Bees Babble", isbn: "999999999333", author: { last:"Bumble", first: "Bee" }, copies: [ { warehouse: "A", qty: 2 }, { warehouse: "B", qty: 5 } ] }
])

Remover um único campo

O exemplo a seguir remove o campo de nível superior copies:

db.books.aggregate([ { $unset: "copies" } ])

Alternativamente, você também pode usar a seguinte sintaxe:

db.books.aggregate([ { $unset: [ "copies" ] } ])

Qualquer operação retorna os seguintes documentos:

{ "_id" : 1, "title" : "Antelope Antics", "isbn" : "0001122223334", "author" : { "last" : "An", "first" : "Auntie" } }
{ "_id" : 2, "title" : "Bees Babble", "isbn" : "999999999333", "author" : { "last" : "Bumble", "first" : "Bee" } }

Remover campos de nível superior

O exemplo a seguir remove os campos de nível superior isbn e copies:

db.books.aggregate([
   { $unset: [ "isbn", "copies" ] }
])

The $unset operation outputs the following documents:

{ "_id" : 1, "title" : "Antelope Antics", "author" : { "last" : "An", "first" : "Auntie" } }
{ "_id" : 2, "title" : "Bees Babble", "author" : { "last" : "Bumble", "first" : "Bee" } }

Remover campos incorporados

O exemplo a seguir remove o campo de nível superior isbn, o campo incorporado first (do documento name) e o campo incorporado warehouse (dos elementos na array copies):

db.books.aggregate([
   { $unset: [ "isbn", "author.first", "copies.warehouse" ] }
])

The $unset operation outputs the following documents:

{ "_id" : 1, "title" : "Antelope Antics", "author" : { "last" : "An" }, "copies" : [ { "qty" : 5 }, { "qty" : 15 } ] }
{ "_id" : 2, "title" : "Bees Babble", "author" : { "last" : "Bumble" }, "copies" : [ { "qty" : 2 }, { "qty" : 5 } ] }

Os exemplos do Node.js nesta página utilizam o banco de dados do sample_mflix a partir dos conjuntos de dados de amostra do Atlas. Para saber como criar um cluster gratuito do MongoDB Atlas e carregar os conjuntos de dados de exemplo, consulte Introdução na documentação do driver do MongoDB Node.js

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

O exemplo a seguir cria um estágio de pipeline que exclui o campo tomatoes e o campo incorporado imdb.votes dos documentos de retorno. O exemplo em seguida executa o pipeline de agregação:

const pipeline = [{ $unset: ["imdb.votes", "tomatoes"] }];
const cursor = collection.aggregate(pipeline);
return cursor;

Voltar

$unionWith

$unwind