=~ (equals) operator

Filters a record set for data with a case-insensitive string.

The following table provides a comparison of the == (equals) operators:

Operator Description Case-Sensitive Example (yields true)
== Equals Yes "aBc" == "aBc"
!= Not equals Yes "abc" != "ABC"
=~ Equals No "abc" =~ "ABC"
!~ Not equals No "aBc" !~ "xyz"

For more information about other operators and to determine which operator is most appropriate for your query, see datatype string operators.

Performance tips


Performance depends on the type of search and the structure of the data. For best practices, see Query best practices.

When possible, use == - a case-sensitive version of the operator.


T | where col =~ (expression)


Name Type Required Description
T string The tabular input whose records are to be filtered.
col string The column to filter.
expression string The expression used to filter.


Rows in T for which the predicate is true.


The State values in the StormEvents table are capitalized. The following query matches columns with the value "KANSAS".

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

The following table only shows the first 10 results. To see the full output, run the query.

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