Testing Queries
Buka di CMSPanel pengujian query memungkinkan Anda memvalidasi bagaimana plugin membuat dan menjalankan SQL sebelum agent dibuka untuk end user. Anda bisa menerjemahkan prompt berbahasa alami ke SQL, menyimulasikan row-level security, mengganti placeholder konteks user, dan menjalankan query dengan batas jumlah baris yang terkendali.
Buka Tools → Plugins → SQL Database Reader → Test di sidebar agent.
Panel pengujian mengharuskan konfigurasi plugin disimpan terlebih dahulu. Pastikan Anda sudah menyelesaikan konfigurasi skema dan pengaturan function.
Menerjemahkan Pertanyaan ke SQL
Masukkan pertanyaan berbahasa alami di field Prompt lalu klik Translate. Plugin menggunakan model AI untuk mengubah pertanyaan menjadi query SQL berdasarkan skema dan data dictionary Anda saat ini.
Contoh prompt:
Show me the top 10 customers by total revenue this monthHow many orders currently have a status of pending?List all products where stock is below 20 units
Panel mengembalikan SQL yang dihasilkan dan waktu pemrosesannya dalam milidetik. Tinjau SQL tersebut untuk memastikan:
- Tabel dan kolom yang dirujuk sudah benar.
- Kondisi JOIN sudah benar, terutama jika melibatkan virtual foreign key.
- Kondisi filter sesuai dengan maksud pertanyaan.
Jika SQL yang dihasilkan salah, kembali dan perbaiki deskripsi tabel dan kolom Anda di konfigurasi skema.
Menyimulasikan Row-Level Security
Jika konfigurasi Anda mengaktifkan row-level security, Anda bisa menyimulasikan hasil yang akan dilihat user yang berbeda dengan memasukkan permission di field User Permissions.
Masukkan satu atau beberapa nama permission yang mewakili role user, misalnya sales atau manager. Plugin menerapkan policy yang cocok dan menampilkan klausa WHERE yang akan disisipkan ke dalam query.
Contoh: Jika policy untuk sales membatasi tabel orders ke baris dengan region = 'APAC', SQL hasil terjemahan akan menyertakan:
WHERE orders.region = 'APAC'
Gunakan ini untuk memastikan policy membatasi data dengan benar sebelum deployment.
Menyimulasikan Konteks User
Placeholder seperti {USER_ID()} dan {USER_EMAIL()} diganti saat query dieksekusi dengan nilai sebenarnya dari sesi yang terautentikasi. Di panel pengujian, Anda bisa memberikan nilai tiruan untuk menyimulasikan penggantian ini.
| Placeholder | Field | Contoh nilai |
|---|---|---|
{USER_ID()} | User ID | user-42 |
{USER_EMAIL()} | Email user | arjuna@example.com |
{AGENT_ID()} | Agent ID | agent-crm |
{MESSENGER_ACCOUNT_CODE()} | Kode akun messenger | wa-001 |
{MESSENGER_PRODUCT()} | Jenis produk messenger | whatsapp |
Menjalankan Query
Setelah menerjemahkan, klik Execute untuk menjalankan SQL terhadap database yang aktif. Atur Row Limit antara 1 dan 10 agar tidak mengembalikan hasil yang besar selama pengujian.
Panel mengembalikan:
- Query yang dieksekusi setelah penerapan RLS dan penggantian placeholder
- Baris hasil dalam bentuk tabel terformat
- Jumlah baris dan waktu eksekusi
Eksekusi di panel pengujian dibatasi maksimal 10 baris. Di production, berlaku batas per provider sebanyak 10.000 baris.
Memahami Error
| Error | Artinya |
|---|---|
| Translation failed | AI tidak bisa membuat SQL yang valid. Perbaiki deskripsi skema atau perjelas prompt-nya. |
| Table or column not found | Sebuah nama di SQL yang dihasilkan tidak ada di database. Periksa konfigurasi skema. |
| Query timeout | Query melebihi 30 detik. Tambahkan filter atau pastikan ada index database untuk kolom yang di-query. |
| Permission denied | User database tidak punya akses baca ke tabel yang di-query. |
Halaman Terkait
- Configure Tables and Columns: perbaiki deskripsi untuk mendapatkan pembuatan SQL yang lebih baik.
- Virtual Foreign Keys: verifikasi pembuatan JOIN setelah mendefinisikan relasi FK.
- Row-Level Security: uji bagaimana policy memengaruhi query yang dihasilkan.
- Overview SQL Database Reader