operador =~ (equals)

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Filtra um conjunto de registros para dados com uma cadeia de caracteres que não diferencia maiúsculas de minúsculas.

A tabela a seguir fornece uma comparação dos == operadores (iguais):

Operador	Descrição	Diferencia maiúsculas de minúsculas	Exemplo (suspende true)
==	Igual a	Sim	"aBc" == "aBc"
!=	Não é igual a	Sim	"abc" != "ABC"
=~	Igual a	Não	"abc" =~ "ABC"
!~	Não é igual a	Não	"aBc" !~ "xyz"

Para obter mais informações sobre outros operadores e determinar qual operador é mais apropriado para sua consulta, consulte operadores de cadeia de caracteres de tipo de dados.

Dicas de desempenho

Observação

O desempenho depende do tipo de pesquisa e da estrutura dos dados. Para obter as práticas recomendadas, consulte Práticas recomendadas de consulta.

Quando possível, use == - uma versão do operador que diferencia maiúsculas de minúsculas.

Sintaxe

Expressão T col |where

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
T	string	✔️	a entrada tabular cujos registros serão filtrados.
Col	string	✔️	A coluna a ser filtrada.
expressão	string	✔️	A expressão usada para filtrar.

Devoluções

Retorna as linhas em T para as quais o predicado é true.

Exemplos

O exemplo a seguir mostra como usar o =~ operador para filtrar um conjunto de registros para dados com uma cadeia de caracteres que não diferencia maiúsculas de minúsculas.

Executar a consulta

StormEvents
| where State =~ "kansas"
| project EventId, State

A tabela a seguir mostra apenas os 10 primeiros resultados. Para ver a saída completa, execute a consulta.

EventId	Estado
70787	KANSAS
43450	KANSAS
43451	KANSAS
38844	KANSAS
18463	KANSAS
18464	KANSAS
18495	KANSAS
43466	KANSAS
43467	KANSAS
43470	KANSAS