No MongoDB, o
$log
operador de pipeline de agregação calcula o log de um número na base especificada e retorna o resultado como um duplo. Sintaxe
A sintaxe fica assim:
{ $log: [ <number>, <base> ] }
Onde:
<number>
pode ser qualquer expressão válida que resolva para um número não negativo.<base>
pode ser qualquer expressão válida que resolva para um número positivo maior que1
.
Exemplo
Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 0.5 } { "_id" : 2, "data" : 20 } { "_id" : 3, "data" : 200 }
Podemos usar o
$log
operador para retornar a base de log 10 dos data
campo:db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 10 ] }
}
}
]
)
Resultado:
{ "data" : 0.5, "result" : -0.30102999566398114 } { "data" : 20, "result" : 1.301029995663981 } { "data" : 200, "result" : 2.301029995663981 }
Outra maneira de fazer isso seria usar o
$log10
operador. No entanto,
$log10
retorna apenas o log de base 10 de um número. Com $log
, por outro lado, podemos especificar a base a ser usada. Aqui está um exemplo de especificação de uma base de 16:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
{ "data" : 0.5, "result" : -0.25 } { "data" : 20, "result" : 1.0804820237218407 } { "data" : 200, "result" : 1.910964047443681 }
Logaritmo Natural
O logaritmo natural de um número é seu logaritmo na base da constante matemática e , onde e é um número irracional e transcendental que começa com 2,7182818284590452353602874713527 e continua para sempre.
A constante matemática e também é conhecido como número de Euler.
Em JavaScript, podemos usar
Math.E
para representar e . Podemos, portanto, obter o logaritmo natural de um número usando Math.E
como segundo argumento ao usar $log
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", Math.E ] }
}
}
]
)
Resultado:
{ "data" : 0.5, "result" : -0.6931471805599453 } { "data" : 20, "result" : 2.995732273553991 } { "data" : 200, "result" : 5.298317366548036 }
Tenha em mente que o MongoDB também tem o
$ln
operador, que é projetado especificamente para retornar o logaritmo natural de um número, então você pode achar mais fácil usar esse operador. Veja MongoDB $ln
Por exemplo. Valores fora do intervalo
Como mencionado, o
$log
O operador aceita qualquer expressão válida que resolva para um número não negativo. Valores fora desse intervalo causarão um erro. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 4, "data" : -20 }
Vamos executar o
$log
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$log's argument must be a positive number, but is -20", "code" : 28758, "codeName" : "Location28758" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:639:17 [email protected]/mongo/shell/assert.js:729:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1058:12 @(shell):1:1
Tipo de dados incorreto
Fornecer o tipo de dados incorreto também causará um erro.
Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 5, "data" : "Ten" }
Vamos executar o
$log
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$log's argument must be numeric, not string", "code" : 28756, "codeName" : "Location28756" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:639:17 [email protected]/mongo/shell/assert.js:729:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1058:12 @(shell):1:1
Fornecemos uma string e, portanto, a mensagem de erro nos diz que
$log's argument must be numeric, not string
. Valores nulos
Valores nulos retornam
null
ao usar o $log
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 6, "data" : null }
Vamos executar o
$log
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)
Resultado:
{ "data" : null, "result" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento for resolvido para
NaN
, $log
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data" * 1, 16 ] }
}
}
]
)
Resultado:
{ "data" : 0.5, "result" : NaN }
Campos inexistentes
Se o
$log
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$age", 16 ] }
}
}
]
)
Resultado:
{ "data" : 0.5, "result" : null }
Neste caso tentamos aplicar
$log
em um campo chamado age
, mas esse campo não existe no documento e, portanto, obtemos null
.