MongoDB $mod

No MongoDB, o $mod operador de pipeline de agregação divide um número por outro e retorna o restante.

Para usar $mod , passe os dois números em uma matriz. O $mod operador irá dividir o primeiro número pelo segundo número e retornar o restante. Em outras palavras, o primeiro número é o dividendo e o segundo número é o divisor.

Os argumentos podem ser qualquer expressão válida, desde que resolvam para números.

Exemplo

Suponha que tenhamos uma coleção chamada data com os seguintes documentos:

{ "_id" : 1, "a" : 10, "b" : 2 }
{ "_id" : 2, "a" : 10, "b" : 3 }
{ "_id" : 3, "a" : 10.5, "b" : 2 }

Podemos usar o $mod operador dentro de um pipeline de agregação para dividir o a campo pelo b campo e retornar o restante:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", "$b" ] } } 
         }
   ]
)

Resultado:

{ "a" : 10, "b" : 2, "result" : 0 }
{ "a" : 10, "b" : 3, "result" : 1 }
{ "a" : 10.5, "b" : 2, "result" : 0.5 }

Em outras palavras, obtemos a módulo b .

Se quisermos obter b módulo a , precisaríamos trocá-los.

Exemplo:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$b", "$a" ] } } 
         }
   ]
)

Resultado:

{ "a" : 10, "b" : 2, "result" : 2 }
{ "a" : 10, "b" : 3, "result" : 3 }
{ "a" : 10.5, "b" : 2, "result" : 2 }

Números negativos

Suponha que adicionamos os seguintes documentos à nossa coleção:

{ "_id" : 4, "a" : -10, "b" : 3 }
{ "_id" : 5, "a" : 10, "b" : -3 }
{ "_id" : 6, "a" : -10, "b" : -3 }

Estes incluem números negativos. Mas isso não é um problema, porque números negativos ainda são números, e certamente podemos obter o módulo ao trabalhar com números negativos.

Exemplo:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 4, 5, 6 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", "$b" ] } } 
         }
   ]
)

Resultado:

{ "a" : -10, "b" : 3, "result" : -1 }
{ "a" : 10, "b" : -3, "result" : 1 }
{ "a" : -10, "b" : -3, "result" : -1 }

Tipo de dados incorreto

Os argumentos fornecidos para $mod podem ser qualquer expressão válida, desde que resolvam para números.

Suponha que temos o seguinte documento:

{ "_id" : 7, "a" : "Ten", "b" : 2 }

E aplicamos $mod a esse documento:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 7 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", "$b" ] } } 
         }
   ]
)

Resultado:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$mod only supports numeric types, not string and double",
	"code" : 16611,
	"codeName" : "Location16611"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:639:17
[email protected]/mongo/shell/assert.js:729:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1058:12
@(shell):1:1

O erro indica que $mod only supports numeric types .

Valores nulos

Fornecendo null para qualquer um dos argumentos retorna null .

Suponha que temos os seguintes documentos:

{ "_id" : 8, "a" : 10, "b" : null }
{ "_id" : 9, "a" : null, "b" : 10 }
{ "_id" : 10, "a" : null, "b" : null }

E aplicamos $mod a esses documentos:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 8, 9, 10 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", "$b" ] } } 
         }
   ]
)

Resultado:

{ "a" : 10, "b" : null, "result" : null }
{ "a" : null, "b" : 10, "result" : null }
{ "a" : null, "b" : null, "result" : null }

Campos ausentes

Campos ausentes retornam null .

Suponha que temos os seguintes documentos:

{ "_id" : 11, "a" : 10 }
{ "_id" : 12, "b" : 2 }
{ "_id" : 13 }

Aplicar $mod :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 11, 12, 13 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", "$b" ] } } 
         }
   ]
)

Resultado:

{ "a" : 10, "result" : null }
{ "b" : 2, "result" : null }
{ "result" : null }

Adicione seu próprio número

Você não está necessariamente restrito apenas aos números no(s) documento(s). Você pode usar seus próprios números se precisar dividir um campo por um valor fixo.

Exemplo:

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     { $project: { 
        _id: 0,
        a: 1,
        b: 1,
        result: { $mod: [ "$a", 5.2 ] } } 
         }
   ]
)

Resultado:

{ "a" : 10, "b" : 2, "result" : 4.8 }
{ "a" : 10, "b" : 3, "result" : 4.8 }
{ "a" : 10.5, "b" : 2, "result" : 0.09999999999999964 }