Contribute in GitHub:
Edit online
contains_cs operator
Filters a record set for data containing a case-sensitive string. contains searches for characters rather than terms of three or more characters. The query scans the values
in the column, which is slower than looking up a term in a term index.
The following table provides a comparison of the contains operators:
| Operator | Description | Case-Sensitive | Example (yields true) |
|---|---|---|---|
contains |
RHS occurs as a subsequence of LHS | No | "Success Audit" contains "audit" |
!contains |
RHS doesn't occur in LHS | No | "Success Audit" !contains "auditing" |
contains_cs |
RHS occurs as a subsequence of LHS | Yes | "Success Audit" contains_cs "Audit" |
!contains_cs |
RHS doesn't occur in LHS | Yes | "Success Audit !contains_cs "auD" |
The following abbreviations are used in the table above:
- RHS = right hand side of the expression
- LHS = left hand side of the expression
For further 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 faster results, use the case-sensitive version of an operator, for example, contains_cs, not contains.
If you're testing for the presence of a symbol or alphanumeric word that is bound by non-alphanumeric characters at the start or end of a field, for faster results use has or in. Also, has works faster
than contains, startswith, or endswith, however it is not as precise and could provide unwanted records.
Syntax
T | where col contains_cs (expression)
Arguments
- T - The tabular input whose records are to be filtered.
- col - The column to filter.
- expression - Scalar or literal expression.
Returns
Rows in T for which the predicate is true.
Example
events
| project original_time, data_source_name, name
//--- Search for the last 5 mins of data
| where original_time > now(-5m)
// Look for events successful with case sensitivity
| where name contains_cs "Success"
| take 2
Results
| original_time | data_source_name | name |
|---|---|---|
| 2023-04-13T14:48:39.009Z | microsoftWindowsSource4 | Success Audit: Auditing settings on object were changed |
| 2023-04-13T14:48:39.009Z | microsoftWindowsSource4 | Success Audit: The Windows Firewall Service has started successfully |