In MongoDB, il $setEquals
l'operatore della pipeline di aggregazione confronta due o più array e restituisce true
se hanno gli stessi elementi distinti e false
altrimenti.
$setEquals
accetta due o più argomenti, che possono essere tutti qualsiasi espressione valida purché ciascuno si risolva in un array. $setEquals
tratta gli array come insiemi.
Esempio
Supponiamo di avere una raccolta chiamata data
con i seguenti documenti:
{ "_id" : 1, "a" : [ 1, 2, 3 ], "b" : [ 1, 2, 3 ] } { "_id" : 2, "a" : [ 1, 2, 3 ], "b" : [ 1, 2 ] } { "_id" : 3, "a" : [ 1, 2 ], "b" : [ 1, 2, 3 ] } { "_id" : 4, "a" : [ 1, 2, 3 ], "b" : [ 3, 4, 5 ] } { "_id" : 5, "a" : [ 1, 2, 3 ], "b" : [ 4, 5, 6 ] }
Possiamo applicare il $setEquals
operatore contro a
e b
campi in quei documenti.
Esempio:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3, 4, 5 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
{ "a" : [ 1, 2, 3 ], "b" : [ 1, 2, 3 ], "result" : true } { "a" : [ 1, 2, 3 ], "b" : [ 1, 2 ], "result" : false } { "a" : [ 1, 2 ], "b" : [ 1, 2, 3 ], "result" : false } { "a" : [ 1, 2, 3 ], "b" : [ 3, 4, 5 ], "result" : false } { "a" : [ 1, 2, 3 ], "b" : [ 4, 5, 6 ], "result" : false }
Matrici nidificate
Il $setEquals
l'operatore non discende in nessun array nidificato. Valuta solo gli array di primo livello.
Supponiamo che la nostra collezione contenga anche i seguenti documenti:
{ "_id" : 6, "a" : [ 1, 2, 3 ], "b" : [ [ 1, 2, 3 ] ] } { "_id" : 7, "a" : [ 1, 2, 3 ], "b" : [ [ 1, 2 ], 3 ] }
E applichiamo $setEquals
a quei due documenti:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 6, 7 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
{ "a" : [ 1, 2, 3 ], "b" : [ [ 1, 2, 3 ] ], "result" : false } { "a" : [ 1, 2, 3 ], "b" : [ [ 1, 2 ], 3 ], "result" : false }
Nel primo documento, il b
field conteneva un array che conteneva solo un elemento:un altro array. In questo caso, è stato valutato l'array esterno ed è stato riscontrato che non conteneva gli stessi valori che erano nell'array in a
.
Tuttavia, se il a
field conteneva un array nidificato stesso, potrebbe essere stata una storia diversa.
Supponiamo di avere i seguenti documenti:
{ "_id" : 8, "a" : [ [ 1, 2, 3 ] ], "b" : [ [ 1, 2, 3 ] ] } { "_id" : 9, "a" : [ [ 1, 2, 3 ] ], "b" : [ [ 1, 2 ], 3 ] }
E applichiamo $setEquals
a quei documenti:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 8, 9 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
{ "a" : [ [ 1, 2, 3 ] ], "b" : [ [ 1, 2, 3 ] ], "result" : true } { "a" : [ [ 1, 2, 3 ] ], "b" : [ [ 1, 2 ], 3 ], "result" : false }
Nel primo documento, a
corrisponde a b
esattamente, quindi il risultato è true
.
Nel secondo documento, l'array nidificato in a
è diverso dall'array nidificato in b
, e quindi otteniamo false
.
Campi mancanti
Applicazione di $setEquals
a un campo inesistente provoca un errore.
Considera i seguenti documenti:
{ "_id" : 10, "a" : [ 1, 2, 3 ] } { "_id" : 11, "b" : [ 1, 2, 3 ] } { "_id" : 12 }
Il primo documento non ha un b
campo, il secondo documento non ha un a
campo e neanche il terzo documento ne ha.
Ecco cosa succede quando applichiamo $setEquals
al a
e b
campi:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 10, 11, 12 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
Error: command failed: { "ok" : 0, "errmsg" : "All operands of $setEquals must be arrays. One argument is of type: missing", "code" : 17044, "codeName" : "Location17044" } : 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
Come afferma il messaggio, tutti gli operandi devono essere array. Un argomento/campo mancante non è un array.
Tipo di dati errato
Come visto nell'esempio precedente, tutti gli operandi di $setEquals
devono essere array. Se il campo a cui si riferiscono è mancante, viene generato un errore. Lo stesso errore si verifica quando l'operando non è mancante, ma è semplicemente del tipo sbagliato.
Supponiamo che la nostra collezione contenga i seguenti documenti:
{ "_id" : 13, "a" : [ 1, 2, 3 ], "b" : 3 } { "_id" : 14, "a" : 3, "b" : [ 1, 2, 3 ] } { "_id" : 15, "a" : 2, "b" : 3 }
E applichiamo $setEquals
a quei documenti:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 13, 14, 15 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
Error: command failed: { "ok" : 0, "errmsg" : "All operands of $setEquals must be arrays. One argument is of type: double", "code" : 17044, "codeName" : "Location17044" } : 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
Valori duplicati
Il $setEquals
l'operatore ignora le voci duplicate. Ignora anche l'ordine degli elementi.
Supponiamo di avere i seguenti documenti:
{ "_id" : 16, "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ 1, 2, 3 ] } { "_id" : 17, "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ 1, 2 ] } { "_id" : 18, "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ ] } { "_id" : 19, "a" : [ 3, 2, 1, 2, 3, 1 ], "b" : [ 2, 3, 1 ] } { "_id" : 20, "a" : [ 1, 3, 2, 2, 3, 1 ], "b" : [ 2, 1 ] } { "_id" : 21, "a" : [ 2, 3, 1, 2, 3, 1 ], "b" : [ ] }
Quindi applichiamo il $setEquals
operatore a loro:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 16, 17, 18, 19, 20, 21 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $setEquals: [ "$a", "$b" ] }
}
}
]
)
Risultato:
{ "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ 1, 2, 3 ], "result" : true } { "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ 1, 2 ], "result" : false } { "a" : [ 1, 1, 2, 2, 3, 3 ], "b" : [ ], "result" : false } { "a" : [ 3, 2, 1, 2, 3, 1 ], "b" : [ 2, 3, 1 ], "result" : true } { "a" : [ 1, 3, 2, 2, 3, 1 ], "b" : [ 2, 1 ], "result" : false } { "a" : [ 2, 3, 1, 2, 3, 1 ], "b" : [ ], "result" : false }
Più di due argomenti
Come accennato, $setEquals
accetta due o più argomenti. In tutti i casi, gli argomenti devono avere gli stessi valori distinti per restituire true
. Altrimenti il risultato sarà false
.
Supponiamo di avere i seguenti documenti:
{ "_id" : 22, "a" : [ 1, 2 ], "b" : [ 1, 2 ], "c" : [ 1, 2 ] } { "_id" : 23, "a" : [ 1, 2 ], "b" : [ 1, 2 ], "c" : [ 1, 2, 3 ] }
Questi documenti hanno un campo aggiuntivo:un c
campo.
Ora applichiamo $setEquals
a quei tre campi:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 22, 23 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
c: 1,
result: { $setEquals: [ "$a", "$b", "$c" ] }
}
}
]
)
Risultato:
{ "a" : [ 1, 2 ], "b" : [ 1, 2 ], "c" : [ 1, 2 ], "result" : true } { "a" : [ 1, 2 ], "b" : [ 1, 2 ], "c" : [ 1, 2, 3 ], "result" : false }