Anda dapat mengonfigurasi kolom tampilan default untuk menentukan bidang dalam skema aplikasi yang perlu diambil dan dikembalikan pada setiap permintaan pencarian. Gunakan parameter fetch_fields guna menentukan hanya bidang yang dibutuhkan oleh aplikasi Anda untuk ditampilkan.
Cara kerja
Dua lapisan konfigurasi mengontrol bidang mana yang dikembalikan:
| Lapisan | Kapan berlaku |
|---|---|
| Default Konsol | Tidak ada nilai fetch_fields yang diteruskan dalam permintaan |
SDK/API fetch_fields | Nilai diteruskan saat kueri — menggantikan default konsol |
Mengatur kolom tampilan default di Konsol
Masuk ke Konsol OpenSearch. Di panel navigasi sebelah kiri, pilih Feature Extensions > Search Result Display.
Di bagian Default Display Fields, tambahkan bidang yang akan dikembalikan.
Pada bagian Default Display Fields, klik ikon edit di ujung daftar bidang untuk menambah atau mengubah kolom tampilan.
Jika Anda belum mengatur kolom tampilan default di konsol, Anda juga dapat menambahkannya selama pengujian pencarian untuk suatu aplikasi.
Catatan: Pisahkan beberapa nilai bidang dengan titik koma (;).
Di halaman pengujian pencarian, pada area parameter, gunakan parameter fetch_fields untuk menentukan bidang yang akan dikembalikan. Misalnya, fetch_fields=buy,cate_id,title hanya mengembalikan bidang buy, cate_id, dan title.
Mengganti kolom tampilan saat kueri
Menyertakan parameter fetch_fields dalam panggilan SDK atau permintaan API akan menggantikan pengaturan default konsol untuk permintaan tersebut. Tentukan hanya bidang yang dibutuhkan oleh klien Anda—ukuran data teks yang dikembalikan berdampak signifikan terhadap performa pencarian.
Parameter API: Lihat Initiate search requests untuk informasi tentang cara menggunakan parameter fetch_fields dalam panggilan API.
SDK untuk Java: Contoh berikut menentukan bidang yang akan dikembalikan.
// Tentukan bidang yang akan dikembalikan dalam hasil pencarian.
config.setFetchFields(Lists.newArrayList("id", "name", "phone", "int_arr", "literal_arr", "float_arr", "cate_id"));Batasan
Skema multi-tabel JOIN: Bidang kunci primer pada tabel secondary tidak dapat diatur sebagai kolom tampilan default. Untuk menyertakan nilai kunci primer tabel secondary dalam hasil pencarian, gunakan bidang terkait di tabel primary sebagai gantinya.
Sebagai contoh, jika tabel primary p_table memiliki kunci primer id dan tabel secondary s_table_1 memiliki kunci primer id_1, menentukan fetch_fields=id_1 dalam pengujian pencarian tidak akan mengembalikan nilai kunci primer tabel secondary tersebut. Menentukan fetch_fields=id (bidang terkait di tabel primary) akan menghasilkan hasil yang diharapkan.