Definição
$gte$gteseleciona documentos em que o valor do campo especificado é maior ou igual (>=) ao valor especificado.Para a maioria dos tipos de dados, operadores de comparação só realizam comparações em campos em que o tipo de BSON corresponde ao tipo do valor da query. O MongoDB oferece suporte à comparação limitada entre BSON por meio de colchetes de tipo.
Compatibilidade
Você pode utilizar o $gte 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
O operador $gte tem o seguinte formato:
{ field: { $gte: value } }
Exemplos
Para criar a coleção inventory usada nos exemplos, execute:
db.inventory.insertMany( [ { item: "nuts", quantity: 30, carrier: { name: "Shipit", fee: 3 } }, { item: "bolts", quantity: 50, carrier: { name: "Shipit", fee: 4 } }, { item: "washers", quantity: 10, carrier: { name: "Shipit", fee: 1 } } ] )
Corresponder campos de documento
Este exemplo seleciona documentos na coleção inventory em que quantity é maior ou igual a 20:
db.inventory.find( { quantity: { $gte: 20 } } )
Saída de exemplo:
{ _id: ObjectId("61bb51211b83c864e3bbe037"), item: 'nuts', quantity: 30, carrier: { name: 'Shipit', fee: 3 } }, { _id: ObjectId("61bb51211b83c864e3bbe038"), item: 'bolts', quantity: 50, carrier: { name: 'Shipit', fee: 4 } }
Executar uma atualização com base em campos de documento incorporados
O exemplo a seguir define o campo price com base em uma comparação $gte com um campo em um documento incorporado:
db.inventory.updateMany( { "carrier.fee": { $gte: 2 } }, { $set: { "price": 9.99 } } )
Saída de exemplo:
{ _id: ObjectId("61bb51211b83c864e3bbe037"), item: 'nuts', quantity: 30, carrier: { name: 'Shipit', fee: 3 }, price: 9.99 }, { _id: ObjectId("61bb51211b83c864e3bbe038"), item: 'bolts', quantity: 50, carrier: { name: 'Shipit', fee: 4 }, price: 9.99 }
A operação updateMany() corresponde a um documento incorporado chamado carrier, com um subcampo chamado fee. Define { price: 9.99 } em cada documento em que fee tem um valor maior ou igual a 2.
Para definir o campo price apenas no primeiro documento em que carrier.fee for maior que 2, use updateOne().