Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Filter struktur ekspresi dan elemen
<a name="creating-filter-expressions"></a>

Bagian ini mencakup informasi tentang struktur ekspresi filter dan elemennya.

**Topics**
+ [Struktur ekspresi filter](#filter-expression-structure)
+ [Filter elemen ekspresi](#filter-expression-elements)

## Struktur ekspresi filter
<a name="filter-expression-structure"></a>

Struktur umum ekspresi filter adalah sebagai berikut: 

```
EXCLUDE/INCLUDE ItemID/ActionID/UserID WHERE dataset type.field IN/NOT IN (value/parameter)
```

Anda dapat membuat ekspresi filter secara manual atau mendapatkan bantuan dengan sintaks dan struktur [ekspresi dengan menggunakan pembuat Ekspresi](filter-real-time.md#using-filter-expression-builder) di konsol. 

## Filter elemen ekspresi
<a name="filter-expression-elements"></a>

Gunakan elemen berikut untuk membuat ekspresi filter:

**TERMASUK atau MENGECUALIKAN**  
Gunakan `INCLUDE` untuk membatasi rekomendasi hanya item yang memenuhi kriteria filter *ATAU* gunakan `EXCLUDE` untuk menghapus semua item yang memenuhi kriteria filter.

**ItemID/ActionID/UserID**  
Gunakan salah satu elemen ini setelah `EXCLUDE` elemen `INCLUDE` atau. Elemen yang Anda gunakan bergantung pada apakah Anda memfilter item (untuk rekomendasi item), tindakan (untuk rekomendasi tindakan), atau pengguna (untuk segmen pengguna). 

**WHERE**  
Gunakan `WHERE` untuk memeriksa kondisi untuk item, tindakan, atau pengguna. Anda harus menggunakan `WHERE` elemen setelah`ItemID`,`ActionID`, atau`UserID`. 

**DAN/ATAU**  
Untuk menghubungkan beberapa kondisi bersama-sama dalam ekspresi filter yang sama, gunakan `AND` atau`OR`. Kondisi dirantai bersama menggunakan `AND` atau hanya `OR` dapat memengaruhi bidang kumpulan data yang digunakan dalam kondisi pertama.

**Dataset.field**  
Berikan kumpulan data dan bidang metadata yang ingin Anda filter rekomendasi di. `dataset` `field`format. Misalnya, untuk memfilter rekomendasi item berdasarkan bidang genre di kumpulan data Item Anda, Anda akan menggunakan Items.genres dalam ekspresi filter Anda. 

**Kondisi IF**  
Gunakan `IF` kondisi *hanya* untuk memeriksa kondisi untuk `CurrentUser` dan hanya *sekali* di akhir ekspresi. Namun, Anda dapat memperpanjang `IF` kondisi menggunakan`AND`. 

**CurrentUser.atribut**  
 Untuk memfilter rekomendasi item berdasarkan pengguna yang Anda dapatkan rekomendasinya, *hanya* dalam kondisi IF, gunakan `CurrentUser` dan berikan bidang pengguna. Misalnya, `CurrentUser.AGE`. 

**CurrentItem.atribut**  
 Hanya untuk item terkait resep dan kasus penggunaan, gunakan`CurrentItem`. `attribute`untuk memfilter item berdasarkan atribut item yang Anda tentukan dalam permintaan Anda untuk rekomendasi item terkait. Misalnya, `CurrentItem.GENRE` atau `CurrentItem.PRICE`.   
 Anda dapat menerapkan filter dengan CurrentItem elemen hanya jika kasus penggunaan domain atau resep khusus Anda menghasilkan rekomendasi item terkait, seperti resep Item Serupa atau kasus penggunaan domain *More Like X*. Pertama kali Anda membuat filter dengan `CurrentItem` elemen, pembuatan filter bisa beberapa menit. Jika Anda menggunakan AWS KMS enkripsi, pembuatan filter dapat memakan waktu hingga 15 menit. 

**DALAM/TIDAK DI**  
Gunakan `IN` atau `NOT IN` sebagai operator perbandingan untuk memfilter berdasarkan pencocokan (atau tidak cocok) satu atau lebih nilai string. Amazon Personalisasi filter hanya pada string yang tepat.

**Operator perbandingan**  
Gunakan =, <, <=, >, >=, dan\$1 = operator untuk menguji data numerik, termasuk data yang diteruskan dalam parameter placeholder, untuk kesetaraan.

**Karakter tanda bintang (\$1)**  
Gunakan `*` untuk memasukkan atau mengecualikan interaksi dari semua jenis. Gunakan `*` *hanya* untuk ekspresi filter yang menggunakan `EVENT_TYPE` bidang `Interactions` dataset.

**Pemisah pipa**  
Gunakan pemisah pipa (`|`) untuk menyatukan beberapa ekspresi. Untuk informasi selengkapnya, lihat [Menggabungkan beberapa ekspresi](multiple-expression-example.md).

**Parameter**  
Untuk ekspresi yang menggunakan operator perbandingan atau `IN` operator, gunakan tanda dolar (\$1) dan nama parameter untuk menambahkan parameter placeholder sebagai nilai. Misalnya, `$GENRES`. Misalnya, ketika Anda mendapatkan rekomendasi, Anda menyediakan genre atau genre untuk difilter.  
Anda menentukan nama parameter saat Anda menambahkannya ke ekspresi. Nama parameter tidak harus cocok dengan nama bidang. Kami menyarankan Anda menggunakan nama parameter yang mirip dengan nama bidang dan mudah diingat. Anda menggunakan nama parameter (peka huruf besar/kecil) saat menerapkan filter ke permintaan rekomendasi. Untuk contoh yang menunjukkan cara menerapkan filter dengan parameter placeholder saat menggunakan AWS SDKS, lihat. [Menerapkan filter (AWS SDKs)](filter-real-time.md#applying-filter-sdk)