ARRAY_CONTAINS - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La ARRAY_CONTAINS funzione restituisce un valore booleano che indica se la matrice contiene il valore specificato. È possibile verificare la presenza di una corrispondenza parziale o completa di un oggetto usando un'espressione booleana all'interno della funzione.

Sintassi

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

Arguments

	Description
array_expr	Espressione di matrice.
expr	Espressione da cercare all'interno della matrice.
bool_expr	Espressione booleana che indica se la ricerca deve cercare una corrispondenza parziale (true) o una corrispondenza completa (false). Se non è specificato, il valore predefinito è false.

Tipi restituiti

Restituisce un valore booleano.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Matrice contiene esempi

In questo esempio, la ARRAY_CONTAINS funzione viene usata per verificare la presenza di valori e oggetti nelle matrici.

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

Osservazioni:

• Questa funzione trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.