MongoDB $ln

In MongoDB, de $ln aggregatiepijplijnbeheerder berekent de natuurlijke logaritme (ln ) van een getal en geeft het resultaat als een dubbel.

Syntaxis

De syntaxis gaat als volgt:

{ $ln: <number> }

Waar <number> kan elke geldige uitdrukking zijn die wordt omgezet in een niet-negatief getal.

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 $ln . gebruiken operator om de natuurlijke logaritme van de data te retourneren veld:

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1, 2, 3 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $ln: [ "$data" ] }
        }
    }
  ]
)

Resultaat:

{ "data" : 0.5, "result" : -0.6931471805599453 }
{ "data" : 20, "result" : 2.995732273553991 }
{ "data" : 200, "result" : 5.298317366548036 }

Een andere manier om dit te doen zou zijn geweest om de $log . te gebruiken operator met een tweede argument van Math.E . Zie MongoDB $log voor een voorbeeld.

Natuurlijke logaritme

De natuurlijke logaritme van een getal is zijn 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 e . krijgen door Math.E . te gebruiken als het argument bij gebruik van $ln .

Stel dat we een document hebben zoals dit:

{ "_id" : 4, "data" : 2.718281828459045 }

Het gegevensveld bevat e tot 15 decimalen.

In dit voorbeeld worden twee manieren gebruikt om de natuurlijke logaritme van e . te retourneren :

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 4 ] } } },
    {
      $project:
        { 
          _id: 0,
          e_1: { $ln: [ "$data" ] },
          e_2: { $ln: [ Math.E ] }
        }
    }
  ]
)

Resultaat:

{ "e_1" : 1, "e_2" : 1 }

Het eerste resultaat gebruikt de gegevens uit het document. Voor het tweede resultaat gebruiken we Math.E om e te genereren .

Hoe dan ook, het resultaat is 1 .

Waarden buiten bereik

Zoals gezegd, de $ln 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" : 5, "data" : -20 }

Laten we de $ln . uitvoeren operator tegen dat document:

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 5 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $ln: [ "$data" ] }
        }
    }
  ]
)

Resultaat:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$ln's argument must be a positive number, but is -20",
	"code" : 28766,
	"codeName" : "Location28766"
} : 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" : 6, "data" : "Ten" }

Laten we de $ln . uitvoeren operator tegen dat document:

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 6 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $ln: [ "$data" ] }
        }
    }
  ]
)

Resultaat:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$ln only supports numeric types, not string",
	"code" : 28765,
	"codeName" : "Location28765"
} : 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 $ln only supports numeric types, not string .

Null-waarden

Null-waarden retourneren null bij gebruik van de $ln telefoniste.

Stel dat we het volgende document aan onze collectie toevoegen:

{ "_id" : 7, "data" : null }

Laten we de $ln . uitvoeren operator tegen dat document:

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 7 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $ln: [ "$data" ] }
        }
    }
  ]
)

Resultaat:

{ "data" : null, "result" : null }

We kunnen zien dat het resultaat null . is .

NaN-waarden

Als het argument wordt omgezet in NaN , $ln retourneert NaN .

Voorbeeld:

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $ln: [ "$data" * 1 ] }
        }
    }
  ]
)

Resultaat:

{ "data" : 0.5, "result" : NaN }

Niet-bestaande velden

Als de $ln 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: { $ln: [ "$age" ] }
        }
    }
  ]
)

Resultaat:

{ "data" : 0.5, "result" : null }

In dit geval hebben we geprobeerd $ln . toe te passen tegen een veld genaamd age , maar dat veld bestaat niet in het document, en dus krijgen we null .