Udostępnij za pośrednictwem


ARRAY_CONTAINS (zapytanie NoSQL)

DOTYCZY: NoSQL

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

Argumenty

opis
arr_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

Poniższy przykład ilustruje sposób sprawdzania określonych wartości lub obiektów w tablicy przy użyciu tej funkcji.

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 systemowa korzysta z indeksu zakresu.