contains 運算子
適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
篩選包含不區分大小寫字串的數據記錄集。 contains 會搜尋任意子字串，而不是 字詞。
下表使用提供的縮寫來比較 contains 運算子：
- RHS = 表達式右側
- LHS = 表達式左側
| Operator | 描述 | 區分大小寫 | 範例 （yields true） |
|---|---|---|---|
contains |
RHS 會以 LHS 的子序列發生 | No | "FabriKam" contains "BRik" |
!contains |
RHS 不會發生在 LHS 中 | No | "Fabrikam" !contains "xyz" |
contains_cs |
RHS 會以 LHS 的子序列發生 | Yes | "FabriKam" contains_cs "Kam" |
!contains_cs |
RHS 不會發生在 LHS 中 | Yes | "Fabrikam" !contains_cs "Kam" |
如需其他運算符的詳細資訊，以及判斷哪一個運算元最適合您的查詢，請參閱 數據類型字串運算元。
效能祕訣
注意
效能取決於搜尋類型和數據結構。 如需最佳做法，請參閱 查詢最佳做法。
可能的話，請使用 contains_cs - 區分大小寫的運算符版本。
語法
T where | col 字串 contains_cs ()
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| T | string |
✔️ | 要篩選其記錄的表格式輸入。 |
| col | string |
✔️ | 要檢查 字串的數據行名稱。 |
| string | string |
✔️ | 篩選數據所依據的區分大小寫字串。 |
傳回
T 中的數據列，字串在 col 中。
範例
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
輸出
| 州/省 | event_count |
|---|---|
| 賓夕法尼亞州 | 1,687 |
| 田納西州 | 1125 |