cognidb
CogniDB 是一個基於 Python 的自然語言轉 SQL 介面,讓使用者能用一般英文查詢 MySQL、PostgreSQL、MongoDB 及 AWS RDS 等資料庫。
cognidb 是什麼?
CogniDB 是一個基於 Python 的自然語言轉 SQL 介面,讓使用者能用一般英文查詢 MySQL、PostgreSQL、MongoDB 及 AWS RDS 等資料庫。它能解析問題、理解資料庫結構、產生安全的 SQL 語法,並回傳查詢結果,讓非技術背景的使用者無需撰寫 SQL 即可取得資料庫洞察。
cognidb 概覽
這是什麼
CogniDB 是一個 Python 函式庫,能將自然語言查詢轉換為針對 PostgreSQL、MySQL 和 SQLite 的 SELECT 導向 SQL。它被設計為應用程式的安全自然語言轉 SQL 介面,而非聊天產品。該函式庫解析使用者問題、理解資料庫結構、產生安全的 SQL,並回傳結果。它透過多層安全管線強調安全性:輸入清理、AST 防護、允許清單以及參數化執行。
主要功能
- 預設使用意圖模式:LLM 產生結構化的
QueryIntent,並以繫結參數確定性渲染(無任何值被內插到 SQL 中)。 - 真實的 SQL AST 防護(sqlglot)從結構上強制執行讀寫政策,阻擋資料修改 CTE、堆疊陳述式、DDL/管理指令以及危險函式。
- 預設為讀取模式(SELECT);寫入模式(INSERT/UPDATE/DELETE)需選擇啟用。DDL 一律被拒絕。
- 可選的 fail-closed 資料表與欄位允許清單。
- 支援 PostgreSQL、MySQL 和 SQLite 資料庫。
- 包含離線基準測試工具,用於安全/政策/穩健性回歸測試。
使用情境
- 讓非技術使用者能以純英文查詢資料庫,無需撰寫 SQL。
- 將安全的自然語言查詢功能整合到需要揭露資料庫洞察的應用程式中。
- 執行唯讀查詢,並具備強大的安全防護機制,防止注入或資料修改。
快速開始
bash pip install cognidb 完整的快速入門範例(使用離線 SQLite 模式與 FakeIntentGenerator)請參閱儲存庫的 README。
授權與價格
CogniDB 採用 MIT 授權條款。它是開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。