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

La CONTAINS funzione restituisce un valore booleano che indica se la prima espressione stringa contiene la seconda espressione stringa.

Sintassi

CONTAINS(<string_expr_1>, <string_expr_2> [, <bool_expr>])

Arguments

	Description
string_expr_1	Prima stringa da cercare.
string_expr_2	Seconda stringa da trovare.
bool_expr	Valore booleano facoltativo per ignorare la distinzione tra maiuscole e minuscole. Se impostato su true, CONTAINS esegue una ricerca senza distinzione tra maiuscole e minuscole. Quando unspecified, il valore predefinito è false.

Tipi restituiti

Restituisce un'espressione booleana.

Esempi

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

Contiene esempi di stringhe

In questo esempio, la CONTAINS funzione viene usata per verificare la presenza di sottostringhe in una stringa.

SELECT VALUE {
  containsPrefix: CONTAINS("AdventureWorks", "Adventure"), 
  containsSuffix: CONTAINS("AdventureWorks", "Works"),
  containsWrongCase: CONTAINS("AdventureWorks", "adventure"), 
  containsWrongCaseValidateCase: CONTAINS("AdventureWorks", "adventure", false), 
  containsWrongCaseIgnoreCase: CONTAINS("AdventureWorks", "works", true),
  containsMismatch: CONTAINS("AdventureWorks", "Contoso")
}

[
  {
    "containsPrefix": true,
    "containsSuffix": true,
    "containsWrongCase": false,
    "containsWrongCaseValidateCase": false,
    "containsWrongCaseIgnoreCase": true,
    "containsMismatch": false
  }
]

Osservazioni:

• Questa funzione esegue un'analisi completa.