Compartir a través de

Operador in

  • Artículo

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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:

Operator 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:

Cuando se usan más de 128 términos de búsqueda, la optimización de búsqueda de índices de texto está deshabilitada, lo que podría provocar una reducción del rendimiento de las consultas.

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.

Sintaxis

Expresión T|wherecol ...in(,)

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

Parámetros

Nombre Type Obligatorio 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. 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 tiene en cuenta hasta 1000 000 valores distintos.

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.

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.

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.

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.

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

Salida

Count
14242

Los primeros con otro ejemplo

En el ejemplo siguiente se identifican los cinco estados principales con eventos de rayo y se usa la función iff() y in operador para clasificar los eventos de rayo por los cinco estados principales, etiquetados por nombre de estado y todos los demás etiquetados como "Otros".

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

Valor 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

En el ejemplo siguiente se cuentan los eventos de la tabla StormEvents en función de una lista predefinida de estados interesantes. Los estados interesantes se definen mediante la función InterestingStates().

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

Salida

Count
4775

En la consulta siguiente se muestran los estados que la función InterestingStates() considera interesantes.

.show function InterestingStates

Salida

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

Contenido relacionado