in (operador)

Filtra un conjunto de registros para los datos con una cadena que distingue mayúsculas de minúsculas.

En la tabla siguiente se proporciona una comparación de los in operadores:

Operador	Descripción	Distingue mayúsculas de minúsculas	Ejemplo (produce true)
in	Igual a uno de los elementos	Sí	"abc" in ("123", "345", "abc")
!in	No es igual a uno de los elementos	Sí	"bca" !in ("123", "345", "abc")
in~	Es igual a cualquiera de los elementos	No	"Abc" in~ ("123", "345", "abc")
!in~	No es igual a uno de los elementos	No	"bCa" !in~ ("123", "345", "ABC")

Nota

Las matrices anidadas se aplanan en una sola lista de valores. Por ejemplo, x in (dynamic([1,[2,3]])) se convierte en x in (1,2,3).

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.

Los operadores que no distinguen mayúsculas de minúsculas solo se admiten actualmente para texto ASCII. Para la comparación no ASCII, utilice la función tolower().

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.

Syntax

T|wherecolin(Expresión, ... )

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

Parámetros

Nombre	Tipo	Requerido	Descripción
T	string	✔️	Entrada tabular que se va a filtrar.
col	string	✔️	Columna por la que se va a filtrar.
expression	escalar o tabular	✔️	Expresión que especifica los valores para los que se va a buscar. los valores para los que se va a buscar. Cada expresión puede ser un valor escalar o una expresión tabular que genera un conjunto de valores. Si una expresión tabular tiene varias columnas, se usa la primera columna. La búsqueda tendrá en cuenta hasta 1000 000 valores distintos.

Nota

Una expresión tabular insertada debe ir entre paréntesis dobles. Vea el ejemplo.

Devoluciones

Las filas de T en las que el predicado es true.

Ejemplos

Lista de escalares

En la consulta siguiente se muestra cómo usar in con una lista de valores escalares.

Ejecución de la consulta

StormEvents 
| where State in ("FLORIDA", "GEORGIA", "NEW YORK") 
| count

Salida

Count
4775

Matriz dinámica

En la consulta siguiente se muestra cómo usar in con una matriz dinámica.

Ejecución de la consulta

let states = dynamic(['FLORIDA', 'ATLANTIC SOUTH', 'GEORGIA']);
StormEvents 
| where State in (states)
| count

Salida

Count
3218

Expresión tabular

En la consulta siguiente se muestra cómo usar in con una expresión tabular.

Ejecución de la consulta

let Top_5_States = 
    StormEvents
    | summarize count() by State
    | top 5 by count_; 
StormEvents 
| where State in (Top_5_States) 
| count

La misma consulta se puede escribir con una instrucción de expresión tabular insertada.

Ejecución de la consulta

StormEvents 
| where State in (
    StormEvents
    | summarize count() by State
    | top 5 by count_
    ) 
| count

Salida

Count
14242

Los primeros con otro ejemplo

Ejecución de la consulta

let Lightning_By_State = materialize(StormEvents
    | summarize lightning_events = countif(EventType == 'Lightning') by State);
let Top_5_States = Lightning_By_State | top 5 by lightning_events | project State; 
Lightning_By_State
| extend State = iff(State in (Top_5_States), State, "Other")
| summarize sum(lightning_events) by State 

Salida

State	sum_lightning_events
ALABAMA	29
WISCONSIN	31
TEXAS	55
FLORIDA	85
GEORGIA	106
Otros	415

Uso de una lista estática devuelta por una función

Ejecución de la consulta

StormEvents 
| where State in (InterestingStates()) 
| count

Salida

Count
4775

Definición de la función.

Ejecución de la consulta

.show function InterestingStates

Salida

Nombre	Parámetros	Cuerpo	Carpeta	DocString
InterestingStates	()	{ dynamic(["WASHINGTON", "FLORIDA", "GEORGIA", "NEW YORK"]) }