Tutorial ini memandu pengembang baru Alibaba Cloud Elasticsearch dalam membuat kluster dan mengambil data dalam waktu sekitar 45 menit, termasuk waktu tunggu sekitar 20 menit untuk pembuatan kluster.
Apa yang akan Anda pelajari
Membuat dan mengonfigurasi kluster Alibaba Cloud Elasticsearch.
Memodelkan data menggunakan Dev Tools di Kibana.
Kibana telah terintegrasi ke dalam Konsol Alibaba Cloud Elasticsearch dan tidak memerlukan instalasi manual.
Memasukkan data sampel dan melakukan berbagai operasi pencarian.
Setelah menyelesaikan tutorial ini, Anda akan mampu melakukan operasi dasar di Alibaba Cloud Elasticsearch, termasuk membuat indeks, membaca dan menulis data, serta melakukan pencarian.
Versi dan biaya
Sebelum memulai, tinjau informasi penting berikut untuk tutorial ini:
Jenis dan versi kluster: Vector Enhanced Edition 8.17.0.
Versi ini mendukung pencarian semantik dan membantu perusahaan membangun kemampuan Retrieval-Augmented Generation (RAG) dan pencarian multimodal dengan cepat.
Perkiraan biaya: Tutorial ini menggunakan metode penagihan pay-as-you-go. Jika Anda mengikuti spesifikasi dan durasi yang direkomendasikan secara ketat, total biaya diperkirakan kurang dari USD 5. Setelah menyelesaikan tutorial, segera rilis kluster untuk menghindari biaya tambahan.
Prasyarat
Daftar Akun Alibaba Cloud dan login. Pastikan akun tersebut memiliki izin untuk membuat dan mengelola sumber daya seperti Elasticsearch dan VPC.
Buat Virtual Private Cloud (VPC) dan vSwitch. Catat region dan zone VPC serta vSwitch Anda. Anda harus memilih region dan zone yang sama saat membuat kluster Elasticsearch. Jika tidak, kluster tidak dapat dikaitkan dengan VPC dan vSwitch tersebut.
Prosedur
Langkah 1: Buat kluster (sekitar 20 menit)
Buka halaman pembuatan kluster untuk membuat kluster. Konfigurasikan parameter utama seperti yang dijelaskan dalam tabel berikut. Anda dapat menggunakan nilai default untuk parameter lainnya.
Parameter
Deskripsi
Billing Method
Pilih pay-as-you-go. Anda dapat melepas kluster kapan saja.
Region dan Zone
region: Pilih wilayah tempat VPC dan vSwitch Anda berada.
zone: Untuk tutorial ini, pilih zona tunggal untuk mempercepat pembuatan kluster. Untuk lingkungan produksi, Anda dapat melakukan upgrade ke penerapan multi-zona.
Tutorial ini menggunakan China (Hangzhou) dan Zone I.
Network Type
Pilih VPC dan vSwitch yang telah Anda buat.
Cluster Type dan Elasticsearch Version
Pilih Vector Enhanced Edition 8.17.0. Tutorial ini didasarkan pada versi ini.
Data Node Specifications
CPU Type: Intel 2-core 4 GiB.
Jenis dan ukuran penyimpanan node data: Standard SSD, storage space 20 GiB per node.
Jumlah node data: 2.
Node data menyimpan data indeks dan digunakan untuk operasi seperti membuat, mengambil, memperbarui, menghapus, dan mengagregasi dokumen.
ES_test
Password
Buat password kustom. Anda akan menggunakannya nanti untuk login ke Kibana guna membuat indeks dan menjelajahi data.
Klik Buy Now dan tunggu sekitar 20 menit hingga status kluster berubah menjadi Active sebelum melanjutkan ke langkah berikutnya.
Langkah 2: Konfigurasikan dan login ke Kibana
Akses publik ke Kibana diaktifkan secara default. Untuk alasan keamanan, akses dari semua alamat IP ditolak secara default. Anda harus menambahkan alamat IP perangkat Anda ke daftar putih akses publik agar dapat mengakses Kibana.
Pertama, login ke Akun Alibaba Cloud Anda. Kemudian, masukkan kredensial untuk kluster Elasticsearch. Username adalah elastic dan password adalah yang Anda buat saat pengaturan.
Di panel navigasi sebelah kiri, klik Data Visualization. Di bagian Kibana, klik Modify Configuration.
Di bagian Network Access Configuration, ubah daftar putih akses publik Kibana.
Dapatkan IP perangkat
Anda dapat memperoleh alamat IP perangkat Anda berdasarkan skenario berikut.
Skenario
Alamat IP
Metode
Akses Kibana dari mesin lokal melalui Internet.
Alamat IP publik mesin lokal Anda.
CatatanJika mesin lokal Anda berada di jaringan rumahan atau jaringan area lokal (LAN) perusahaan, Anda harus menambahkan alamat IP egress publik LAN tersebut.
Jalankan perintah
curl ipinfo.io/ipuntuk menanyakan alamat IP publik mesin lokal Anda.Akses Kibana dari Instance ECS melalui Internet.
Jika Instance ECS dan kluster Elasticsearch berada di VPC yang berbeda, Anda dapat mengakses Kibana menggunakan alamat IP publik Instance ECS tersebut. Untuk melakukannya, tambahkan alamat IP publik Instance ECS ke daftar putih akses publik kluster.
Login ke Konsol ECS dan lihat alamat IP publik instance tersebut di daftar instance.
Tambahkan ke daftar putih publik
Dapatkan alamat IP perangkat Anda dan tambahkan ke daftar putih akses publik.
Klik Configure di sebelah kanan grup default. Di kotak dialog yang muncul, tambahkan alamat IP ke daftar putih.
Jenis konfigurasi
Format dan contoh
Catatan penting
Format alamat IPv4
Alamat IP tunggal:
192.168.0.1Blok CIDR:
192.168.0.0/24. Kami menyarankan Anda menggabungkan alamat IP yang tersebar menjadi blok CIDR.
Satu kluster dapat memiliki daftar putih hingga 300 alamat IP atau blok CIDR. Pisahkan beberapa entri dengan koma (,), dan jangan tambahkan spasi sebelum atau sesudah koma.
Alamat publik default:
127.0.0.1, yang menolak akses dari semua alamat IPv4.0.0.0.0/0: Mengizinkan akses dari semua alamat IPv4.PentingKami sangat menyarankan Anda tidak mengonfigurasi
0.0.0.0/0. Ini menimbulkan risiko keamanan tinggi.Beberapa kluster dan region tidak mendukung
0.0.0.0/0. Ketersediaan aktual tergantung pada antarmuka pengguna atau pesan error.
Setelah menyelesaikan konfigurasi, klik OK.
Klik Access over Internet. Di halaman login Kibana, masukkan username dan password Anda. Setelah login, Anda akan diarahkan ke Konsol Kibana, tempat Anda dapat mulai menjelajahi data Elasticsearch Anda.
Username: Username-nya adalah elastic.
Password: Password yang Anda atur saat membuat kluster Elasticsearch. Jika lupa password, Anda dapat mengatur ulang.
Buka konsol Dev Tools dan jalankan perintah
GET /untuk menanyakan informasi tentang kluster.Verifikasi: Jika panel respons di sebelah kanan mengembalikan objek JSON yang berisi informasi seperti nomor versi dan nama kluster, koneksi berhasil.
Langkah 3: Buat indeks
Di Kibana Dev Tools, jalankan perintah API RESTful berikut untuk membuat pemetaan indeks bernama product_info untuk data produk manajemen kekayaan.
PUT /product_info
{
"settings": {
"number_of_shards": 5,
"number_of_replicas": 1
},
"mappings": {
"properties": {
"productName": {
"type": "text",
"analyzer": "ik_smart"
},
"annual_rate":{
"type":"keyword"
},
"describe": {
"type": "text",
"analyzer": "ik_smart"
}
}
}
}Deskripsi parameter:
settings: Menentukan konfigurasi shard untuk indeks. Misalnya, Anda dapat menentukan 5 shard utama dan 1 replika untuk setiap shard utama.mappings: Menentukan bidang-bidang dalam indeks. Misalnya, Anda dapat menentukan tiga bidang dalam indeks:productName,annual_rate, dandescribe. Tipetextmendukung tokenisasi dan pencarian fuzzy, sedangkan tipekeyworddigunakan untuk pencocokan nilai eksak. Untuk informasi lebih lanjut tentang tipe bidang, lihat Field data types.
Verifikasi: Jika respons berisi "acknowledged": true dan "shards_acknowledged": true, indeks berhasil dibuat.
Langkah 4: Masukkan data
Jalankan perintah berikut untuk memasukkan data uji secara massal:
POST /product_info/_bulk
{"index":{}}
{"productName":"Wealth Management Product A","annual_rate":"3.2200%","describe":"180-day fixed-term product. Minimum investment: 20,000. Stable returns. Optional push notifications."}
{"index":{}}
{"productName":"Wealth Management Product B","annual_rate":"3.1100%","describe":"90-day scheduled investment product. Minimum investment: 10,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product C","annual_rate":"3.3500%","describe":"270-day scheduled investment product. Minimum investment: 40,000. Daily push notifications for immediately credited returns."}
{"index":{}}
{"productName":"Wealth Management Product D","annual_rate":"3.1200%","describe":"90-day scheduled investment product. Minimum investment: 12,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product E","annual_rate":"3.0100%","describe":"Recommended 30-day scheduled investment product. Minimum investment: 8,000. Daily push notifications for returns."}
{"index":{}}
{"productName":"Wealth Management Product F","annual_rate":"2.7500%","describe":"Popular 3-day short-term product. No service fees. Minimum investment: 500. Return notifications sent by text message."}Verifikasi: Jika respons berisi "errors": false, data berhasil dimasukkan.
Langkah 5: Ambil data
Pencarian teks penuh (pencocokan kabur)
Carilah produk manajemen kekayaan yang bidang describe-nya berisi "Daily push notifications for credited returns":
GET /product_info/_search
{
"query": {
"match": {
"describe": "Daily push notifications for credited returns"
}
}
}Verifikasi: Hasil diurutkan berdasarkan skor relevansi, dengan hasil berperingkat lebih tinggi muncul terlebih dahulu.
Pencarian bersyarat (pencocokan eksak)
Carilah produk manajemen kekayaan yang annual_rate-nya berada di antara 3,00% dan 3,13%:
GET /product_info/_search
{
"query": {
"range": {
"annual_rate": {
"gte": "3.0000%",
"lte": "3.1300%"
}
}
}
}Verifikasi: Kueri melakukan pencocokan eksak pada rentang numerik dan mengembalikan hasil yang memenuhi kondisi tersebut. Untuk informasi lebih lanjut tentang cara menggunakan kondisi kueri, lihat Query DSL.
Bersihkan sumber daya dan langkah selanjutnya
Hapus data dan rilis kluster
Jalankan perintah berikut untuk menghapus indeks uji:
DELETE /product_infoHasil berikut dikembalikan:
{ "acknowledged" : true }Buka daftar kluster di Konsol Elasticsearch.
Di daftar kluster, temukan kluster yang ingin Anda rilis. Di kolom Actions, klik , pilih Immediately Delete, lalu klik OK untuk merilis kluster.
PentingMerilis kluster akan menghapus kluster dan semua datanya secara permanen. Tindakan ini tidak dapat dibatalkan. Lakukan dengan hati-hati.
Langkah selanjutnya
Untuk mempelajari lebih lanjut tentang Alibaba Cloud Elasticsearch, Anda dapat menjelajahi topik-topik berikut:
Pengumpulan dan migrasi data: Kumpulkan atau migrasikan data bisnis Anda ke Elasticsearch.
Sebelum melakukan migrasi data, evaluasi volume data Anda untuk menentukan apakah Anda perlu meningkatkan konfigurasi kluster.
Optimasi kinerja: Jelajahi teknik desain indeks dan optimasi kueri untuk meningkatkan kinerja kluster.
Visualisasi Kibana: Pelajari cara menggunakan fitur Kibana seperti Discover dan Dashboard untuk membuat dasbor data.
> Release Cluster