MongoDB $ log

MongoDBでは、 $ log 集計パイプライン演算子は、指定された基数の数値の対数を計算し、結果をdoubleとして返します。

構文

構文は次のようになります：

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

場所：

<番号> 非負の数に解決される任意の有効な式にすることができます。


      1より大きい正の数に解決される任意の有効な式にすることができます 。

 例
 
  testというコレクションがあるとします。 次のドキュメントで：
 { "_id" : 1, "data" : 0.5 }
{ "_id" : 2, "data" : 20 }
{ "_id" : 3, "data" : 200 }
 
  $ logを使用できます  dataのログベース10を返す演算子 フィールド：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1, 2, 3 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", 10 ] }
        }
    }
  ]
)
 
 結果：
 { "data" : 0.5, "result" : -0.30102999566398114 }
{ "data" : 20, "result" : 1.301029995663981 }
{ "data" : 200, "result" : 2.301029995663981 }
 
 これを行う別の方法は、 $ log10を使用することでした。 オペレーター。
 
 ただし、 $ log10  数値の10を底とする対数のみを返します。  $ logを使用 、一方、使用するベースを指定できます。
 
 16のベースを指定する例を次に示します。
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1, 2, 3 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", 16 ] }
        }
    }
  ]
)
 
 結果：
 { "data" : 0.5, "result" : -0.25 }
{ "data" : 20, "result" : 1.0804820237218407 }
{ "data" : 200, "result" : 1.910964047443681 }
 自然対数
 
 数値の自然対数は、数学定数 eの底に対する対数です。 、ここで e  は、2.7182818284590452353602874713527で始まり、永遠に続く無理数であり、超越数です。 
 
 数学定数e オイラーの数としても知られています。
 
 JavaScriptでは、 Math.Eを使用できます  eを表す 。したがって、 Math.E を使用すると、数値の自然対数を取得できます。  $ logを使用する場合の2番目の引数として 。
 
 例：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1, 2, 3 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", Math.E ] }
        }
    }
  ]
)
 
 結果：
 { "data" : 0.5, "result" : -0.6931471805599453 }
{ "data" : 20, "result" : 2.995732273553991 }
{ "data" : 200, "result" : 5.298317366548036 }
 
 MongoDBには$lnもあることに注意してください 演算子。数値の自然対数を返すように特別に設計されているため、代わりにその演算子を使用する方が簡単な場合があります。 MongoDB  $ lnを参照してください 例として。
 範囲外の値
 
 前述のように、 $ log  演算子は、非負の数に解決される有効な式を受け入れます。その範囲外の値はエラーの原因になります。
 
 コレクションに次のドキュメントを追加するとします。
 { "_id" : 4, "data" : -20 }
 
  $ logを実行してみましょう そのドキュメントに対する演算子：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 4 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", 16 ] }
        }
    }
  ]
)
 
 結果：
 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
 間違ったデータ型
 
 間違ったデータ型を指定すると、エラーも発生します。
 
 コレクションに次のドキュメントを追加するとします。
 { "_id" : 5, "data" : "Ten" }
 
  $ logを実行してみましょう そのドキュメントに対する演算子：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 5 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", 16 ] }
        }
    }
  ]
)
 
 結果：
 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
 
 文字列を指定したため、エラーメッセージから、$logの引数は文字列ではなく数値である必要があることがわかります 。
 ヌル値
 
 ヌル値はnullを返します  $ logを使用する場合 オペレーター。
 
 コレクションに次のドキュメントを追加するとします。
 { "_id" : 6, "data" : null }
 
  $ logを実行してみましょう そのドキュメントに対する演算子：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 6 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data", 16 ] }
        }
    }
  ]
)
 
 結果：
 { "data" : null, "result" : null }
 
 結果がnullであることがわかります 。 
 NaN値
 
 引数がNaNに解決された場合 、 $ log   NaNを返します 。
 
 例：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$data" * 1, 16 ] }
        }
    }
  ]
)
 
 結果：
 { "data" : 0.5, "result" : NaN }
 存在しないフィールド
 
  $ logの場合 存在しないフィールド、 nullに対して演算子が適用されます 返されます。
 
 例：
 db.test.aggregate(
  [
    { $match: { _id: { $in: [ 1 ] } } },
    {
      $project:
        { 
          _id: 0,
          data: 1,
          result: { $log: [ "$age", 16 ] }
        }
    }
  ]
)
 
 結果：
 { "data" : 0.5, "result" : null }
 
 この場合、 $ logを適用しようとしました  ageというフィールドに対して 、ただし、そのフィールドはドキュメントに存在しないため、 nullを取得します 。