3步讓AI替你寫(xiě)SQLVanna自然語(yǔ)言查數(shù)據(jù)庫(kù)快速上手指南【免費(fèi)下載鏈接】vanna Chat with your SQL database . Accurate Text-to-SQL Generation via LLMs using Agentic Retrieval .項(xiàng)目地址: https://gitcode.com/GitHub_Trending/va/vanna業(yè)務(wù)同學(xué)一句查一下銷(xiāo)售額前十的客戶(hù)就得讓你手寫(xiě)一遍SQL。Vanna 是開(kāi)源的 Text-to-SQL 框架把數(shù)據(jù)庫(kù)結(jié)構(gòu)訓(xùn)練進(jìn)AI的記憶里業(yè)務(wù)用自然語(yǔ)言提問(wèn)AI 直接返回 SQL 和查詢(xún)結(jié)果不用再等數(shù)據(jù)團(tuán)隊(duì)排期。 原理一句話(huà)給AI遞一張數(shù)據(jù)庫(kù)名片新人入職都是這個(gè)套路先給組織架構(gòu)圖表結(jié)構(gòu)再給團(tuán)隊(duì)術(shù)語(yǔ)表業(yè)務(wù)名詞最后給幾個(gè)過(guò)往案例。Vanna 干的就是這件事——把 DDL、業(yè)務(wù)定義、問(wèn)答對(duì)喂給它存進(jìn)向量庫(kù)來(lái)問(wèn)題先檢索最相關(guān)的記憶交給 LLMSQL 才寫(xiě)得準(zhǔn)。官方論文的實(shí)測(cè)數(shù)字很直白只給 schema 準(zhǔn)確率約3%喂上上下文相關(guān)示例后能到約80%。 三步走通從安裝到第一次提問(wèn)第一步30秒安裝先跑通示例pip install vanna # 沒(méi)有 LLM API key先用內(nèi)置 Mock 示例感受完整流程 python -m vanna.examples.mock_quickstart看到示例跑通基本流程就成了。接真實(shí)模型時(shí)只需把 LLM 換成 OpenAI、Claude 或 Ollama后面代碼不變。第二步訓(xùn)練模型認(rèn)識(shí)你的表上一步跑通后接著喂數(shù)據(jù)庫(kù)名片三樣料按順序表結(jié)構(gòu)、業(yè)務(wù)名詞、歷史問(wèn)答。# 表結(jié)構(gòu)AI的數(shù)據(jù)庫(kù)地圖 vn.train(ddlCREATE TABLE employees (id INT, name VARCHAR(100), salary FLOAT)) # 業(yè)務(wù)名詞AI的術(shù)語(yǔ)表 vn.train(documentation資深員工入職超過(guò)3年的員工) /參數(shù)手上已有寫(xiě)得順手的 SQL 就一并vn.train(sql...)存進(jìn)去例子質(zhì)量越好輸出越穩(wěn)。第三步自然語(yǔ)言提問(wèn)拿回 SQL最后直接問(wèn)。sql vn.ask(哪個(gè)部門(mén)的平均薪資最高) # Vanna 先從向量庫(kù)檢索相關(guān) DDL 和示例再交給 LLM 生成拿回來(lái)的 SQL 可直接在庫(kù)上執(zhí)行。2.0 版本還把它封裝成 Agent注冊(cè) RunSqlTool 這類(lèi)工具后端把表格、圖表流式推給vanna-chat網(wǎng)頁(yè)組件直接嵌進(jìn)任意頁(yè)面。完整流程可看 quickstart 示例 notebook。 前后對(duì)比準(zhǔn)確率差在怎么喂數(shù)據(jù)上下文策略SQL 生成準(zhǔn)確率只喂 schemaDDL約 3%加靜態(tài)示例 SQL約 56%檢索上下文相關(guān)示例RAG約 80%馬上能做的兩件事DDL 和真實(shí)庫(kù)保持同步schema 一變就重新 train從生產(chǎn)里挑 5~10 個(gè)高頻查詢(xún)補(bǔ)問(wèn)答對(duì)準(zhǔn)確率提升主要靠它。 踩坑實(shí)錄這三個(gè)坑我替你踩了DDL 和數(shù)據(jù)庫(kù)脫節(jié)。模型照著幽靈字段寫(xiě) SQL一執(zhí)行就報(bào)錯(cuò)。解法重新導(dǎo)出當(dāng)前 DDL再 train 一遍。只喂 schema 不喂業(yè)務(wù)名詞。高績(jī)效核心客戶(hù)全靠模型猜結(jié)果跑偏。解法補(bǔ)一條vn.train(documentation...)把定義釘死。被 2.0 和 0.x 的 API 搞暈。2.0 是 Agent 工具的寫(xiě)法自帶網(wǎng)頁(yè)組件老的 VannaBase API 用 LegacyVannaAdapter 包一下舊實(shí)例就能直接用上新界面細(xì)節(jié)看 遷移指南。一句話(huà)總結(jié)Vanna 的核心價(jià)值是把寫(xiě) SQL變成喂上下文上下文越準(zhǔn)AI 越能干。打開(kāi) examples 目錄現(xiàn)在就可以跑起來(lái)?！久赓M(fèi)下載鏈接】vanna Chat with your SQL database . Accurate Text-to-SQL Generation via LLMs using Agentic Retrieval .項(xiàng)目地址: https://gitcode.com/GitHub_Trending/va/vanna創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考