operador !contains
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Filtra um conjunto de registros para dados que não incluem uma cadeia de caracteres que diferencia maiúsculas de minúsculas. !contains
pesquisa caracteres em vez de termos de três ou mais caracteres. A consulta verifica os valores na coluna, o que é mais lento do que pesquisar um termo em um índice 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 o !contains_cs que diferencia maiúsculas de minúsculas.
Use !has
se você estiver procurando por um termo.
Sintaxe
Sintaxe que não diferencia maiúsculas de minúsculas
Expressão de coluna T |
where
!contains
(
)
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. |
Coluna | string |
✔️ | A coluna pela qual filtrar. |
Expressão | scalar | ✔️ | A expressão escalar ou literal para a qual pesquisar. |
Devoluções
As linhas em T para as quais o predicado é true
.
Exemplo
StormEvents
| summarize event_count=count() by State
| where State !contains "kan"
| where event_count > 3000
| project State, event_count
Saída
Estado | event_count |
---|---|
TEXAS | 4701 |