MongoDB $ isArray

MongoDBでは、$isArrayを使用できます値が配列であるかどうかを確認するための集計パイプライン演算子。

有効な式を受け入れ、trueを返します。式が配列の場合、false そうでない場合。

例

testというコレクションがあるとします。次のドキュメントを使用：

{ "_id" : 1, "data" : [ ] }
{ "_id" : 2, "data" : [ 1, 2, 3 ] }
{ "_id" : 3, "data" : [ "XS", "M", "L" ] }
{ "_id" : 4, "data" : 123 }
{ "_id" : 5, "data" : "Homer Jay" }

次のコードを使用して、dataを確認できます。配列のフィールド：

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 1, 2, 3, 4, 5 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

結果：

{ "_id" : 1, "data" : [ ], "result" : true }
{ "_id" : 2, "data" : [ 1, 2, 3 ], "result" : true }
{ "_id" : 3, "data" : [ "XS", "M", "L" ], "result" : true }
{ "_id" : 4, "data" : 123, "result" : false }
{ "_id" : 5, "data" : "Homer Jay", "result" : false }

最初の3つのドキュメントには配列が含まれ、他の2つのドキュメントには含まれていないことがわかります。

また、最初のドキュメントに空の配列が含まれていることがわかります。それはまだ配列なので、$isArray trueを返します。

例2

さまざまなBSONタイプのさまざまなフィールドを含む別の例を次に示します。

typesというコレクションがあるとします。次のドキュメントで：

{
	"_id" : ObjectId("601738d7c8eb4369cf6ad9de"),
	"double" : 123.75,
	"string" : "123",
	"boolean" : true,
	"date" : ISODate("2020-12-31T23:30:15.123Z"),
	"integer" : 123,
	"long" : NumberLong(123),
	"decimal" : NumberDecimal("123.75"),
	"object" : {
		"a" : 1
	},
	"array" : [
		1,
		2,
		3
	]
}

この記事では、BSONタイプを反映するように各フィールドに名前を付けました。

次のコードを使用して、trueのいずれかを返すことができます。またはfalse フィールドが配列であるかどうかに応じて、フィールドごとに：

db.types.aggregate(
  [
    {
      $project:
        { 
          _id: { $isArray: "$_id" },
          double: { $isArray: "$double" },
          string: { $isArray: "$string" },
          boolean: { $isArray: "$boolean" },
          date: { $isArray: "$date" },
          integer: { $isArray: "$integer" },
          long: { $isArray: "$long" },
          decimal: { $isArray: "$decimal" },
          object: { $isArray: "$object" },
          array: { $isArray: "$array" }
        }
    }
  ]
).pretty()

結果：

{
	"_id" : false,
	"double" : false,
	"string" : false,
	"boolean" : false,
	"date" : false,
	"integer" : false,
	"long" : false,
	"decimal" : false,
	"object" : false,
	"array" : true
}

ミッシングフィールド

$isArrayを適用する存在しないフィールドに移動すると、falseになります。

testを想定しますコレクションには次のドキュメントが含まれています：

{ "_id" : 6 }

そして、$isArrayを適用しますそのドキュメントへ：

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 6 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

結果：

{ "_id" : 6, "result" : false }

ヌル値

$isArrayを適用する nullに falseを返します。

testを想定しますコレクションには次のドキュメントが含まれています：

{ "_id" : 7, "data" : null }

そして、$isArrayを適用しますそのドキュメントへ：

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 7 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

結果：

{ "_id" : 7, "data" : null, "result" : false }

未定義の値

同様に、未定義の値を指定すると、falseが返されます。

testを想定しますコレクションには次のドキュメントが含まれています：

{ "_id" : 8, "data" : undefined }

$isArrayを適用します：

db.test.aggregate(
  [
     { $match: { _id: { $in: [ 8 ] } } },
    {
      $project:
        { 
          _id: 1,
          data: 1,
          result: { $isArray: "$data" }
        }
    }
  ]
)

結果：

{ "_id" : 8, "data" : undefined, "result" : false }