全部产品
Search
文档中心

OpenSearch:Buat skrip pengurutan dengan menggunakan SortScript

更新时间:Jun 26, 2025

Siklus hidup skrip pengurutan

Berikut adalah penjelasan mengenai siklus hidup skrip pengurutan di OpenSearch:

  1. Buat skrip pengurutan. Dalam proses ini, Anda perlu menentukan nama dan ID versi aplikasi serta nama skrip pengurutan. Untuk memudahkan identifikasi, disarankan agar Anda membedakan nama skrip pengurutan dari ekspresi yang dibuat di konsol OpenSearch.

  2. Unggah kode skrip. Skrip pengurutan ditulis menggunakan Cava, bahasa pemrograman yang disediakan oleh OpenSearch. Anda dapat mengunggah kode skrip berulang kali untuk skrip pengurutan yang belum diterbitkan.

  3. Kompilasi skrip pengurutan. Setelah mengunggah kode skrip, jalankan perintah kompilasi untuk memverifikasi sintaksis. Anda dapat mengompilasi skrip pengurutan yang belum diterbitkan berkali-kali.

  4. Terbitkan skrip pengurutan. Jika ingin menerapkan skrip pengurutan ke aplikasi daring setelah dikompilasi, terbitkan skrip tersebut. Setelah diterbitkan, Anda tidak dapat mengunggah atau mengompilasi skrip pengurutan lagi. Satu-satunya opsi yang tersedia adalah menghapus skrip pengurutan.

  5. Hapus skrip pengurutan. Anda dapat menghapus skrip pengurutan yang tidak digunakan lagi. Pastikan bahwa skrip pengurutan tidak sedang digunakan dalam kueri sebelum penghapusan. Jika tidak, kesalahan kueri akan dikembalikan.

  6. Lihat skrip pengurutan. Anda dapat melihat status skrip pengurutan kapan saja selama proses-proses di atas.

SortScript

SortScript adalah alat baris perintah berbasis Python dalam versi lebih baru dari 2.7. Alat ini memungkinkan Anda membuat, memelihara, menerbitkan, dan menghapus skrip pengurutan dengan mudah. Anda dapat mengunduh SortScript. Sebelum menggunakan SortScript, konfigurasikan ID AccessKey dan Rahasia AccessKey Anda di file tools_conf.py.

Contoh berikut menjelaskan cara membuat skrip pengurutan dengan menggunakan SortScript:

1. Buat skrip pengurutan.

python ./sortscript create --appName script_test --appVersionId 12345678 --scriptName script1

2. Unggah kode skrip, termasuk file BasicSimilarityScorer.cava dan IntelligenceAlgorithm.cava. Untuk informasi lebih lanjut tentang sintaksis Cava, lihat Tipe Data dan Tipe Variabel.

python ./sortscript updatecontent --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName BasicSimilarityScorer.cava --localFile ./BasicSimilarityScorer.cava
python ./sortscript updatecontent --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName IntelligenceAlgorithmScorer.cava --localFile ./IntelligenceAlgorithmScorer.cava

3. Kompilasi skrip pengurutan. Kesalahan sintaksis tertentu mungkin dikembalikan saat Anda mengompilasi skrip pengurutan. Modifikasi skrip pengurutan berdasarkan prompt.

python ./sortscript compile --appName script_test --appVersionId 12345678 --scriptName script1

4. Terbitkan skrip pengurutan. Setelah memastikan bahwa tidak ada modifikasi lebih lanjut yang diperlukan, terbitkan skrip pengurutan.

python ./sortscript release --appName script_test --appVersionId 12345678 --scriptName script1

5. Lihat skrip pengurutan. Anda dapat menyetel parameter scriptName untuk melihat skrip pengurutan tertentu. Jika tidak, semua skrip pengurutan dalam versi aplikasi saat ini akan dicantumkan.

python ./sortscript list --appName script_test --appVersionId 12345678 --scriptName script1
python ./sortscript list --appName script_test --appVersionId 12345678

6. Lihat detail file kode.

python ./sortscript getcontent --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName BasicSimilarityScorer.cava
python ./sortscript getcontent --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName IntelligenceAlgorithmScorer.cava

7. Hapus file kode.

python ./sortscript deleteScriptFile --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName BasicSimilarityScorer.cava
python ./sortscript deleteScriptFile --appName script_test --appVersionId 12345678 --scriptName script1 --scriptFileName IntelligenceAlgorithmScorer.cava

8. Hapus skrip pengurutan. Pastikan bahwa skrip pengurutan tidak sedang digunakan dalam kueri sebelum penghapusan.

python ./sortscript delete --appName script_test --appVersionId 12345678 --scriptName script1

Gunakan skrip pengurutan dalam kueri untuk mengurutkan hasil

  1. Pastikan bahwa skrip pengurutan telah diterbitkan.

  2. Tetapkan parameter second_rank_name dalam kueri ke nama skrip pengurutan. Untuk memudahkan identifikasi, disarankan agar Anda membedakan nama skrip pengurutan dari ekspresi yang dibuat di konsol OpenSearch.

  3. Tetapkan parameter second_rank_type dalam kueri ke cava_script.

  4. Lihat hasil kueri. Jika skrip pengurutan tidak ada, hasil kueri dapat dikembalikan, tetapi kesalahan juga akan dikembalikan.