CONTAINS - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La CONTAINS función devuelve un valor booleano que indica si la primera expresión de cadena contiene la segunda expresión de cadena.

Syntax

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

Arguments

	Description
string_expr_1	Primera cadena que se va a buscar.
string_expr_2	Segunda cadena que se va a buscar.
bool_expr	Valor booleano opcional para omitir mayúsculas y minúsculas. Cuando se establece trueen , CONTAINS realiza una búsqueda que no distingue mayúsculas de minúsculas. Cuando unspecified, este valor tiene falsecomo valor predeterminado .

Tipos de retorno

Devuelve una expresión booleana.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Contiene ejemplos de cadenas

En este ejemplo, la CONTAINS función se usa para comprobar si hay subcadenas en una cadena.

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

Observaciones

• Esta función realiza un examen completo.