ARRAY_CONTAINS — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

Funkcja ARRAY_CONTAINS zwraca wartość logiczną wskazującą, czy tablica zawiera określoną wartość. Możesz sprawdzić częściowe lub pełne dopasowanie obiektu przy użyciu wyrażenia logicznego w funkcji.

Składnia

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

Arguments

	Description
array_expr	Wyrażenie tablicy.
expr	Wyrażenie do wyszukiwania w tablicy.
bool_expr	Wyrażenie logiczne wskazujące, czy wyszukiwanie powinno sprawdzać częściowe dopasowanie (true) lub pełne dopasowanie (false). Jeśli nie zostanie określony, wartość domyślna to false.

Typy zwracane

Zwraca wartość logiczną.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Tablica zawiera przykłady

W tym przykładzie ARRAY_CONTAINS funkcja służy do sprawdzania obecności wartości i obiektów w tablicach.

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

Uwagi

• Ta funkcja korzysta z użycia indeksu zakresu. Aby uzyskać więcej informacji, zobacz indeksy zakresu.