MongoDB $pow

В MongoDB, $pow Операторът на конвейера за агрегиране издига число до посочения експонент и връща резултата

$pow приема два израза, предоставени в масив. Първото е числото, а второто е степента. И двете могат да бъдат всеки валиден израз, стига да се разделят на число.

Пример

Да предположим, че имаме колекция, наречена test със следните документи:

{ "_id" : 1, "data" : 10 }
{ "_id" : 2, "data" : -3 }
{ "_id" : 3, "data" : 0 }
{ "_id" : 4, "data" : null }

Можем да използваме $pow оператор за повдигане на data поле с определена степен:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", 3 ] }
      }
    }
  ]
)

Резултат:

{ "result" : 1000 }
{ "result" : -27 }
{ "result" : 0 }
{ "result" : null }

В този случай използвах data поле като число и 3 като показател. Следователно всеки документ имаше свои data поле, повдигнато със степента на 3.

Можем да видим това null стойностите връщат null .

Резултатът обикновено е от същия тип като входа. Има обаче изключения от това правило. По-конкретно:

• 32-битово цяло число ще бъде преобразувано в 64-битово цяло число, ако резултатът е представим като 64-битово цяло число.
• 32-битово цяло число ще бъде преобразувано в двойно, ако резултатът не е представим като 64-битово цяло число.
• 64-битово цяло число ще бъде преобразувано в двойно, ако резултатът не е представим като 64-битово цяло число.

Отрицателен показател

Не можете да повишите нула (0 ) към отрицателен показател.

Пример:

db.test.aggregate(
  [
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", -3 ] }
      }
    }
  ]
)

Резултат:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "$pow cannot take a base of 0 and a negative exponent",
	"code" : 28764,
	"codeName" : "Location28764"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

Грешката изрично гласи, че „$pow не може да вземе основа от 0 и отрицателен експонент “.

Ако обаче изключим документ 3, вече няма да получаваме грешката:

db.test.aggregate(
  [
    { $match: { _id: { $nin: [ 3 ] } } },
    { $project: { 
        result: { $pow: [ "$data", -3 ] }
      }
    }
  ]
)

Резултат:

{ "_id" : 1, "result" : 0.001 }
{ "_id" : 2, "result" : -0.037037037037037035 }
{ "_id" : 4, "result" : null }

NaN стойности

Ако аргументът се разреши до NaN , $pow връща NaN .

Пример:

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

Резултат:

{ "result" : NaN }
{ "result" : NaN }
{ "result" : NaN }
{ "result" : NaN }

Несъществуващи полета

Ако $pow операторът се прилага срещу поле, което не съществува, null се връща.

Пример:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$beer", 3 ] }
      }
    }
  ]
)

Резултат:

{ "result" : null }
{ "result" : null }
{ "result" : null }
{ "result" : null }

Нулев експонент

Вече видяхме, че null стойност връща null . Това е вярно и при предоставяне на null като степен.

Пример:

db.test.aggregate(
  [
    { $project: { 
        _id: 0,
        result: { $pow: [ "$data", null ] }
      }
    }
  ]
)

Резултат:

{ "result" : null }
{ "result" : null }
{ "result" : null }
{ "result" : null }