In MongoDB ist das $log Der Aggregations-Pipeline-Operator berechnet den Logarithmus einer Zahl in der angegebenen Basis und gibt das Ergebnis als Double zurück.
Syntax
Die Syntax lautet wie folgt:
{ $log: [ <number>, <base> ] }Wo:
<number>kann jeder gültige Ausdruck sein, der zu einer nicht negativen Zahl aufgelöst wird.<base>kann jeder gültige Ausdruck sein, der zu einer positiven Zahl größer als1aufgelöst wird .
Beispiel
Angenommen, wir haben eine Sammlung namens test mit folgendem Dokument:
{ "_id" : 1, "data" : 0.5 }
{ "_id" : 2, "data" : 20 }
{ "_id" : 3, "data" : 200 }
Wir können das $log verwenden -Operator, um die Logbasis 10 der data zurückzugeben Feld:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 10 ] }
}
}
]
)Ergebnis:
{ "data" : 0.5, "result" : -0.30102999566398114 }
{ "data" : 20, "result" : 1.301029995663981 }
{ "data" : 200, "result" : 2.301029995663981 }
Eine andere Möglichkeit wäre die Verwendung von $log10 gewesen Betreiber.
Allerdings $log10 gibt nur die logarithmische Basis 10 einer Zahl zurück. Mit $log , andererseits können wir die zu verwendende Basis angeben.
Hier ist ein Beispiel für die Angabe einer Basis von 16:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Ergebnis:
{ "data" : 0.5, "result" : -0.25 }
{ "data" : 20, "result" : 1.0804820237218407 }
{ "data" : 200, "result" : 1.910964047443681 } Natürlicher Logarithmus
Der natürliche Logarithmus einer Zahl ist ihr Logarithmus zur Basis der mathematischen Konstante e , wobei e ist eine irrationale und transzendente Zahl, die mit 2,7182818284590452353602874713527 beginnt und ewig weitergeht.
Die mathematische Konstante e ist auch als Eulersche Zahl bekannt.
In JavaScript können wir Math.E verwenden um e darzustellen . Wir können daher den natürlichen Logarithmus einer Zahl erhalten, indem wir Math.E verwenden als zweites Argument bei Verwendung von $log .
Beispiel:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", Math.E ] }
}
}
]
)Ergebnis:
{ "data" : 0.5, "result" : -0.6931471805599453 }
{ "data" : 20, "result" : 2.995732273553991 }
{ "data" : 200, "result" : 5.298317366548036 }
Denken Sie daran, dass MongoDB auch den $ln hat -Operator, der speziell dafür entwickelt wurde, den natürlichen Logarithmus einer Zahl zurückzugeben, sodass Sie es möglicherweise einfacher finden, stattdessen diesen Operator zu verwenden. Siehe MongoDB $ln für ein Beispiel.
Werte außerhalb des zulässigen Bereichs
Wie bereits erwähnt, die $log -Operator akzeptiert jeden gültigen Ausdruck, der in eine nicht negative Zahl aufgelöst wird. Werte außerhalb dieses Bereichs führen zu einem Fehler.
Angenommen, wir fügen unserer Sammlung das folgende Dokument hinzu:
{ "_id" : 4, "data" : -20 }
Lassen Sie uns das $log ausführen Operator gegen dieses Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Ergebnis:
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 Falscher Datentyp
Die Angabe des falschen Datentyps führt ebenfalls zu einem Fehler.
Angenommen, wir fügen unserer Sammlung das folgende Dokument hinzu:
{ "_id" : 5, "data" : "Ten" }
Lassen Sie uns das $log ausführen Operator gegen dieses Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Ergebnis:
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
Wir haben einen String bereitgestellt, und die Fehlermeldung sagt uns, dass das Argument von $log's argument must be numeric, not string .
Nullwerte
Nullwerte geben null zurück bei Verwendung von $log Betreiber.
Angenommen, wir fügen unserer Sammlung das folgende Dokument hinzu:
{ "_id" : 6, "data" : null }
Lassen Sie uns das $log ausführen Operator gegen dieses Dokument:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Ergebnis:
{ "data" : null, "result" : null }
Wir können sehen, dass das Ergebnis null ist .
NaN-Werte
Wenn das Argument zu NaN aufgelöst wird , $log gibt NaN zurück .
Beispiel:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data" * 1, 16 ] }
}
}
]
)Ergebnis:
{ "data" : 0.5, "result" : NaN } Nicht vorhandene Felder
Wenn der $log -Operator wird auf ein nicht vorhandenes Feld angewendet, null zurückgegeben wird.
Beispiel:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$age", 16 ] }
}
}
]
)Ergebnis:
{ "data" : 0.5, "result" : null }
In diesem Fall haben wir versucht, $log anzuwenden gegen ein Feld namens age , aber dieses Feld existiert nicht im Dokument, und daher erhalten wir null .
