CONTAINS — язык запросов в Cosmos DB (в Azure и Fabric)

Функция CONTAINS возвращает логическое значение, указывающее, содержит ли первое строковое выражение второе строковое выражение.

Синтаксис

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

Arguments

	Description
string_expr_1	Первая строка для поиска.
string_expr_2	Вторая строка для поиска.
bool_expr	Необязательное логическое значение для пропуска регистра. Если задано значение true, CONTAINS выполняется нечувствительный поиск по регистру. Если unspecifiedэто значение по умолчанию falseимеет значение .

Типы возвращаемых данных

Возвращает логическое выражение.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Содержит примеры строк

В этом примере CONTAINS функция используется для проверки подстроок в строке.

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

Замечания

• Эта функция выполняет полную проверку.