MongoDB $ isArray

In MongoDB puoi usare $isArray operatore della pipeline di aggregazione per verificare se un valore è un array.

Accetta qualsiasi espressione valida e restituisce true se l'espressione è un array, false se non lo è.

Esempio

Supponiamo di avere una collezione chiamata test con i seguenti documenti:

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

Possiamo usare il seguente codice per controllare i data campo per gli array:

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

Risultato:

{ "_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 }

Possiamo vedere che i primi tre documenti contengono array e gli altri due no.

Inoltre, possiamo vedere che il primo documento contiene un array vuoto. Quello è ancora un array, e quindi $isArray restituisce true .

Esempio 2

Ecco un altro esempio che contiene vari campi di diversi tipi BSON.

Supponiamo di avere una collezione chiamata types con il seguente documento:

{
	"_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
	]
}

Ai fini di questo articolo, ho nominato ogni campo in modo che rifletta il suo tipo BSON.

Ora possiamo utilizzare il codice seguente per restituire true o false per ogni campo, a seconda che il campo sia o meno un array:

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()

Risultato:

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

Campo mancante

Applicazione di $isArray in un campo che non esiste risulta false .

Supponiamo il nostro test raccolta contiene il seguente documento:

{ "_id" : 6 }

E applichiamo $isArray a quel documento:

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

Risultato:

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

Valori Nulli

Applicazione di $isArray a null restituisce false .

Supponiamo il nostro test raccolta contiene il seguente documento:

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

E applichiamo $isArray a quel documento:

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

Risultato:

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

Valori non definiti

Allo stesso modo, fornire valori non definiti restituisce false .

Supponiamo il nostro test raccolta contiene il seguente documento:

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

Applica $isArray :

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

Risultato:

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