MongoDB $ pow

En MongoDB, el $pow el operador de tubería de agregación eleva un número al exponente especificado y devuelve el resultado

$pow acepta dos expresiones, proporcionadas en una matriz. El primero es el número, y el segundo es el exponente. Ambas pueden ser cualquier expresión válida, siempre que se resuelvan en un número.

Ejemplo

Supongamos que tenemos una colección llamada test con los siguientes documentos:

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

Podemos usar el $pow operador para subir los data campo por un exponente especificado:

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

Resultado:

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

En este caso, utilicé los data campo como el número, y 3 como exponente. Por tanto, cada documento tenía sus data campo levantado por la potencia de 3.

Podemos ver que null los valores devuelven null .

El resultado suele ser del mismo tipo que la entrada. Sin embargo, hay excepciones para esta regla. Específicamente:

• Un entero de 32 bits se convertirá en un entero de 64 bits si el resultado se puede representar como un entero de 64 bits.
• Un entero de 32 bits se convertirá en un doble si el resultado no se puede representar como un entero de 64 bits.
• Un entero de 64 bits se convertirá en el doble si el resultado no se puede representar como un entero de 64 bits.

Exponente negativo

No puedes subir cero (0 ) a un exponente negativo.

Ejemplo:

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 :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1

El error establece explícitamente que “$pow no puede tomar una base de 0 y un exponente negativo “.

Sin embargo, si excluimos el documento 3, ya no obtenemos el error:

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

Si el argumento se resuelve en NaN , $pow devuelve NaN .

Ejemplo:

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

Resultado:

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

Campos Inexistentes

Si el $pow el operador se aplica a un campo que no existe, null es devuelto.

Ejemplo:

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

Resultado:

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

Exponente nulo

Ya hemos visto que un null el valor devuelve null . Esto también es cierto cuando se proporciona null como exponente.

Ejemplo:

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

Resultado:

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