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 }

Можем да видим, че първите три документа съдържат масиви, а другите два не.

Също така можем да видим, че първият документ съдържа празен масив. Това все още е масив и така $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 }