$unset (operador de atualização)

Definição

$unset

O operador $unset exclui um campo específico.

Compatibilidade

Você pode utilizar o $unset para implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

Considere a seguinte sintaxe:

{ $unset: { <field1>: "", ... } }

O valor especificado na expressão $unset (ou"" seja,) não impacto a operação.

Para especificar um <field> em um documento incorporado ou em uma array, use a notação de ponto.

Comportamento

A partir do MongoDB 5.0, os operadores de atualização processam campos de documento com nomes baseados em cadeia de caracteres em ordem lexicográfica. Os campos com nomes numéricos são processados em ordem numérica. Consulte Atualizar Comportamento de Operadores para detalhes.

Se o campo não existir, então não fará nada (ou seja, nenhuma $unset operação).

Quando usado com $ para corresponder a um elemento de array, $unset substitui o elemento correspondente por null em vez de remover o elemento correspondente da array. Esse comportamento mantém consistentes o tamanho da array e as posições dos elementos.

A partir do MongoDB 5.0, mongod não gera mais um erro ao usar um operador de atualização como $unset com uma expressão de operando vazia ( { } ). Uma atualização vazia não resulta em alteração e nenhuma entrada no oplog é criada (o que significa que é sem operação).

Exemplo

Os exemplos nesta página usam dados do conjunto de dados de amostra sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações 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 o operador para remover $unset os label status campos e do documento de filme correspondente:

db.movies.updateOne(
   { title: "The Dark Knight" },
   { $unset: { label: "", status: "" } }
)

A operação retorna o seguinte resultado:

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}