MongoDB $ log

No MongoDB, o $log operador de pipeline de agregação calcula o log de um número na base especificada e retorna o resultado como um duplo.

Sintaxe

A sintaxe fica assim:

{ $log: [ <number>, <base> ] }

Onde:

<number> pode ser qualquer expressão válida que resolva para um número não negativo.
<base> pode ser qualquer expressão válida que resolva para um número positivo maior que 1 .

Exemplo

Suponha que tenhamos uma coleção chamada test com o seguinte documento:

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

Podemos usar o $log operador para retornar a base de log 10 dos data campo:

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

Resultado:

{ "data" : 0.5, "result" : -0.30102999566398114 }
{ "data" : 20, "result" : 1.301029995663981 }
{ "data" : 200, "result" : 2.301029995663981 }

Outra maneira de fazer isso seria usar o $log10 operador.

No entanto, $log10 retorna apenas o log de base 10 de um número. Com $log , por outro lado, podemos especificar a base a ser usada.

Aqui está um exemplo de especificação de uma base de 16:

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

Resultado:

{ "data" : 0.5, "result" : -0.25 }
{ "data" : 20, "result" : 1.0804820237218407 }
{ "data" : 200, "result" : 1.910964047443681 }

Logaritmo Natural

O logaritmo natural de um número é seu logaritmo na base da constante matemática e , onde e é um número irracional e transcendental que começa com 2,7182818284590452353602874713527 e continua para sempre.

A constante matemática e também é conhecido como número de Euler.

Em JavaScript, podemos usar Math.E para representar e . Podemos, portanto, obter o logaritmo natural de um número usando Math.E como segundo argumento ao usar $log .

Exemplo:

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

Resultado:

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

Tenha em mente que o MongoDB também tem o $ln operador, que é projetado especificamente para retornar o logaritmo natural de um número, então você pode achar mais fácil usar esse operador. Veja MongoDB $ln Por exemplo.

Valores fora do intervalo

Como mencionado, o $log O operador aceita qualquer expressão válida que resolva para um número não negativo. Valores fora desse intervalo causarão um erro.

Suponha que adicionamos o seguinte documento à nossa coleção:

{ "_id" : 4, "data" : -20 }

Vamos executar o $log operador contra esse documento:

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

Resultado:

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 :
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 de dados incorreto

Fornecer o tipo de dados incorreto também causará um erro.

Suponha que adicionamos o seguinte documento à nossa coleção:

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

Vamos executar o $log operador contra esse documento:

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

Resultado:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$log's argument must be numeric, not string",
	"code" : 28756,
	"codeName" : "Location28756"
} : 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

Fornecemos uma string e, portanto, a mensagem de erro nos diz que $log's argument must be numeric, not string .

Valores nulos

Valores nulos retornam null ao usar o $log operador.

Suponha que adicionamos o seguinte documento à nossa coleção:

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

Vamos executar o $log operador contra esse documento:

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

Resultado:

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

Podemos ver que o resultado é null .

Valores NaN

Se o argumento for resolvido para NaN , $log retorna NaN .

Exemplo:

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

Resultado:

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

Campos inexistentes

Se o $log operador é aplicado em um campo que não existe, null é devolvido.

Exemplo:

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

Resultado:

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

Neste caso tentamos aplicar $log em um campo chamado age , mas esse campo não existe no documento e, portanto, obtemos null .