Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Operadores

Operadores de atualização

Nesta página

  • Compatibilidade
  • Sintaxe
  • Operadores de atualização

Os seguintes modificadores estão disponíveis para utilizar em operações de atualização, por exemplo, em db.collection.updateMany() e db.collection.findAndModify().

Compatibilidade

Você pode utilizar operadores de atualização para sistemas hospedados nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações 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

Especifique a expressão do operador em um documento do formato:

{
   <operator1>: { <field1>: <value1>, ... },
   <operator2>: { <field2>: <value2>, ... },
   ...
}

Observação

Para obter detalhes sobre um operador específico, incluindo sintaxe e exemplos, clique no link para a página de referência do operador.

Operadores de atualização

Comportamento

A partir do MongoDB 5.0, os operadores de atualização processam campos de documento com nomes baseados em string em ordem lexicográfica. Os campos com nomes numéricos são processados em ordem numérica.

Considere este exemplo de comando $set:

{ $set: { "a.2": <new value>, "a.10": <new value>, } }

No MongoDB 5.0 e versões mais recentes, "a.2" é processado antes de "a.10" porque 2 vem antes de 10 em ordem numérica.

Campos

Nome
Descrição
$currentDate
Define o valor de um campo para a data atual, como data ou carimbo de data/hora.
$inc
Aumenta o valor do campo no valor especificado.
$min
Somente atualiza o campo se o valor especificado for menor que o valor de campo existente.
$max
Somente atualiza o campo se o valor especificado for maior que o valor de campo existente.
$mul
Multiplica o valor do campo pelo valor especificado.
$rename
Renomeia um campo.
$set
Define o valor de um campo em um documento.
$setOnInsert
Define o valor de um campo se uma atualização resultar em uma inserção de um documento. Não tem efeito sobre as operações de atualização que modificam os documentos existentes.
$unset
Remove o campo especificado de um documento.

Array

Operadores

Nome
Descrição
$
Atua como um espaço reservado para atualizar o primeiro elemento que corresponde à condição de query.
$[]
Atua como um espaço reservado para atualizar todos os elementos em uma array para os documentos que correspondem à condição de query.
$[<identifier>]
Atua como um espaço reservado para atualizar todos os elementos que correspondem à condição arrayFilters para os documentos que correspondem à condição de query.
$addToSet
Adiciona elementos a uma array somente se eles ainda não existirem no conjunto.
$pop
Remove o primeiro ou último item de uma array.
$pull
Remove todos os elementos de array que correspondem a uma query especificada.
$push
Adiciona um item a uma array.
$pullAll
Remove todos os valores correspondentes de uma array.

Modificadores

Nome
Descrição
$each
Modifica os operadores $push e $addToSet para acrescentar vários itens para atualizações de array.
$position
Modifica o operador $push para especificar a posição na array para adicionar elementos.
$slice
Modifica o operador $push para limitar o tamanho das arrays atualizadas.
$sort
Modifica o operador $push para reordenar documentos armazenados em uma array.

Bit a bit

Nome
Descrição
$bit
Executa atualizações bitwise AND, OR e XOR de valores inteiros.
← $natural
Operadores de atualização de campo →

Nesta página