OpenSearch：Konfigurasikan layanan NL2SQL

Contoh

Deskripsi konfigurasi

Layanan NL2SQL untuk analisis kueri mengubah kueri dalam bahasa alami menjadi Pernyataan SQL. Untuk menggunakan layanan NL2SQL, Anda harus mengonfigurasi informasi berikut:

• Informasi tabel dasar: Konfigurasikan tabel data bisnis tempat layanan NL2SQL bergantung. Ini mencakup nama bidang, tipe bidang, nilai enumerasi bidang, deskripsi bidang, pemetaan bidang, dan penggabungan tabel.

• Contoh pembelajaran: Konfigurasikan kueri yang sering digunakan atau kompleks serta pernyataan SQL yang sesuai untuk meningkatkan akurasi layanan NL2SQL. Jika layanan menghasilkan pernyataan SQL yang tidak terduga, Anda juga dapat menambahkan kueri dan pernyataan SQL yang benar di sini.

• Aturan kustom (istilah dan konsep bisnis): Kueri pengguna sering kali berisi istilah dan konsep spesifik bisnis. Untuk membantu model memahami informasi ini, Anda dapat mengonfigurasi istilah, konsep, dan penjelasan yang sesuai di sini.

  Sebagai contoh:

  • Bagaimana administrasi genangan air dalam seminggu terakhir? Informasi terkait: Administrasi genangan air mencakup tutup lubang air hujan dan kejadian banjir jalan.

  • Siswa teladan adalah siswa dengan ID kurang dari atau sama dengan 10. Siswa atlet adalah siswa dengan ID lebih besar dari 11.

Prosedur

1. Di Platform Terbuka AI Search, pilih Model Service > Service Configuration, lalu klik Create.

   Gunakan pengaturan default untuk Kategori Layanan dan Tipe Konfigurasi. Masukkan Configuration Name, seperti student_info_analysis, yang mewakili analitik data informasi siswa.

2. Klik Save and Next. Konfigurasikan tabel data yang diperlukan oleh layanan NL2SQL dalam format berikut.

   • Konfigurasi tabel dasar

     [
       {
         "table":"schools",
         "columns": [
           {
             "column": "class",
             "description": "Kelas",
             "type": "string",
             "example": ["Kelas 3, Tingkat 1", "Kelas Akselerasi"],
             "value_mapping": []
           }, 
           {
             "column": "school",
             "description": "Sekolah",
             "type": "string",
             "example": ["SMA B di Kota A", "SMA No. 5 AA"],
             "value_mapping": []
           }
         ]
       }, 
       {
         "table":"students",
         "columns": [
           {
             "column": "id",
             "description": "ID Siswa",
             "type": "int",
             "example": [1, 2],
             "value_mapping": [
               [1,"Zhang San"],
               [2,"Li Si"]
             ]
           },
           {
             "column": "class",
             "description": "Kelas",
             "type": "string",
             "example": ["Kelas 3, Tingkat 1", "Kelas Akselerasi"],
             "value_mapping": []
           }
         ]
       }
     ]

     Nama tabel untuk table harus dimulai dengan huruf kecil dan hanya boleh berisi huruf kecil, angka, dan garis bawah (_). Nama tersebut tidak boleh melebihi 30 karakter.

     Nama bidang untuk column harus dimulai dengan huruf kecil dan hanya boleh berisi huruf kecil, angka, dan garis bawah (_). Nama tersebut tidak boleh melebihi 30 karakter.

     Tipe bidang untuk type bisa berupa text, string, int8, uint8, int16, uint16, int32, int, uint32, int64, uint64, float, double, location, date, time, atau timestamp.

   • Konfigurasi Asosiasi Tabel

     ["students.class=schools.class"]

3. Klik Lanjut. Konfigurasikan aturan kustom dan contoh pembelajaran untuk meningkatkan akurasi layanan NL2SQL.

   • Contoh pembelajaran: Konfigurasikan kueri yang sering digunakan atau kompleks serta pernyataan SQL yang sesuai untuk meningkatkan akurasi layanan NL2SQL. Jika layanan menghasilkan pernyataan SQL yang tidak terduga, Anda juga dapat menambahkan kueri dan pernyataan SQL yang benar di sini.

     [
       {
         "query":"Kelas apa Zhang San?",
         "sql" : "SELECT class FROM students WHERE name = 'Zhang San'"
       }
     ]

   • Pemetaan Aturan Kustom (istilah dan konsep bisnis): Kueri pengguna sering kali berisi istilah dan konsep spesifik bisnis. Untuk membantu model memahami informasi ini, Anda dapat mengonfigurasi istilah, konsep, dan penjelasan yang sesuai di sini.

     Sebagai contoh: Siswa teladan adalah siswa dengan ID (id) <= 10. Siswa atlet adalah siswa dengan ID (id) > 11.

     [
       {
         "key":"Siswa teladan",
         "value":"students.id <= 10"
       },
       {
         "key":"Siswa atlet",
         "value":"students.id > 11"
       }
     ]

4. Klik OK, lalu klik Activate Now. Anda akan dialihkan ke daftar konfigurasi layanan. Status aktivasi berubah menjadi Mengaktifkan saat sistem memvalidasi format konfigurasi Anda.

   Ketika status aktivasi berubah menjadi Diaktifkan, konfigurasi layanan siap digunakan. Anda dapat menguji layanan NL2SQL di Pusat Pengalaman.

Apa yang harus dilakukan selanjutnya

Untuk mengintegrasikan layanan NL2SQL ke dalam kode bisnis Anda, lihat API NL2SQL.