Operador contains
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Filtra un conjunto de registros para los datos que contienen una cadena que no distingue mayúsculas de minúsculas. contains busca subcadeas arbitrarias en lugar de términos.
En la tabla siguiente se comparan los contains operadores con las abreviaturas proporcionadas:
- RHS = lado derecho de la expresión
- LHS = lado izquierdo de la expresión
| Operator | Descripción | Distingue mayúsculas de minúsculas | Ejemplo (produce true) |
|---|---|---|---|
contains |
RHS ocurre como una subsecuencia de LHS | No | "FabriKam" contains "BRik" |
!contains |
RHS no se produce en LHS | No | "Fabrikam" !contains "xyz" |
contains_cs |
RHS ocurre como una subsecuencia de LHS | Sí | "FabriKam" contains_cs "Kam" |
!contains_cs |
RHS no se produce en LHS | Sí | "Fabrikam" !contains_cs "Kam" |
Para obtener más información sobre otros operadores y determinar qué operador es más adecuado para la consulta, consulte operadores de cadena de tipo de datos.
Consejos de rendimiento
Nota:
El rendimiento depende del tipo de búsqueda y de la estructura de los datos. Para conocer los procedimientos recomendados, consulte Procedimientos recomendados de consulta.
Cuando sea posible, use contains_cs : una versión que distingue mayúsculas de minúsculas del operador.
Si busca un término, use has para obtener resultados más rápidos.
Sintaxis
T | where col string contains_cs ()
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| T | string |
✔️ | la entrada tabular cuyos registros se van a filtrar. |
| col | string |
✔️ | Nombre de la columna que se va a comprobar si hay una cadena. |
| string | string |
✔️ | Cadena que distingue mayúsculas de minúsculas por la que se filtran los datos. |
Devoluciones
Filas de T para las que la cadena está en col.
Ejemplo
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
Salida
| Valor | event_count |
|---|---|
| PENSILVANIA | 1,687 |
| TENNESSEE | 1125 |