SQL Database Reader
Buka di CMSPlugin SQL Database Reader menghubungkan agent Anda ke database SQL yang aktif, sehingga user bisa meng-query data bisnis dengan bahasa sehari-hari. Alih-alih menulis SQL, user cukup bertanya dengan bahasa biasa, lalu agent menerjemahkannya menjadi query, menjalankannya, dan mengembalikan hasilnya.
Cara Kerjanya
Saat user mengajukan pertanyaan, plugin akan:
- Menerjemahkan pertanyaan berbahasa alami menjadi query SQL menggunakan AI.
- Menerapkan kebijakan row-level security yang berlaku berdasarkan izin user.
- Menjalankan query terhadap database yang terhubung.
- Mengembalikan hasil yang terformat dan mudah dibaca.
Semua eksekusi query dicatat secara otomatis, sehingga Anda bisa melihat dengan jelas data apa yang diakses dan kapan.
Database yang Didukung
| Database | Provider key |
|---|---|
| Microsoft SQL Server, termasuk Azure SQL Database, Azure Synapse, dan SQL endpoint Microsoft Fabric | sqlserver |
| PostgreSQL | postgresql |
| MySQL | mysql |
| Oracle | oracle |
| File Parquet di server Anda sendiri, di-query di sana oleh on-premise gateway — khusus gateway (detail) | parquet |
Fitur Utama
| Fitur | Deskripsi |
|---|---|
| Bahasa alami ke SQL | User bertanya dengan bahasa biasa; plugin membuat dan menjalankan SQL-nya. |
| Login Microsoft Entra ID | Hubungkan SQL Server, Azure SQL, Synapse, dan Microsoft Fabric dengan service principal, tanpa SQL login. |
| Empat sumber data | Database (terhubung langsung, atau melalui on-premise gateway sehingga tidak ada port yang terbuka dan Qlar tidak pernah memegang kredensial Anda), workbook Excel yang diupload, atau file Parquet yang di-query di server Anda sendiri. |
| Query yang memahami skema | Anda mengatur tabel dan kolom mana yang boleh diakses agent. |
| Virtual foreign key | Definisikan relasi antartabel meskipun tidak ada constraint FK di database. |
| Row-Level Security | Batasi hasil query berdasarkan izin user. |
| Pengujian query | Terjemahkan dan jalankan query di panel pengujian yang aman sebelum digunakan secara live. |
| Usage log | Lacak setiap eksekusi query beserta pertanyaan, SQL yang dihasilkan, status, dan jumlah barisnya. |
Alur Penyiapan
Ikuti langkah-langkah berikut secara berurutan untuk mengonfigurasi plugin:
- Siapkan koneksi database: pilih mode akses, lalu masukkan kredensial dan uji konektivitasnya. Jika port database tidak bisa dibuka untuk Qlar, gunakan on-premise gateway sebagai gantinya.
- Konfigurasikan tabel dan kolom: pilih data apa saja yang bisa dilihat agent.
- Siapkan virtual foreign key: definisikan relasi antartabel bila diperlukan.
- Konfigurasikan function tool: tentukan bagaimana plugin ditampilkan ke AI.
- Uji query Anda: validasi pembuatan SQL sebelum deployment.
- Konfigurasikan row-level security: batasi akses data berdasarkan izin user.
- Pantau usage log: tinjau riwayat query dan unduh log.
Prasyarat
Sebelum membuat instance plugin:
- Database SQL yang sedang berjalan, baik yang dapat dijangkau dari Qlar, maupun yang dapat dijangkau dari mesin milik Anda yang bisa menjalankan on-premise gateway.
- User database read-only yang punya akses ke tabel-tabel target — atau, untuk SQL Server / Azure SQL / Fabric, service principal Microsoft Entra ID yang punya akses baca ke data.
- Daftar tabel dan kolom yang boleh di-query oleh agent.
- Keputusan tata kelola data tentang apakah row-level security diperlukan.