En MongoDB, el $log
El operador de tubería de agregación calcula el registro de un número en la base especificada y devuelve el resultado como un doble.
Sintaxis
La sintaxis es así:
{ $log: [ <number>, <base> ] }
donde:
<number>
puede ser cualquier expresión válida que se resuelva en un número no negativo.<base>
puede ser cualquier expresión válida que se resuelva en un número positivo mayor que1
.
Ejemplo
Supongamos que tenemos una colección llamada test
con el siguiente documento:
{ "_id" :1, "datos" :0,5 }{ "_id" :2, "datos" :20 }{ "_id" :3, "datos" :200 }
Podemos usar el $log
operador para devolver el logaritmo base 10 de los data
campo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 10 ] }
}
}
]
)
Resultado:
Otra forma de hacer esto habría sido usar el $log10
operador.
Sin embargo, $log10
solo devuelve el logaritmo en base 10 de un número. Con $log
, por otro lado, podemos especificar la base a utilizar.
Aquí hay un ejemplo de cómo especificar una base de 16:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
{ "datos":0,5, "resultado":-0,25 }{ "datos":20, "resultado":1,0804820237218407 }{ "datos":200, "resultado":1,910964047443681 }
Logaritmo natural
El logaritmo natural de un número es su logaritmo en la base de la constante matemática e , donde e es un número irracional y trascendental que comienza con 2.7182818284590452353602874713527 y continúa para siempre.
La constante matemática e también se conoce como número de Euler.
En JavaScript, podemos usar Math.E
para representar e . Por lo tanto, podemos obtener el logaritmo natural de un número usando Math.E
como segundo argumento cuando se usa $log
.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", Math.E ] }
}
}
]
)
Resultado:
{ "datos" :0.5, "resultado" :-0.6931471805599453 }{ "datos" :20, "resultado" :2.995732273553991 }{ "datos" :200, "resultado" :5.298317366548036 }
Tenga en cuenta que MongoDB también tiene el $ln
operador, que está diseñado específicamente para devolver el logaritmo natural de un número, por lo que puede que le resulte más fácil utilizar ese operador en su lugar. Ver MongoDB $ln
para un ejemplo.
Valores fuera de rango
Como se mencionó, el $log
El operador acepta cualquier expresión válida que se resuelva en un número no negativo. Los valores fuera de ese rango generarán un error.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" :4, "datos" :-20 }
Ejecutemos el $log
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
excepción no detectada:Error:el comando falló:{ "ok":0, "errmsg":"El argumento de $log debe ser un número positivo, pero es -20", "code":28758, "codeName":"Location28758 "}:el agregado falló :[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert. js:639:[email protected]/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12@(cáscara):1:1
Tipo de datos incorrecto
Proporcionar el tipo de datos incorrecto también provocará un error.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" :5, "datos" :"Diez" }
Ejecutemos el $log
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
excepción no detectada:Error:el comando falló:{ "ok":0, "errmsg":"El argumento de $log debe ser numérico, no una cadena", "code":28756, "codeName":"Location28756"}:agregado falló :[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert.js:639:[email protected]/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12@ (cáscara):1:1
Proporcionamos una cadena, por lo que el mensaje de error nos dice que el argumento de $log's argument must be numeric, not string
.
Valores nulos
Los valores nulos devuelven null
al usar el $log
operador.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" :6, "datos" :nulo }
Ejecutemos el $log
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
{ "datos":nulo, "resultado":nulo }
Podemos ver que el resultado es null
.
Valores NaN
Si el argumento se resuelve en NaN
, $log
devuelve NaN
.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data" * 1, 16 ] }
}
}
]
)
Resultado:
{ "datos":0,5, "resultado":NaN }
Campos Inexistentes
Si el $log
el operador se aplica a un campo que no existe, null
es devuelto.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$age", 16 ] }
}
}
]
)
Resultado:
{ "datos":0.5, "resultado":nulo }
En este caso intentamos aplicar $log
contra un campo llamado age
, pero ese campo no existe en el documento, por lo que obtenemos null
.