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

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

Системная функция Azure Cosmos DB, которая возвращает логическое значение, указывающее, начинается ли одно строковое выражение с другого.

Синтаксис

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

Arguments

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

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

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

Примеры

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

Проверка того, начинается ли строка с другой строки

В этом примере функция используется для проверки того, STARTSWITH начинается ли строка с заданным префиксом и без учета регистра.

SELECT VALUE {
  startsWithWrongPrefix: STARTSWITH("AdventureWorks", "Works"),
  startsWithCorrectPrefix: STARTSWITH("AdventureWorks", "Adventure"),
  startsWithPrefixWrongCase: STARTSWITH("AdventureWorks", "adventure"),
  startsWithPrefixCaseInsensitive: STARTSWITH("AdventureWorks", "adventure", true)
}

[
  {
    "startsWithWrongPrefix": false,
    "startsWithCorrectPrefix": true,
    "startsWithPrefixWrongCase": false,
    "startsWithPrefixCaseInsensitive": true
  }
]

Замечания

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