MongoDB $ pow

No MongoDB, o $pow operador de pipeline de agregação eleva um número ao expoente especificado e retorna o resultado

$pow aceita duas expressões, fornecidas em um array. O primeiro é o número e o segundo é o expoente. Ambos podem ser qualquer expressão válida, desde que resolvam para um número.

Exemplo

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

{ "_id" : 1, "data" : 10 }
{ "_id" : 2, "data" : -3 }
{ "_id" : 3, "data" : 0 }
{ "_id" : 4, "data" : null }

Podemos usar o $pow operador para levantar os data campo por um expoente especificado:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", 3 ] }
      }
    }
  ]
)

Resultado:

{ "result" : 1000 }
{ "result" : -27 }
{ "result" : 0 }
{ "result" : null }

Nesse caso, usei os data campo como o número e 3 como expoente. Portanto, cada documento tinha seus data campo elevado pela potência de 3.

Podemos ver que null valores retornam null .

O resultado geralmente é do mesmo tipo que a entrada. No entanto, existem excepções a esta regra. Especificamente:

Um inteiro de 32 bits será convertido em um inteiro de 64 bits se o resultado for representável como um inteiro de 64 bits.
Um inteiro de 32 bits será convertido em double se o resultado não puder ser representado como um inteiro de 64 bits.
Um inteiro de 64 bits será convertido em double se o resultado não for representável como um inteiro de 64 bits.

Expoente negativo

Você não pode aumentar zero (0 ) para um expoente negativo.

Exemplo:

db.test.aggregate(
  [
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", -3 ] }
      }
    }
  ]
)

Resultado:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$pow cannot take a base of 0 and a negative exponent",
	"code" : 28764,
	"codeName" : "Location28764"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

O erro afirma explicitamente que “$pow não pode ter uma base 0 e um expoente negativo “.

No entanto, se excluirmos o documento 3, não teremos mais o erro:

db.test.aggregate(
  [
    { $match: { _id: { $nin: [ 3 ] } } },
    { $project: { 
        result: { $pow: [ "$data", -3 ] }
      }
    }
  ]
)

Resultado:

{ "_id" : 1, "result" : 0.001 }
{ "_id" : 2, "result" : -0.037037037037037035 }
{ "_id" : 4, "result" : null }

Valores NaN

Se o argumento resolver para NaN , $pow retorna NaN .

Exemplo:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data" * 1, 3 ] }
      }
    }
  ]
)

Resultado:

{ "result" : NaN }
{ "result" : NaN }
{ "result" : NaN }
{ "result" : NaN }

Campos inexistentes

Se o $pow operador é aplicado em um campo que não existe, null é devolvido.

Exemplo:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$beer", 3 ] }
      }
    }
  ]
)

Resultado:

{ "result" : null }
{ "result" : null }
{ "result" : null }
{ "result" : null }

Exponente nulo

Já vimos que um null valor retorna null . Isso também é verdade ao fornecer null como expoente.

Exemplo:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", null ] }
      }
    }
  ]
)

Resultado:

{ "result" : null }
{ "result" : null }
{ "result" : null }
{ "result" : null }