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

Operador	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|wherecol stringcontains_cs()

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	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.
cadena	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.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el contains operador .

Ejecución de la consulta

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