Configure Tables and Columns

Buka di CMS

Setelah memuat skema database, Anda memilih tabel dan kolom mana yang boleh di-query oleh agent. Plugin hanya membuat SQL terhadap tabel dan kolom yang Anda sertakan di sini; selebihnya tidak terlihat oleh AI.

Buka Tools → Plugins → SQL Database Reader → Schema di sidebar agent.


Memilih Tabel

Panel menampilkan semua tabel yang ditemukan dari koneksi database. Centang setiap tabel yang ingin Anda masukkan ke dalam cakupan query agent.

Untuk setiap tabel yang dipilih, tambahkan description, yaitu catatan singkat yang menjelaskan data bisnis apa yang ada di tabel tersebut. Deskripsi ini dimasukkan langsung ke prompt AI dan memengaruhi kualitas query. Tanpa deskripsi, AI hanya mengandalkan nama tabel dan kolom untuk menebak fungsinya.

Contoh deskripsi tabel:

Menyimpan daftar master pelanggan, termasuk informasi kontak, status akun, dan wilayah penjualan yang ditetapkan.


Memilih Kolom

Untuk setiap tabel yang dipilih, buka tabel tersebut untuk melihat kolom-kolomnya. Setiap kolom bisa disertakan atau dikecualikan satu per satu.

Kolom yang Anda kecualikan tidak akan muncul di query yang dihasilkan. Gunakan ini untuk:

  • Menyembunyikan field sensitif seperti password, kode internal, atau PII.
  • Mengurangi konteks yang tidak relevan yang bisa membingungkan pembuatan SQL.
  • Memusatkan perhatian AI pada data yang paling berguna.

Properti kolom

PropertiDeskripsi
Column NameNama kolom di database.
TypeTipe data, misalnya varchar, int, datetime.
NullableApakah kolom menerima nilai null.
Primary KeyApakah kolom tersebut primary key tabel.
DescriptionCatatan singkat yang menjelaskan apa yang disimpan kolom ini. Meningkatkan akurasi query.

Deskripsi kolom disertakan dalam konteks skema yang diterima AI. Semakin tepat deskripsi Anda, semakin akurat SQL yang dihasilkan.

Nama kolomDeskripsi yang kurang baikDeskripsi yang baik
statusStatusStatus order: pending, confirmed, shipped, cancelled
amtJumlahTotal nilai invoice dalam USD sebelum pajak
cust_idID PelangganForeign key yang merujuk ke customers.id
regionWilayahKode wilayah penjualan yang ditetapkan untuk akun pelanggan

Data Dictionary

Saat Anda menyimpan konfigurasi skema, plugin membuat data dictionary dari pilihan tabel dan deskripsi Anda. Dictionary ini dipakai sebagai konteks di setiap prompt pembuatan query.

Jika Anda menambahkan tabel baru, mengubah pilihan kolom, atau memperbarui deskripsi, simpan lagi untuk membuat ulang data dictionary.


Langkah berikutnya


Halaman Terkait