ARRAY_CONTAINS – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce ARRAY_CONTAINS vrátí logickou hodnotu označující, zda matice obsahuje zadanou hodnotu. Částečnou nebo úplnou shodu objektu můžete zkontrolovat pomocí logického výrazu v rámci funkce.

Syntaxe

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

Arguments

	Description
array_expr	Maticový výraz.
expr	Výraz, který chcete vyhledat v rámci pole.
bool_expr	Logický výraz označující, jestli má hledání zkontrolovat částečnou shodu (true) nebo úplnou shodu (false). Pokud není zadána, je výchozí hodnota false.

Návratové typy

Vrátí logickou hodnotu.

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Pole obsahuje příklady

V tomto příkladu ARRAY_CONTAINS se funkce používá ke kontrole přítomnosti hodnot a objektů v polích.

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
  }
]

Poznámky

• Tato funkce přináší výhody použití indexu rozsahu. Další informace najdete v tématu indexy rozsahu.