Edit

== (equals) operator

  • Article

Filters a record set for data matching a case-sensitive string.

The following table provides a comparison of the == 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

Note

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

Syntax

T | where col == (expression, ... )

Learn more about syntax conventions.

Parameters

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.

Returns

Rows in T for which the predicate is true.

Example

Run the query

StormEvents
| where State == "kansas"
| count
Count
0

Run the query

StormEvents
| where State == "KANSAS"
| count
Count
3,166