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 : [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
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 }