MongoDB $log

Di MongoDB, $log operator pipa agregasi menghitung log angka di basis yang ditentukan dan mengembalikan hasilnya sebagai ganda.

Sintaks

Sintaksnya seperti ini:

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

Dimana:

• <number> dapat berupa ekspresi valid apa pun yang menghasilkan bilangan non-negatif.
• <base> dapat berupa ekspresi valid apa pun yang menghasilkan angka positif yang lebih besar dari 1 .

Contoh

Misalkan kita memiliki koleksi yang disebut test dengan dokumen berikut:

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

Kita dapat menggunakan $log operator untuk mengembalikan basis log 10 dari data bidang:

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

Hasil:

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

Cara lain untuk melakukan ini adalah dengan menggunakan $log10 operator.

Namun, $log10 hanya mengembalikan basis log 10 dari sebuah angka. Dengan $log , di sisi lain, kita dapat menentukan basis yang akan digunakan.

Berikut ini contoh menentukan basis 16:

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

Hasil:

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

Logaritma Alami

Logaritma natural suatu bilangan adalah logaritmanya terhadap dasar konstanta matematika e , di mana e adalah bilangan irasional dan transendental yang dimulai dengan 2,7182818284590452353602874713527 dan berlanjut selamanya.

Konstanta matematika e juga dikenal sebagai bilangan Euler.

Dalam JavaScript, kita dapat menggunakan Math.E untuk mewakili e . Oleh karena itu kita bisa mendapatkan logaritma natural dari suatu bilangan dengan menggunakan Math.E sebagai argumen kedua saat menggunakan $log .

Contoh:

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

Hasil:

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

Ingatlah bahwa MongoDB juga memiliki $ln operator, yang dirancang khusus untuk mengembalikan logaritma natural dari suatu bilangan, jadi Anda mungkin akan lebih mudah menggunakan operator itu. Lihat MongoDB $ln sebagai contoh.

Nilai Di Luar Rentang

Seperti disebutkan, $log operator menerima ekspresi valid apa pun yang menghasilkan angka non-negatif. Nilai di luar rentang tersebut akan menyebabkan kesalahan.

Misalkan kita menambahkan dokumen berikut ke koleksi kita:

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

Mari kita jalankan $log operator terhadap dokumen itu:

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

Hasil:

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

Jenis Data Salah

Memberikan tipe data yang salah juga akan menyebabkan kesalahan.

Misalkan kita menambahkan dokumen berikut ke koleksi kita:

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

Mari kita jalankan $log operator terhadap dokumen itu:

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

Hasil:

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

Kami menyediakan string, sehingga pesan kesalahan memberi tahu kami bahwa argumen $log's argument must be numeric, not string .

Nilai Null

Nilai nol mengembalikan null saat menggunakan $log operator.

Misalkan kita menambahkan dokumen berikut ke koleksi kita:

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

Mari kita jalankan $log operator terhadap dokumen itu:

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

Hasil:

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

Kita dapat melihat bahwa hasilnya adalah null .

Nilai NaN

Jika argumen diselesaikan menjadi NaN , $log mengembalikan NaN .

Contoh:

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

Hasil:

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

Bidang Tidak Ada

Jika $log operator diterapkan pada bidang yang tidak ada, null dikembalikan.

Contoh:

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

Hasil:

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

Dalam hal ini kami mencoba menerapkan $log terhadap bidang yang disebut age , tetapi bidang itu tidak ada di dokumen, jadi kami mendapatkan null .