REGEXMATCH - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A REGEXMATCH função retorna um booleano indicando se a cadeia de caracteres fornecida corresponde à expressão regular especificada. As expressões regulares são uma notação concisa e flexível para encontrar padrões de texto.

Uma função de sistema do Azure Cosmos DB para NoSQL que fornece recursos de expressão regular.

Sintaxe

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

Arguments

	Description
string_expr_1	Uma expressão de cadeia de caracteres a ser pesquisada.
string_expr_2	Uma expressão de cadeia de caracteres com uma expressão regular definida para usar ao pesquisar string_expr_1.
string_expr_3	Uma expressão de cadeia de caracteres opcional com os modificadores selecionados para usar com a expressão regular (string_expr_2). Se não for fornecido, o padrão é executar a correspondência de expressão regular sem modificadores.

Tipos de devolução

Retorna uma expressão booleana.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Correspondência de expressão regular com modificadores

Neste exemplo, a REGEXMATCH função é usada para corresponder a vários padrões e modificadores.

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

Observações

• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.