Partager via


CONTAINS - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La CONTAINS fonction retourne une valeur booléenne indiquant si la première expression de chaîne contient la deuxième expression de chaîne.

Syntaxe

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

Arguments

Descriptif
string_expr_1 Première chaîne à rechercher.
string_expr_2 Deuxième chaîne à rechercher.
bool_expr Valeur booléenne facultative pour ignorer la casse. Lorsqu’il est défini truesur , CONTAINS effectue une recherche qui ne respecte pas la casse. Quand unspecified, cette valeur est définie par défaut sur false.

Types de retour

Retourne une expression booléenne.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Contient des exemples de chaînes

Dans cet exemple, la CONTAINS fonction est utilisée pour vérifier les sous-chaînes d’une chaîne.

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

Remarques

  • Cette fonction effectue une analyse complète.