SQL Database Reader

Buka di CMS

Plugin 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:

  1. Menerjemahkan pertanyaan berbahasa alami menjadi query SQL menggunakan AI.
  2. Menerapkan kebijakan row-level security yang berlaku berdasarkan izin user.
  3. Menjalankan query terhadap database yang terhubung.
  4. 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

DatabaseProvider key
Microsoft SQL Server, termasuk Azure SQL Database, Azure Synapse, dan SQL endpoint Microsoft Fabricsqlserver
PostgreSQLpostgresql
MySQLmysql
Oracleoracle
File Parquet di server Anda sendiri, di-query di sana oleh on-premise gateway — khusus gateway (detail)parquet

Fitur Utama

FiturDeskripsi
Bahasa alami ke SQLUser bertanya dengan bahasa biasa; plugin membuat dan menjalankan SQL-nya.
Login Microsoft Entra IDHubungkan SQL Server, Azure SQL, Synapse, dan Microsoft Fabric dengan service principal, tanpa SQL login.
Empat sumber dataDatabase (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 skemaAnda mengatur tabel dan kolom mana yang boleh diakses agent.
Virtual foreign keyDefinisikan relasi antartabel meskipun tidak ada constraint FK di database.
Row-Level SecurityBatasi hasil query berdasarkan izin user.
Pengujian queryTerjemahkan dan jalankan query di panel pengujian yang aman sebelum digunakan secara live.
Usage logLacak setiap eksekusi query beserta pertanyaan, SQL yang dihasilkan, status, dan jumlah barisnya.

Alur Penyiapan

Ikuti langkah-langkah berikut secara berurutan untuk mengonfigurasi plugin:

  1. 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.
  2. Konfigurasikan tabel dan kolom: pilih data apa saja yang bisa dilihat agent.
  3. Siapkan virtual foreign key: definisikan relasi antartabel bila diperlukan.
  4. Konfigurasikan function tool: tentukan bagaimana plugin ditampilkan ke AI.
  5. Uji query Anda: validasi pembuatan SQL sebelum deployment.
  6. Konfigurasikan row-level security: batasi akses data berdasarkan izin user.
  7. Pantau usage log: tinjau riwayat query dan unduh log.

Prasyarat

Sebelum membuat instance plugin:

  1. 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.
  2. 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.
  3. Daftar tabel dan kolom yang boleh di-query oleh agent.
  4. Keputusan tata kelola data tentang apakah row-level security diperlukan.

Halaman Terkait