MongoDBでは、$objectToArray
集約パイプライン演算子は、ドキュメントを配列に変換します。
$objectToArray
によって生成された配列 元のドキュメントの各フィールド/値のペアの要素が含まれています。各要素は、k
を含むドキュメントです。 フィールドとv
フィールド:
-
k
フィールドには、元のドキュメントのフィールド名が含まれています。 -
v
fieldには、元のドキュメントのフィールドの値が含まれています。
例
dogs
というコレクションがあるとします。 次のドキュメントで:
{ "_id" : 1, "name" : "Fetch", "specs" : { "height" : 400, "weight" : 55, "color" : "brown" } }
$objectToArray
を使用できます specs
を返す演算子 配列としてのフィールド:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
).pretty()
結果:
{ "result" : [ { "k" : "height", "v" : 400 }, { "k" : "weight", "v" : 55 }, { "k" : "color", "v" : "brown" } ] }
ネストされたドキュメント
$objectToArray
演算子はトップレベルのフィールドにのみ適用されます。埋め込まれたドキュメントには再帰的に適用されません。
次のようなドキュメントがあるとします。
{ "_id" : 2, "name" : "Wag", "specs" : { "height" : 50, "weight" : 5, "color" : { "eyes" : "brown", "coat" : "black" } } }
$objectToArray
を適用すると次のようになります そのドキュメントへ:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 2 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
).pretty()
結果:
{ "result" : [ { "k" : "height", "v" : 50 }, { "k" : "weight", "v" : 5 }, { "k" : "color", "v" : { "eyes" : "brown", "coat" : "black" } } ] }
この場合、最上位のドキュメントはk
に変換されます / v
フォーマットしますが、埋め込まれたドキュメントは元のドキュメントと同じままです。
間違ったタイプ
$objectToArray
に提供される引数 ドキュメントオブジェクトに解決される限り、任意の有効な式にすることができます。
引数がドキュメントオブジェクトに解決されない場合、エラーが発生します。
次のドキュメントがあるとします。
{ "_id" : 3, "name" : "Fetch", "specs" : "None" }
specs
フィールドに文字列が含まれています。
$objectToArray
を適用すると次のようになります そのドキュメントへ:
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 3 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
結果:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$objectToArray requires a document input, found: string", "code" : 40390, "codeName" : "Location40390" } : 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
エラーが示すように、$objectToArray requires a document input
。
ヌル値
null
を提供する 結果はnull
。
次のドキュメントがあるとします。
{ "_id" : 4, "name" : "Fetch", "specs" : null }
そして、$objectToArray
を適用します :
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
結果:
{ "result" : null }
欠落しているフィールド
フィールドが欠落している場合、結果はnull
になります 。
次のドキュメントがあるとします。
{ "_id" : 5, "name" : "Fetch" }
そして、$objectToArray
を適用します :
db.dogs.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
_id: 0,
result: { $objectToArray: "$specs" } }
}
]
)
結果:
{ "result" : null }