ARRAY_CONTAINS (NoSQL-fråga)
GÄLLER FÖR: NoSQL
Returnerar ett booleskt värde som anger om matrisen innehåller det angivna värdet. Du kan söka efter en partiell eller fullständig matchning av ett objekt med hjälp av ett booleskt uttryck i funktionen.
Syntax
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argument
beskrivning | |
---|---|
arr_expr |
Ett matrisuttryck. |
expr |
Uttryck att söka efter i matrisen. |
bool_expr |
Ett booleskt uttryck som anger om sökningen ska söka efter en partiell matchning (true ) eller en fullständig matchning (false ). Om det inte anges är false standardvärdet . |
Returtyper
Returnerar ett booleskt värde.
Exempel
I följande exempel visas hur du söker efter specifika värden eller objekt i en matris med hjälp av den här funktionen.
SELECT VALUE {
containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}
[
{
"containsItem": true,
"missingItem": false,
"containsFullMatchObject": true,
"missingFullMatchObject": false,
"containsPartialMatchObject": true,
"missingPartialMatchObject": false
}
]
Kommentarer
- Den här systemfunktionen drar nytta av ett intervallindex.