In MongoDB, il $log l'operatore della pipeline di aggregazione calcola il log di un numero nella base specificata e restituisce il risultato come double.
Sintassi
La sintassi è questa:
{ $log: [ <number>, <base> ] }Dove:
<number>può essere qualsiasi espressione valida che si risolve in un numero non negativo.<base>può essere qualsiasi espressione valida che si risolve in un numero positivo maggiore di1.
Esempio
Supponiamo di avere una collezione chiamata test con il seguente documento:
{ "_id" : 1, "data" : 0.5 }
{ "_id" : 2, "data" : 20 }
{ "_id" : 3, "data" : 200 }
Possiamo usare il $log operatore per restituire la base logaritmica 10 dei data campo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 10 ] }
}
}
]
)Risultato:
{ "data" : 0.5, "result" : -0.30102999566398114 }
{ "data" : 20, "result" : 1.301029995663981 }
{ "data" : 200, "result" : 2.301029995663981 }
Un altro modo per farlo sarebbe stato usare il $log10 operatore.
Tuttavia, $log10 restituisce solo la base logaritmica 10 di un numero. Con $log , invece, possiamo specificare la base da utilizzare.
Ecco un esempio per specificare una base di 16:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Risultato:
{ "data" : 0.5, "result" : -0.25 }
{ "data" : 20, "result" : 1.0804820237218407 }
{ "data" : 200, "result" : 1.910964047443681 } Logaritmo naturale
Il logaritmo naturale di un numero è il suo logaritmo alla base della costante matematica e , dove e è un numero irrazionale e trascendentale che inizia con 2.7182818284590452353602874713527 e continua all'infinito.
La costante matematica e è anche conosciuto come numero di Eulero.
In JavaScript, possiamo usare Math.E per rappresentare e . Possiamo quindi ottenere il logaritmo naturale di un numero usando Math.E come secondo argomento quando si usa $log .
Esempio:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", Math.E ] }
}
}
]
)Risultato:
{ "data" : 0.5, "result" : -0.6931471805599453 }
{ "data" : 20, "result" : 2.995732273553991 }
{ "data" : 200, "result" : 5.298317366548036 }
Tieni presente che MongoDB ha anche il $ln operatore, che è specificamente progettato per restituire il logaritmo naturale di un numero, quindi potresti trovare più facile usare quell'operatore invece. Vedi MongoDB $ln per un esempio.
Valori fuori intervallo
Come accennato, il $log operatore accetta qualsiasi espressione valida che si risolve in un numero non negativo. I valori al di fuori di tale intervallo causeranno un errore.
Supponiamo di aggiungere il seguente documento alla nostra raccolta:
{ "_id" : 4, "data" : -20 }
Eseguiamo il $log operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Risultato:
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 di dati errato
Anche fornire un tipo di dati errato causerà un errore.
Supponiamo di aggiungere il seguente documento alla nostra raccolta:
{ "_id" : 5, "data" : "Ten" }
Eseguiamo il $log operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Risultato:
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
Abbiamo fornito una stringa, quindi il messaggio di errore ci dice che $log's argument must be numeric, not string .
Valori Nulli
I valori Null restituiscono null quando si utilizza il $log operatore.
Supponiamo di aggiungere il seguente documento alla nostra raccolta:
{ "_id" : 6, "data" : null }
Eseguiamo il $log operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Risultato:
{ "data" : null, "result" : null }
Possiamo vedere che il risultato è null .
Valori NaN
Se l'argomento si risolve in NaN , $log restituisce NaN .
Esempio:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data" * 1, 16 ] }
}
}
]
)Risultato:
{ "data" : 0.5, "result" : NaN } Campi inesistenti
Se il $log operatore viene applicato a un campo che non esiste, null viene restituito.
Esempio:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$age", 16 ] }
}
}
]
)Risultato:
{ "data" : 0.5, "result" : null }
In questo caso abbiamo provato ad applicare $log contro un campo chiamato age , ma quel campo non esiste nel documento, quindi otteniamo null .
