MongoDB $ln

In MongoDB ist der $ln Aggregation Pipeline Operator berechnet den natürlichen Logarithmus (ln ) einer Zahl und gibt das Ergebnis als Double zurück.

Syntax

Die Syntax lautet wie folgt:

{ $ln: <number> }

Wobei <number> kann jeder gültige Ausdruck sein, der zu einer nicht negativen Zahl aufgelö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 den $ln verwenden -Operator, um den natürlichen Logarithmus der data zurückzugeben Feld:

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

Ergebnis:

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

Eine andere Möglichkeit wäre die Verwendung von $log gewesen Operator mit einem zweiten Argument von Math.E . Siehe MongoDB $log für ein Beispiel.

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 von e erhalten durch Verwendung von Math.E als Argument bei Verwendung von $ln .

Angenommen, wir haben ein Dokument wie dieses:

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

Das Datenfeld enthält e auf 15 Dezimalstellen.

Dieses Beispiel verwendet zwei Möglichkeiten, um den natürlichen Logarithmus von e zurückzugeben :

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

Ergebnis:

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

Das erste Ergebnis verwendet die Daten aus dem Dokument. Für das zweite Ergebnis verwenden wir Math.E um e zu generieren .

In jedem Fall ist das Ergebnis 1 .

Werte außerhalb des zulässigen Bereichs

Wie bereits erwähnt, der $ln -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" : 5, "data" : -20 }

Lassen Sie uns den $ln ausführen Operator gegen dieses Dokument:

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

Ergebnis:

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

Falscher Datentyp

Die Angabe des falschen Datentyps führt ebenfalls zu einem Fehler.

Angenommen, wir fügen unserer Sammlung das folgende Dokument hinzu:

{ "_id" : 6, "data" : "Ten" }

Lassen Sie uns den $ln ausführen Operator gegen dieses Dokument:

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

Ergebnis:

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

Wir haben einen String bereitgestellt, und so teilt uns die Fehlermeldung mit, dass $ln only supports numeric types, not string .

Nullwerte

Nullwerte geben null zurück bei Verwendung von $ln Betreiber.

Angenommen, wir fügen unserer Sammlung das folgende Dokument hinzu:

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

Lassen Sie uns den $ln ausführen Operator gegen dieses Dokument:

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

Ergebnis:

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

Wir können sehen, dass das Ergebnis null ist .

NaN-Werte

Wenn das Argument zu NaN aufgelöst wird , $ln gibt NaN zurück .

Beispiel:

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

Ergebnis:

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

Nicht vorhandene Felder

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

Ergebnis:

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

In diesem Fall haben wir versucht, $ln anzuwenden gegen ein Feld namens age , aber dieses Feld existiert nicht im Dokument, und so erhalten wir null .