In MongoDB, de $log aggregatiepijplijnoperator berekent het logboek van een getal in de opgegeven basis en retourneert het resultaat als een dubbel.
Syntaxis
De syntaxis gaat als volgt:
{ $log: [ <number>, <base> ] }Waar:
<number>kan elke geldige uitdrukking zijn die wordt omgezet in een niet-negatief getal.<base>kan elke geldige uitdrukking zijn die wordt omgezet in een positief getal groter dan1.
Voorbeeld
Stel dat we een verzameling hebben met de naam test met het volgende document:
{ "_id" : 1, "data" : 0.5 }
{ "_id" : 2, "data" : 20 }
{ "_id" : 3, "data" : 200 }
We kunnen de $log . gebruiken operator om de logbase 10 van de data . te retourneren veld:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 10 ] }
}
}
]
)Resultaat:
{ "data" : 0.5, "result" : -0.30102999566398114 }
{ "data" : 20, "result" : 1.301029995663981 }
{ "data" : 200, "result" : 2.301029995663981 }
Een andere manier om dit te doen zou zijn geweest om de $log10 . te gebruiken telefoniste.
Echter, $log10 geeft alleen de logbase 10 van een getal terug. Met $log , aan de andere kant kunnen we de te gebruiken basis specificeren.
Hier is een voorbeeld van het specificeren van een grondtal van 16:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Resultaat:
{ "data" : 0.5, "result" : -0.25 }
{ "data" : 20, "result" : 1.0804820237218407 }
{ "data" : 200, "result" : 1.910964047443681 } Natuurlijke logaritme
De natuurlijke logaritme van een getal is de logaritme met de basis van de wiskundige constante e , waar e is een irrationeel en transcendentaal getal dat begint met 2,7182818284590452353602874713527 en voor altijd doorgaat.
De wiskundige constante e is ook bekend als het getal van Euler.
In JavaScript kunnen we Math.E . gebruiken om e te vertegenwoordigen . We kunnen daarom de natuurlijke logaritme van een getal krijgen door Math.E . te gebruiken als het tweede argument bij gebruik van $log .
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", Math.E ] }
}
}
]
)Resultaat:
{ "data" : 0.5, "result" : -0.6931471805599453 }
{ "data" : 20, "result" : 2.995732273553991 }
{ "data" : 200, "result" : 5.298317366548036 }
Houd er rekening mee dat MongoDB ook de $ln . heeft operator, die speciaal is ontworpen om de natuurlijke logaritme van een getal te retourneren, dus u vindt het misschien gemakkelijker om die operator te gebruiken. Zie MongoDB $ln voor een voorbeeld.
Waarden buiten bereik
Zoals gezegd, de $log operator accepteert elke geldige uitdrukking die wordt omgezet in een niet-negatief getal. Waarden buiten dat bereik zullen een fout veroorzaken.
Stel dat we het volgende document aan onze collectie toevoegen:
{ "_id" : 4, "data" : -20 }
Laten we de $log . uitvoeren operator tegen dat document:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Resultaat:
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 Onjuist gegevenstype
Het opgeven van het verkeerde gegevenstype zal ook een fout veroorzaken.
Stel dat we het volgende document aan onze collectie toevoegen:
{ "_id" : 5, "data" : "Ten" }
Laten we de $log . uitvoeren operator tegen dat document:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Resultaat:
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
We hebben een tekenreeks opgegeven en daarom vertelt de foutmelding ons dat het argument van $log's argument must be numeric, not string .
Null-waarden
Null-waarden retourneren null bij gebruik van de $log telefoniste.
Stel dat we het volgende document aan onze collectie toevoegen:
{ "_id" : 6, "data" : null }
Laten we de $log . uitvoeren operator tegen dat document:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data", 16 ] }
}
}
]
)Resultaat:
{ "data" : null, "result" : null }
We kunnen zien dat het resultaat null . is .
NaN-waarden
Als het argument wordt omgezet in NaN , $log retourneert NaN .
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$data" * 1, 16 ] }
}
}
]
)Resultaat:
{ "data" : 0.5, "result" : NaN } Niet-bestaande velden
Als de $log operator wordt toegepast op een veld dat niet bestaat, null wordt geretourneerd.
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
_id: 0,
data: 1,
result: { $log: [ "$age", 16 ] }
}
}
]
)Resultaat:
{ "data" : 0.5, "result" : null }
In dit geval hebben we geprobeerd $log . toe te passen tegen een veld genaamd age , maar dat veld bestaat niet in het document, en dus krijgen we null .