MongoDB $ ln

In MongoDB, il $ln l'operatore della pipeline di aggregazione calcola il logaritmo naturale (ln ) di un numero e restituisce il risultato come doppio.

Sintassi

La sintassi è questa:

{ $ln: <number> }

Dove <number> può essere qualsiasi espressione valida che si risolve in un numero non negativo.

Esempio

Supponiamo di avere una collezione chiamata test con il seguente documento:

{ "_id" : 1, "data" : 0.5 }
{ "_id" : 2, "data" : 20 }
{ "_id" : 3, "data" : 200 }

Possiamo usare il $ln per restituire il logaritmo naturale dei data campo:

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

Risultato:

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

Un altro modo per farlo sarebbe stato usare il $log operatore con un secondo argomento di Math.E . Vedi MongoDB $log per un esempio.

Logaritmo naturale

Il logaritmo naturale di un numero è il suo logaritmo alla base della costante matematica e , dove e è un numero irrazionale e trascendentale che inizia con 2.7182818284590452353602874713527 e continua all'infinito.

La costante matematica e è anche conosciuto come numero di Eulero.

In JavaScript, possiamo usare Math.E per rappresentare e . Possiamo quindi ottenere il logaritmo naturale di e utilizzando Math.E come argomento quando si usa $ln .

Supponiamo di avere un documento come questo:

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

Il campo dati contiene e a 15 cifre decimali.

Questo esempio utilizza due modi per restituire il logaritmo naturale di e :

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

Risultato:

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

Il primo risultato utilizza i dati del documento. Per il secondo risultato, utilizziamo Math.E per generare e .

In ogni caso, il risultato è 1 .

Valori fuori intervallo

Come accennato, il $ln 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" : 5, "data" : -20 }

Eseguiamo il $ln operatore contro quel documento:

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

Risultato:

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 :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1058:12
@(shell):1:1

Tipo di dati errato

Anche fornire un tipo di dati errato causerà un errore.

Supponiamo di aggiungere il seguente documento alla nostra raccolta:

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

Eseguiamo il $ln operatore contro quel documento:

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

Risultato:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$ln only supports numeric types, not string",
	"code" : 28765,
	"codeName" : "Location28765"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1058:12
@(shell):1:1

Abbiamo fornito una stringa, quindi il messaggio di errore ci dice che $ln only supports numeric types, not string .

Valori Nulli

I valori Null restituiscono null quando si utilizza il $ln operatore.

Supponiamo di aggiungere il seguente documento alla nostra raccolta:

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

Eseguiamo il $ln operatore contro quel documento:

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

Risultato:

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

Possiamo vedere che il risultato è null .

Valori NaN

Se l'argomento si risolve in NaN , $ln restituisce NaN .

Esempio:

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

Risultato:

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

Campi inesistenti

Se il $ln operatore viene applicato a un campo che non esiste, null viene restituito.

Esempio:

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

Risultato:

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

In questo caso abbiamo provato ad applicare $ln contro un campo chiamato age , ma quel campo non esiste nel documento, quindi otteniamo null .