no operador

Filtra um conjunto de registos para dados com uma cadeia sensível a maiúsculas e minúsculas.

A tabela seguinte fornece uma comparação dos in operadores:

Operador	Descrição	Case-Sensitive	Exemplo (rendimentos true)
in	É igual a um dos elementos	Yes	"abc" in ("123", "345", "abc")
!in	Não é igual a nenhum dos elementos	Yes	"bca" !in ("123", "345", "abc")
in~	É igual a qualquer um dos elementos	No	"Abc" in~ ("123", "345", "abc")
!in~	Não é igual a nenhum dos elementos	No	"bCa" !in~ ("123", "345", "ABC")

Nota

As matrizes aninhadas são achatadas numa única lista de valores. Por exemplo, x in (dynamic([1,[2,3]])) torna-se x in (1,2,3).

Para obter mais informações sobre outros operadores e determinar qual o operador mais adequado para a consulta, veja operadores de cadeias de tipo de dados.

Atualmente, os operadores não sensíveis a maiúsculas e minúsculas são atualmente suportados apenas para texto ASCII. Para comparação não ASCII, utilize a função tolower( ).

Sugestões de desempenho

Nota

O desempenho depende do tipo de pesquisa e da estrutura dos dados. Para melhores práticas, veja Melhores práticas de consulta.

Syntax

T|wherecolin(expressão, ... )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
T	string	✔️	A entrada tabular a filtrar.
col	string	✔️	A coluna pela qual filtrar.
expression	escalar ou tabular	✔️	Uma expressão que especifica os valores para os quais deve procurar. os valores para os quais procurar. Cada expressão pode ser um valor escalar ou uma expressão tabular que produz um conjunto de valores. Se uma expressão tabular tiver múltiplas colunas, é utilizada a primeira coluna. A pesquisa considerará até 1000 000 valores distintos.

Nota

Uma expressão tabular inline tem de estar entre parênteses duplos. Veja o exemplo.

Devoluções

Linhas em T para as quais o predicado é true.

Exemplos

Lista de escalares

A seguinte consulta mostra como utilizar in com uma lista de valores escalares.

Executar a consulta

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

Saída

de palavras
4775

Matriz dinâmica

A seguinte consulta mostra como utilizar in com uma matriz dinâmica.

Executar a consulta

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

Saída

de palavras
3218

Expressão tabular

A seguinte consulta mostra como utilizar in com uma expressão tabular.

Executar a consulta

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

A mesma consulta pode ser escrita com uma instrução de expressão tabular inline.

Executar a consulta

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

Saída

de palavras
14242

Top com outro exemplo

Executar a 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 

Saída

Estado	sum_lightning_events
ALABAMA	29
WISCONSIN	31
TEXAS	55
FLORIDA	85
GEÓRGIA	106
Outro	415

Utilizar uma lista estática devolvida por uma função

Executar a consulta

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

Saída

de palavras
4775

A definição da função.

Executar a consulta

.show function InterestingStates

Saída

Name	Parâmetros	Corpo	Pasta	DocString
InterestingStates	()	{ dynamic(["WASHINGTON", "FLORIDA", "GEORGIA", "NEW YORK"]) }