Operatore contains
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel
Filtra un set di record per i dati contenenti una stringa senza distinzione tra maiuscole e minuscole. contains cerca sotto stringhe arbitrarie anziché termini.
Nella tabella seguente vengono confrontati gli contains operatori usando le abbreviazioni fornite:
- RHS = lato destro dell'espressione
- LHS = lato sinistro dell'espressione
| Operatore | Descrizione | Distinzione maiuscole/minuscole | Esempio (restituisce true) |
|---|---|---|---|
contains |
RHS si verifica come sottosequenza di LHS | No | "FabriKam" contains "BRik" |
!contains |
RHS non si verifica in LHS | No | "Fabrikam" !contains "xyz" |
contains_cs |
RHS si verifica come sottosequenza di LHS | Sì | "FabriKam" contains_cs "Kam" |
!contains_cs |
RHS non si verifica in LHS | Sì | "Fabrikam" !contains_cs "Kam" |
Per altre informazioni sugli altri operatori e per determinare quale operatore è più appropriato per la query, vedere Operatori stringa tipo di dati.
Suggerimenti per incrementare le prestazioni
Nota
Le prestazioni dipendono dal tipo di ricerca e dalla struttura dei dati. Per le procedure consigliate, vedere Procedure consigliate per le query.
Quando possibile, usare contains_cs : una versione con distinzione tra maiuscole e minuscole dell'operatore.
Se si sta cercando un termine, usare has per ottenere risultati più rapidi.
Sintassi
Stringa T col contains_cs (| where )
Altre informazioni sulle convenzioni di sintassi.
Parametri
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| T | string |
✔️ | l'input tabulare di cui filtrare i record. |
| col | string |
✔️ | Nome della colonna da verificare per la stringa. |
| string | string |
✔️ | Stringa con distinzione tra maiuscole e minuscole in base alla quale filtrare i dati. |
Valori restituiti
Righe in T per cui la stringa è in confronto.
Esempio
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
Output
| Provincia | event_count |
|---|---|
| PENNSYLVANIA | 1687 |
| TENNESSEE | 1125 |