Testing Queries

Buka di CMS

Panel 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 month
  • How 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.

PlaceholderFieldContoh nilai
{USER_ID()}User IDuser-42
{USER_EMAIL()}Email userarjuna@example.com
{AGENT_ID()}Agent IDagent-crm
{MESSENGER_ACCOUNT_CODE()}Kode akun messengerwa-001
{MESSENGER_PRODUCT()}Jenis produk messengerwhatsapp

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

ErrorArtinya
Translation failedAI tidak bisa membuat SQL yang valid. Perbaiki deskripsi skema atau perjelas prompt-nya.
Table or column not foundSebuah nama di SQL yang dihasilkan tidak ada di database. Periksa konfigurasi skema.
Query timeoutQuery melebihi 30 detik. Tambahkan filter atau pastikan ada index database untuk kolom yang di-query.
Permission deniedUser database tidak punya akses baca ke tabel yang di-query.

Halaman Terkait