Operadores de atualização

Nesta página

Compatibilidade

Sintaxe
Operadores de atualização

O MongoDB 5.0 é o fim da vida útil a partir de de 2024 outubro. Esta versão da documentação não é mais suportada. Para atualizar sua 5.0 implantação do, consulte o MongoDB 6.0 procedimentos de atualização.

Os seguintes modificadores estão disponíveis para uso 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 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

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.

Modifiers

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.

Bitwise

Nome	Descrição
`$bit`	Executa atualizações bitwise `AND`, `OR` e `XOR` de valores inteiros.

Voltar

$rand

Campos