Partilhar via


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

A STRINGEQUALS função retorna um booleano indicando se a primeira expressão de cadeia de caracteres corresponde à segunda.

Uma função de sistema do Azure Cosmos DB para NoSQL que retorna um booleano indicando se duas cadeias de caracteres são equivalentes.

Sintaxe

STRINGEQUALS(<string_expr_1>, <string_expr_2> [, <boolean_expr>])

Arguments

Description
string_expr_1 A primeira expressão de cadeia de caracteres a ser comparada.
string_expr_2 A segunda expressão de cadeia de caracteres a ser comparada.
boolean_expr Uma expressão booleana opcional para ignorar maiúsculas e minúsculas. Quando definida como true, essa função executa uma pesquisa que não diferencia maiúsculas de minúsculas. Se não for especificado, o valor padrão será false.

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.

Comparar a igualdade de cadeias de caracteres

Neste exemplo, a STRINGEQUALS função é usada para verificar se duas cadeias de caracteres são iguais, com e sem diferenciação de maiúsculas e minúsculas.

SELECT VALUE {
  compareSameCase: STRINGEQUALS("AdventureWorks", "AdventureWorks"),
  compareDifferentCase: STRINGEQUALS("AdventureWorks", "adventureworks"),
  compareIgnoreCase: STRINGEQUALS("AdventureWorks", "adventureworks", true)
}
[
  {
    "compareSameCase": true,
    "compareDifferentCase": false,
    "compareIgnoreCase": true
  }
]

Observações

  • Esta função executa uma busca de índice.