Share via

Membuat Filter Kueri

  • Artikel

Filter kueri menginstruksikan Active Directory Domain Services untuk menemukan data dalam sintaks kueri LDAP. Semua teknologi akses data yang ditentukan yang tercantum dalam topik Memilih Teknologi Pencarian mendukung sintaks kueri LDAP.

Sintaks kueri LDAP adalah sebagai berikut:

<expression><expression>...

Filter dapat berisi satu, atau beberapa, ekspresi. Ekspresi memiliki formulir berikut:

(<logicaloperator><comparison><comparison...>)

di mana "<logicaloperator>" adalah salah satu hal berikut.

Operator Deskripsi
"|"
 LOGIS ATAU
"&"
 LOGIS AND
"!"
 LOGIS NOT

dan "<perbandingan>" adalah sebagai berikut:

(<attribute><operator><value>)

di mana "<atribut" adalah lDAPDisplayName dari atribut untuk dievaluasi, "<nilai>" adalah nilai untuk dibandingkan, dan "<operator>" adalah salah satu operator perbandingan> berikut.

Operator Deskripsi
"="
 Sama dengan
"~="
 Kira-kira sama dengan
"<="
 Kurang dari atau sama dengan
">="
 Lebih dari atau sama dengan

Selain itu, tergantung pada sintaks atribut, "<nilai>" mungkin berisi simbol kartubebas ("*"). "<Nilai>" yang hanya berisi kartubebas akan memeriksa keberadaan nilai apa pun dalam "<atribut>". Jika tidak ada nilai yang diatur untuk "<atribut>", pengujian akan gagal.

Jika salah satu karakter khusus berikut harus muncul di filter kueri sebagai harfiah, karakter tersebut harus digantikan oleh urutan escape yang tercantum.

Karakter ASCII Pengganti urutan escape
*
 "\2a"
(
 "\28"
)
 "\29"
\
 "\5c"
NUL
 "\00"

Selain itu, data biner arbitrer dapat diwakili menggunakan sintaks urutan escape dengan mengodekan setiap byte data biner dengan garis miring terbalik diikuti oleh dua digit heksadesimal. Misalnya, nilai empat byte 0x00000004 dikodekan sebagai "\00\00\00\04" dalam string filter.

Contoh

String kueri berikut akan mencari semua objek jenis "komputer".

(objectCategory=computer)

String kueri berikut akan mencari semua objek jenis "komputer" dengan nama yang dimulai dengan "desktop".

(&(objectCategory=computer)(name=desktop*))

String kueri berikut akan mencari semua objek jenis "komputer" dengan nama yang dimulai dengan "desktop" atau nama yang dimulai dengan "notebook".

(&(objectCategory=computer)(|(name=desktop*)(name=notebook*)))

String kueri berikut akan mencari semua objek jenis "pengguna" yang memiliki nomor telepon rumah.

(&(objectCategory=user)(homePhone=*))

Untuk informasi selengkapnya tentang string filter kueri, dan contoh penggunaan, lihat: