operator in

Memfilter kumpulan catatan untuk data dengan string peka huruf besar/kecil.

Tabel berikut memberikan perbandingan dari operator in:

Operator	Deskripsi	Peka Huruf Besar/Kecil	Contoh (menangguhkan true)
in	Sama dengan salah satu elemen	Ya	"abc" in ("123", "345", "abc")
!in	Tidak sama dengan satu pun elemen	Ya	"bca" !in ("123", "345", "abc")
in~	Sama dengan salah satu elemen	Tidak	"Abc" in~ ("123", "345", "abc")
!in~	Tidak sama dengan satu pun elemen	Tidak	"bCa" !in~ ("123", "345", "ABC")

Catatan

Larik bersarang diratakan menjadi satu daftar nilai. Misalnya, x in (dynamic([1,[2,3]])) menjadi x in (1,2,3).

Untuk informasi lebih lanjut tentang operator lain dan untuk menentukan operator mana yang paling sesuai untuk kueri Anda, lihat operator string datatype.

Operator yang tidak peka huruf besar/kecil saat ini hanya didukung untuk teks ASCII. Untuk perbandingan non-ASCII, gunakan fungsi tolower().

Tips performa

Catatan

Performa tergantung pada jenis pencarian dan struktur data. Untuk praktik terbaik, lihat Praktik terbaik kueri.

Sintaks

T|whereKolosein(Ekspresi, ... )

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama	Jenis	Diperlukan	Deskripsi
T	string	✔️	Input tabular untuk difilter.
Kolose	string	✔️	Kolom yang akan difilter.
ekspresi	skalar atau tabular	✔️	Ekspresi yang menentukan nilai yang akan dicari. nilai yang akan dicari. Setiap ekspresi dapat berupa nilai skalar atau ekspresi tabular yang menghasilkan sekumpulan nilai. Jika ekspresi tabular memiliki beberapa kolom, kolom pertama akan digunakan. Pencarian akan mempertimbangkan hingga 1.000.000 nilai yang berbeda.

Catatan

Ekspresi tabular sebaris harus diapit dengan tanda kurung ganda. Lihat contoh.

Mengembalikan

Baris di T yang predikatnya adalah true.

Contoh

Daftar skalar

Kueri berikut ini memperlihatkan cara menggunakan in dengan daftar nilai skalar.

Menjalankan kueri

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

Output

Menghitung
4775

Dynamic array

Kueri berikut ini memperlihatkan cara menggunakan in dengan array dinamis.

Menjalankan kueri

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

Output

Menghitung
3218

Ekspresi tabular

Kueri berikut ini memperlihatkan cara menggunakan in dengan ekspresi tabular.

Menjalankan kueri

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

Kueri yang sama dapat ditulis dengan pernyataan ekspresi tabular sebaris.

Menjalankan kueri

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

Output

Menghitung
14242

Atas dengan contoh lain

Menjalankan kueri

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 

Output

Provinsi	sum_lightning_events
ALABAMA	29
WISCONSIN	31
TEXAS	55
FLORIDA	85
GEORGIA	106
Lainnya	415

Menggunakan daftar statis yang dikembalikan oleh suatu fungsi

Menjalankan kueri

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

Output

Menghitung
4775

Definisi fungsi.

Menjalankan kueri

.show function InterestingStates

Output

Nama	Parameter	Isi	Folder	DocString
InterestingStates	()	{ dynamic(["WASHINGTON", "FLORIDA", "GEORGIA", "NEW YORK"]) }