MongoDBでは、$pow
集計パイプライン演算子は、指定された指数まで数値を上げて結果を返します
$pow
配列で提供される2つの式を受け入れます。 1つ目は数値で、2つ目は指数です。数値に解決される限り、どちらも有効な式にすることができます。
例
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
を返します 。
結果は通常、入力と同じタイプです。ただし、この規則には例外があります。具体的には:
- 結果が64ビット整数として表現できる場合、32ビット整数は64ビット整数に変換されます。
- 結果が64ビット整数として表現できない場合、32ビット整数はdoubleに変換されます。
- 結果が64ビット整数として表現できない場合、64ビット整数はdoubleに変換されます。
負の指数
ゼロを上げることはできません(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 }