MongoDB $pow

W MongoDB $pow Operator potoku agregacji podnosi liczbę do określonego wykładnika i zwraca wynik

$pow akceptuje dwa wyrażenia podane w tablicy. Pierwsza to liczba, a druga to wykładnik. Oba mogą być dowolnymi poprawnymi wyrażeniami, o ile są wynikiem liczby.

Przykład

Załóżmy, że mamy kolekcję o nazwie test z następującymi dokumentami:

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

Możemy użyć $pow operator do podniesienia data pole przez określony wykładnik:

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

Wynik:

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

W tym przypadku użyłem data pole jako numer, a 3 jako wykładnik. Dlatego każdy dokument miał swoje data pole podniesione o potęgę 3.

Widzimy, że null wartości zwracają null .

Wynik jest zwykle tego samego typu, co dane wejściowe. Istnieją jednak wyjątki od tej reguły. W szczególności:

• 32-bitowa liczba całkowita zostanie przekonwertowana na 64-bitową liczbę całkowitą, jeśli wynik będzie reprezentowany jako 64-bitowa liczba całkowita.
• 32-bitowa liczba całkowita zostanie przekonwertowana na podwójną, jeśli wynik nie będzie reprezentowany jako 64-bitowa liczba całkowita.
• 64-bitowa liczba całkowita zostanie przekonwertowana na double, jeśli wynik nie będzie reprezentowany jako 64-bitowa liczba całkowita.

Wykładnik ujemny

Nie możesz podnieść zero (0 ) do ujemnego wykładnika.

Przykład:

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

Wynik:

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

Błąd wyraźnie stwierdza, że ​​„$pow nie może przyjąć podstawy 0 i ujemnego wykładnika „.

Jeśli jednak wykluczymy dokument 3, nie otrzymamy już błędu:

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

Wynik:

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

Wartości NaN

Jeśli argument kończy się na NaN , $pow zwraca NaN .

Przykład:

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

Wynik:

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

Nieistniejące pola

Jeśli $pow operator jest stosowany do pola, które nie istnieje, null jest zwracany.

Przykład:

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

Wynik:

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

Wykładnik pusty

Widzieliśmy już, że null wartość zwraca null . Dotyczy to również podania null jako wykładnik.

Przykład:

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

Wynik:

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