MongoDB $pow

V MongoDB, $pow operátor agregačního kanálu zvýší číslo na zadaný exponent a vrátí výsledek

$pow přijímá dva výrazy dodávané v poli. První je číslo a druhý je exponent. Oba mohou být libovolným platným výrazem, pokud se vyhodnotí jako číslo.

Příklad

Předpokládejme, že máme kolekci nazvanou test s následujícími dokumenty:

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

Můžeme použít $pow operátor pro zvýšení data pole zadaným exponentem:

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

Výsledek:

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

V tomto případě jsem použil data pole jako číslo a 3 jako exponent. Proto měl každý dokument svá data pole zvednuté o mocninu 3.

Vidíme, že null hodnoty vrátí null .

Výsledkem je obvykle stejný typ jako vstup. Z tohoto pravidla však existují výjimky. Konkrétně:

• 32bitové celé číslo bude převedeno na 64bitové celé číslo, pokud je výsledek reprezentovatelný jako 64bitové celé číslo.
• Pokud výsledek nelze reprezentovat jako 64bitové celé číslo, bude 32bitové celé číslo převedeno na dvojnásobek.
• Pokud výsledek nelze reprezentovat jako 64bitové celé číslo, bude 64bitové celé číslo převedeno na dvojnásobek.

Záporný exponent

Nemůžete zvýšit nulu (0 ) na záporný exponent.

Příklad:

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

Výsledek:

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

Chyba výslovně uvádí, že „$pow nemůže mít základ 0 a záporný exponent “.

Pokud však vyloučíme dokument 3, již se nám nezobrazí chyba:

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

Výsledek:

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

Hodnoty NaN

Pokud je argument vyřešen na NaN , $pow vrátí NaN .

Příklad:

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

Výsledek:

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

Neexistující pole

Pokud $pow operátor se použije na pole, které neexistuje, null je vráceno.

Příklad:

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

Výsledek:

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

Nulový exponent

Už jsme viděli, že null hodnota vrátí null . To platí také při zadávání null jako exponent.

Příklad:

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

Výsledek:

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