Operatore contains

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 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

Eseguire la query

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