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 :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/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 :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/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 }