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

Функция REGEXMATCH возвращает логическое значение, указывающее, соответствует ли указанная строка указанному регулярному выражению. Регулярные выражения — это краткие и гибкие нотации для поиска шаблонов текста.

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

Синтаксис

REGEXMATCH(<string_expr_1>, <string_expr_2>[, <string_expr_3>])

Arguments

	Description
string_expr_1	Строковое выражение для поиска.
string_expr_2	Строковое выражение с регулярным выражением, определенным для использования при поиске string_expr_1.
string_expr_3	Необязательное строковое выражение с выбранными модификаторами для использования с регулярным выражением (string_expr_2). Если это не указано, по умолчанию выполняется сопоставление регулярных выражений без модификаторов.

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

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

Примеры

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

Регулярное выражение совпадает с модификаторами

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

SELECT VALUE {
  noModifiers: REGEXMATCH("abcd", "ABC"),
  caseInsensitive: REGEXMATCH("abcd", "ABC", "i"),
  wildcardCharacter: REGEXMATCH("abcd", "ab.", ""),
  ignoreWhiteSpace: REGEXMATCH("abcd", "ab c", "x"),
  caseInsensitiveAndIgnoreWhiteSpace: REGEXMATCH("abcd", "aB c", "ix"),
  containNumberBetweenZeroAndNine: REGEXMATCH("03a", "[0-9]"),
  containPrefix: REGEXMATCH("salt3824908", "salt{1}"),
  containsFiveLetterWordStartingWithS: REGEXMATCH("shame", "s....", "i")
}

[
  {
    "noModifiers": false,
    "caseInsensitive": true,
    "wildcardCharacter": true,
    "ignoreWhiteSpace": true,
    "caseInsensitiveAndIgnoreWhiteSpace": true,
    "containNumberBetweenZeroAndNine": true,
    "containPrefix": true,
    "containsFiveLetterWordStartingWithS": true
  }
]

Замечания

• Эта функция использует индекс диапазона. Дополнительные сведения см. в разделе индексов диапазона.