contains, operator
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Filtruje zestaw rekordów dla danych zawierających ciąg bez uwzględniania wielkości liter. contains wyszukuje dowolne podciągy, a nie terminy.
Poniższa tabela porównuje operatory contains przy użyciu podanych skrótów:
- RHS = prawa strona wyrażenia
- LHS = lewa strona wyrażenia
| Operator | opis | Uwzględniana wielkość liter | Przykład (plony true) |
|---|---|---|---|
contains |
RhS występuje jako podsekwencja LHS | Nie. | "FabriKam" contains "BRik" |
!contains |
RhS nie występuje w LHS | Nie. | "Fabrikam" !contains "xyz" |
contains_cs |
RhS występuje jako podsekwencja LHS | Tak | "FabriKam" contains_cs "Kam" |
!contains_cs |
RhS nie występuje w LHS | Tak | "Fabrikam" !contains_cs "Kam" |
Aby uzyskać więcej informacji na temat innych operatorów i określić, który operator jest najbardziej odpowiedni dla zapytania, zobacz operatory ciągów typu danych.
Wskazówki dotyczące wydajności
Uwaga
Wydajność zależy od typu wyszukiwania i struktury danych. Aby uzyskać najlepsze rozwiązania, zobacz Najlepsze rozwiązania dotyczące zapytań.
Jeśli to możliwe, użyj contains_cs — wersji operatora z uwzględnieniem wielkości liter.
Jeśli szukasz terminu, użyj go has , aby uzyskać szybsze wyniki.
Składnia
Ciąg kolumny T | where contains_cs ()
Dowiedz się więcej na temat konwencji składni.
Parametry
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| T | string |
✔️ | Dane wejściowe tabelaryczne, których rekordy mają być filtrowane. |
| Col | string |
✔️ | Nazwa kolumny, która ma być sprawdzana pod kątem ciągu. |
| string | string |
✔️ | Ciąg uwzględniający wielkość liter, za pomocą którego mają być filtrowane dane. |
Zwraca
Wiersze w języku T, dla których ciąg znajduje się w kolumnie.
Przykład
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
Wyjście
| Stan | event_count |
|---|---|
| PENNSYLVANIA | 1687 |
| TENNESSEE | 1125 |