All Products
Search
Document Center

ApsaraDB for HBase:Perbarui set konfigurasi

Last Updated:Mar 29, 2026

Set konfigurasi mendefinisikan skema dan pengaturan Solr untuk sebuah koleksi dalam layanan Search. Topik ini menjelaskan cara mengunduh set konfigurasi default, menyesuaikan skema, dan mengunggah set konfigurasi Anda sendiri.

Prasyarat

Sebelum memulai, pastikan Anda telah:

Unduh set konfigurasi default

Layanan Search menyediakan set konfigurasi bawaan bernama _indexer_default. Unduh set tersebut sebagai titik awal sebelum melakukan penyesuaian.

Jalankan perintah berikut di HBase Shell:

cd alisolr-7.3.8-bin/bin
./solr zk ls /configs                              # Daftar set konfigurasi yang ada
./solr zk downconfig -d . -n _indexer_default      # Unduh _indexer_default ke direktori saat ini

Parameter untuk ./solr zk downconfig:

ParameterWajibDeskripsiContoh
-dYaDirektori lokal tempat menulis set konfigurasi yang diunduh. (direktori saat ini)
-nYaNama set konfigurasi di ZooKeeper yang akan diunduh_indexer_default

Setelah pengunduhan selesai, direktori conf dibuat di direktori saat ini dan berisi dua file:

  • managed-schema — mendefinisikan bidang dan tipe bidang untuk indeks Anda

  • solrconfig.xml — mengonfigurasi penanganan permintaan Solr dan pengaturan lainnya

Definisikan bidang dalam skema

Buka file managed-schema untuk menambahkan definisi bidang bagi indeks Anda.

Definisikan bidang eksplisit

Tambahkan elemen <field> untuk setiap kolom yang ingin diindeks:

<field name="name" type="string" indexed="true" stored="true" required="false" multiValued="false" />
<field name="age" type="pint" indexed="true" stored="true" docValues="true"  multiValued="false" />

Atribut utama:

AtributDeskripsiNilai contoh
typeTipe bidang. pint dipetakan ke INT, plong dipetakan ke LONG.string, pint, plong
indexedJika true, bidang dapat dicari.true, false
storedJika true, nilai asli disimpan dan dikembalikan dalam hasil kueri.true, false
docValuesJika true, mengaktifkan pengurutan dan faceting pada bidang tersebut.true, false
multiValuedJika true, bidang menerima beberapa nilai per dokumen.true, false

Gunakan dynamicField untuk skema fleksibel (disarankan)

Jika data Anda memiliki banyak kolom atau nama kolom tidak ditentukan sebelumnya, gunakan dynamicField alih-alih mendefinisikan setiap bidang secara eksplisit. dynamicField mencocokkan bidang berdasarkan akhiran nama—bidang apa pun yang namanya diakhiri dengan akhiran yang ditentukan secara otomatis mewarisi tipe dan atribut yang sesuai.

File managed-schema sudah mencakup definisi dynamicField default. Saat menulis data, gunakan nama bidang yang cocok dengan akhiran tertentu:

  • name_s secara otomatis cocok dengan *_s dan diperlakukan sebagai bidang string

  • age_i secara otomatis cocok dengan *_i dan diperlakukan sebagai bidang pint (INT)

Pendekatan ini menghindari pengeditan berulang pada file managed-schema saat skema Anda berkembang.

Unggah set konfigurasi

Setelah memodifikasi file managed-schema, unggah set konfigurasi tersebut ke ZooKeeper dengan nama baru. Gunakan satu set konfigurasi untuk setiap koleksi.

./solr zk upconfig -d conf/ -n myconf
ParameterWajibDeskripsiContoh
-dYaPath ke direktori set konfigurasi lokalconf/
-nYaNama yang akan diberikan kepada set konfigurasi di ZooKeepermyconf

Untuk memverifikasi unggahan, buka Konsol Web Solr dan pastikan bahwa myconf muncul dalam daftar set konfigurasi.

myconf

Praktik terbaik

  • Gunakan dynamicField jika memungkinkan. Mendefinisikan bidang dengan akhiran dynamicField menghindari perubahan berulang pada file managed-schema dan menyederhanakan manajemen skema.

  • Satu set konfigurasi per koleksi. Jangan berbagi satu set konfigurasi untuk beberapa indeks, karena perubahan pada skema akan memengaruhi semua koleksi yang menggunakannya.

  • Mulai dari _indexer_default. Selalu unduh dan modifikasi set konfigurasi default alih-alih membuatnya dari awal.