Partilhar via


CONTÉM (consulta NoSQL)

APLICA-SE A: NoSQL

Retorna um booleano que indica se a primeira expressão de cadeia de caracteres contém a segunda expressão de cadeia de caracteres.

Sintaxe

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

Argumentos

Description
string_expr_1 A primeira cadeia de caracteres a pesquisar.
string_expr_2 A segunda cadeia de caracteres a ser localizada.
bool_expr(Opcional) Valor booleano opcional para ignorar maiúsculas e minúsculas. Quando definido como true, CONTAINS executa uma pesquisa que não diferencia maiúsculas de minúsculas. Quando unspecified, esse valor assume como padrão .false

Tipos de devolução

Retorna uma expressão booleana.

Exemplos

O exemplo a seguir verifica se existem várias substrings estáticas em uma cadeia de caracteres.

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

Observações

  • Esta função executa uma verificação completa.