operador contains
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Filtra um conjunto de registros para dados que contêm uma cadeia de caracteres que não diferencia maiúsculas de minúsculas. contains pesquisa substrings arbitrárias em vez de termos.
A tabela a seguir compara os contains operadores usando as abreviações fornecidas:
- RHS = lado direito da expressão
- LHS = lado esquerdo da expressão
| Operador | Descrição | Diferencia maiúsculas de minúsculas | Exemplo (suspende true) |
|---|---|---|---|
contains |
RHS ocorre como uma subsequência do LHS | Não | "FabriKam" contains "BRik" |
!contains |
RHS não ocorre em LHS | Não | "Fabrikam" !contains "xyz" |
contains_cs |
RHS ocorre como uma subsequência do LHS | Sim | "FabriKam" contains_cs "Kam" |
!contains_cs |
RHS não ocorre em LHS | Sim | "Fabrikam" !contains_cs "Kam" |
Para obter mais informações sobre outros operadores e determinar qual operador é mais apropriado para sua consulta, consulte operadores de cadeia de caracteres de tipo de dados.
Dicas de desempenho
Observação
O desempenho depende do tipo de pesquisa e da estrutura dos dados. Para obter as práticas recomendadas, consulte Práticas recomendadas de consulta.
Quando possível, use contains_cs - uma versão do operador que diferencia maiúsculas de minúsculas.
Se você estiver procurando por um termo, use has para obter resultados mais rápidos.
Sintaxe
T | where col string contains_cs ()
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| T | string |
✔️ | a entrada tabular cujos registros serão filtrados. |
| col | string |
✔️ | O nome da coluna a ser verificada em busca de cadeia de caracteres. |
| cadeia de caracteres | string |
✔️ | A cadeia de caracteres que diferencia maiúsculas de minúsculas pela qual filtrar os dados. |
Devoluções
Linhas em T para as quais a cadeia de caracteres está na col.
Exemplo
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
Saída
| Estado | event_count |
|---|---|
| Pensilvânia | 1,687 |
| TENNESSEE | 1125 |