Tutorial ini menunjukkan kepada pengembang baru Alibaba Cloud Elasticsearch (ES) cara membuat kluster dan mengambil data. Penyelesaian tutorial ini memerlukan waktu sekitar 45 menit, termasuk perkiraan waktu tunggu 20 menit hingga kluster selesai dibuat.
Apa yang akan Anda pelajari
Membuat dan mengonfigurasi kluster ES.
Memodelkan data menggunakan Dev Tools di Kibana.
Kibana telah terintegrasi dalam Konsol Alibaba Cloud Elasticsearch dan tidak memerlukan instalasi manual.
Memasukkan data sampel dan melakukan berbagai operasi pencarian.
Setelah menyelesaikan tutorial ini, Anda akan memahami cara melakukan operasi dasar Alibaba Cloud Elasticsearch, seperti membuat indeks, membaca dan menulis data, serta menjalankan pencarian.
Versi ES dan biaya
Sebelum memulai, tinjau informasi penting berikut untuk tutorial ini:
Tipe dan versi ES: Vector Enhanced Edition 8.17.0.
Versi ini memodularisasi layanan algoritma inti dalam pipeline pencarian AI, termasuk parsing dokumen, chunking, text embedding, analisis kueri, pengambilan, pengurutan, dan integrasi large language model (LLM). Versi ini mendukung semantic search untuk membantu Anda membangun aplikasi 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, total biaya diperkirakan kurang dari USD 5. Segera lepaskan kluster setelah selesai untuk menghindari biaya tambahan.
Prasyarat
Daftar dan login ke Akun Alibaba Cloud. Pastikan akun tersebut memiliki izin untuk membuat dan mengelola sumber daya Alibaba Cloud Elasticsearch dan Virtual Private Cloud (VPC).
Buat Virtual Private Cloud (VPC) dan vSwitch, lalu catat wilayah dan zona-nya. Anda harus membuat kluster ES di wilayah dan zona yang sama agar dapat terhubung ke VPC tersebut.
Prosedur
Langkah 1: Buat kluster (sekitar 20 menit)
Di halaman pembuatan kluster, buat kluster. Konfigurasikan parameter utama seperti pada tabel berikut, dan biarkan parameter lain tetap pada nilai default-nya.
Parameter
Deskripsi
Billing Method
Pilih pay-as-you-go. Ini memungkinkan Anda melepas kluster kapan saja.
Region and 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 meningkatkan ke penerapan multi-zona guna meningkatkan ketersediaan.
Tutorial ini menggunakan China (Hangzhou) / Zone I.
Network Type
Pilih VPC dan vSwitch yang telah Anda buat.
Cluster Type dan Elasticsearch Version
Vector Enhanced Edition 8.17.0. Tutorial ini berbasis versi ini.
Data Node Specifications
CPU Type: Intel 2 vCPU, memori 4 GiB.
Tipe dan ukuran penyimpanan node data: SSD cloud disk, storage space 20 GiB per node.
Jumlah node data: 2.
Node data menyimpan data indeks dan menangani operasi seperti membuat, mengambil, memperbarui, menghapus, dan mengagregasi dokumen.
ES_test
Password
Buat kata sandi kustom. Anda akan menggunakan kata sandi ini untuk login ke Kibana guna membuat indeks dan menjelajahi data.
Klik Buy Now dan tunggu sekitar 20 menit hingga status kluster berubah menjadi Active.
Langkah 2: Konfigurasikan dan login ke Kibana
Akses publik Kibana diaktifkan secara default, tetapi demi keamanan, semua alamat IP ditolak aksesnya. Untuk mengakses Konsol Kibana, Anda harus menambahkan alamat IP perangkat Anda ke daftar putih akses publik.
Otentikasi dilakukan dalam dua tahap. Pertama, Anda harus login ke Akun Alibaba Cloud Anda. Kedua, Anda harus menggunakan kredensial kluster ES Anda (username adalah elastic dan kata sandi yang sesuai) untuk login ke Kibana.
Di panel navigasi kiri, klik Data Visualization. Di bagian Kibana, klik Modify Configuration.
Di bagian Network Access Configuration, ubah daftar putih akses publik Kibana.
Alamat IP perangkat
Gunakan tabel berikut untuk menemukan alamat IP perangkat Anda.
Skenario
Alamat IP
Metode
Akses Kibana dari komputer lokal Anda melalui Internet.
Alamat IP publik komputer lokal Anda.
CatatanJika komputer Anda berada di jaringan rumah atau perusahaan, Anda harus menambahkan alamat IP egress publik dari jaringan area lokal (LAN) tersebut.
Jalankan perintah
curl ipinfo.io/ipuntuk menemukan alamat IP publik komputer Anda.Akses Kibana dari Instance ECS melalui Internet.
Jika Instance ECS dan kluster ES berada di VPC yang berbeda, gunakan alamat IP publik Instance ECS untuk mengakses Kibana. Tambahkan alamat IP ini ke daftar putih akses publik kluster ES.
Login ke Konsol ECS dan lihat alamat IP publik instance tersebut di daftar instance.
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.
Tipe konfigurasi
Format dan contoh
Catatan
Format alamat IPv4
Alamat IP tunggal:
192.168.0.1Blok CIDR:
192.168.0.0/24. Kami menyarankan Anda menggabungkan alamat IP individual menjadi blok CIDR.
Anda dapat mengonfigurasi maksimal 300 alamat IP atau blok CIDR untuk satu kluster. Pisahkan beberapa entri dengan koma (,). 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.PentingJangan konfigurasi
0.0.0.0/0. Pengaturan ini menimbulkan risiko keamanan tinggi.Beberapa kluster dan wilayah tidak mendukung
0.0.0.0/0. Rujuk antarmuka pengguna atau pesan error untuk informasi akurat.
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.
Username: elastic.
Password: Kata sandi yang Anda atur saat membuat kluster ES. Jika lupa kata sandi, Anda dapat mengatur ulang.
Buka konsol Developer Tools dan jalankan perintah
GET /untuk mengkueri informasi kluster.Verifikasi: Koneksi berhasil jika panel kanan menampilkan objek JSON yang berisi detail kluster, seperti nomor versi dan nama.
Langkah 3: Buat indeks
Di Kibana Dev Tools, jalankan perintah berikut untuk membuat indeks bernama product_info dan definisikan pemetaan 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 utama:
settings: Mendefinisikan konfigurasi shard indeks. Misalnya, konfigurasi ini menetapkan 5 shard utama dan 1 replika untuk setiap shard utama.
mappings: Mendefinisikan bidang indeks. Misalnya, konfigurasi ini menetapkan tiga bidang:productName,annual_rate, dandescribe. Bidang bertipetextditokenisasi untuk mendukung pencarian teks penuh. Bidang bertipekeyworddigunakan 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 sampel 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 return message notifications."}
{"index":{}}
{"productName":"Wealth Management Product F","annual_rate":"2.7500%","describe":"Popular short-term product. 3-day term, no fees. Minimum investment: 500. Return notifications by SMS."}Verifikasi: Jika respons berisi "errors": false, data berhasil dimasukkan.
Langkah 5: Cari data
Pencarian teks penuh
Cari 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
Cari 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 mengembalikan semua hasil yang berada dalam rentang yang ditentukan. Untuk informasi lebih lanjut tentang klausa kueri, lihat Query DSL.
Bersihkan sumber daya dan langkah selanjutnya
Hapus data dan lepaskan kluster
Jalankan perintah berikut untuk menghapus indeks uji coba.
DELETE /product_infoRespons berikut dikembalikan:
{ "acknowledged" : true }Kembali ke Konsol Alibaba Cloud Elasticsearch.
Di daftar kluster, temukan kluster yang ingin Anda lepaskan. Di kolom Actions, klik . Pilih Immediately Delete lalu klik OK untuk melepas kluster.
PentingMelepas kluster akan menghapusnya secara permanen beserta seluruh datanya. Tindakan ini tidak dapat dikembalikan. Lakukan dengan hati-hati.
Langkah selanjutnya
Untuk mempelajari lebih lanjut tentang Alibaba Cloud Elasticsearch, Anda dapat menjelajahi topik-topik berikut:
Ingesti data: Kumpulkan dan migrasikan data bisnis Anda ke kluster ES.
Sebelum migrasi, tentukan apakah Anda perlu meningkatkan konfigurasi kluster berdasarkan volume data Anda.
Tuning 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 visualisasi data.
> Release Cluster