In MongoDB, il $log10
l'operatore della pipeline di aggregazione calcola la base logaritmica 10 di un numero e restituisce il risultato come double.
$log10
accetta qualsiasi espressione valida che si risolve in un numero non negativo.
Il $log10
operatore è stato introdotto in MongoDB 3.2.
Esempio
Supponiamo di avere una collezione chiamata test
con il seguente documento:
{ "_id" : 1, "data" : 0.5 }
Possiamo usare il $log10
operatore per restituire la base logaritmica 10 dei data
campo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Risultato:
{ "result" : -0.3010299956639812 }
Valori fuori intervallo
Come accennato, il $log10
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" : 2, "data" : -3 }
Eseguiamo il $log10
operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Risultato:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$log10's argument must be a positive number, but is -3", "code" : 28761, "codeName" : "Location28761" } : 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
Valori Nulli
I valori Null restituiscono null
quando si utilizza il $log10
operatore.
Supponiamo di aggiungere il seguente documento alla nostra raccolta:
{ "_id" : 3, "data" : null }
Eseguiamo il $log10
operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Risultato:
{ "result" : null }
Possiamo vedere che il risultato è null
.
Valori NaN
Se l'argomento si risolve in NaN
, $log10
restituisce NaN
.
Esempio:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: 1 * "$data" }
}
}
]
)
Risultato:
{ "result" : NaN }
Campi inesistenti
Se il $log10
operatore viene applicato a un campo che non esiste, null
viene restituito.
Esempio:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: "$name" }
}
}
]
)
Risultato:
{ "result" : null }