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ó :example@sqldat.com/mongo/shell/utils.js:25:13example@sqldat.com/mongo/shell/assert.js:18:14example@sqldat.com/mongo/shell/assert. js:639:17example@sqldat.com/mongo/shell/assert.js:729:16example@sqldat.com/mongo/shell/db.js:266:5example@sqldat.com/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ó :example@sqldat.com/mongo/shell/utils.js:25:13example@sqldat.com/mongo/shell/assert.js:18:14example@sqldat.com/mongo/shell/assert.js:639:17example@sqldat.com/mongo/shell/assert.js:729:16example@sqldat.com/mongo/shell/db.js:266:5example@sqldat.com/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 .