免费POC, 零成本试错
AI知识库

AI知识库

学习大模型的前沿技术与行业落地应用


收藏

Dify实战:不用写SQL,问就行

发布日期:2026-04-18 21:39:42 浏览次数: 3199
作者:小民AI实战笔记

微信搜一搜,关注“小民AI实战笔记”

推荐语

告别繁琐SQL语句,用自然语言轻松查询数据库,Dify助你实现零门槛数据交互!

核心内容:
1. Dify实现自然语言转SQL的架构原理
2. 测试数据库准备与只读账号创建
3. 数据库插件安装与Agent应用配置

杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家

不用Navicat、不用写SQL,问一句就出结果;今天我们来用dify搭一个自然语言查数据库的助手👇

01 先看看效果

架构原理

流程很简单:你问 → AI转成SQL → 查数据库 → 给你结果

02 准备工作

动手之前,先做两件事:准备一个测试数据库,再装个插件

2.1 准备测试数据库

为了演示,我们创建一个简单的产品表,执行这段SQL

-- 创建测试数据库
CREATE DATABASE IF NOT EXISTS dify_demo;
USE dify_demo;

-- 创建产品表
CREATE TABLE products (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100) COMMENT '产品名称',
    category VARCHAR(50) COMMENT '产品分类',
    price DECIMAL(10,2) COMMENT '价格',
    stock INT COMMENT '库存数量',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 插入几条测试数据
INSERT INTO products (name, category, price, stock) VALUES
('机械键盘', '外设', 299.00, 150),
('游戏鼠标', '外设', 89.00, 300),
('4K显示器', '显示设备', 1999.00, 50),
('降噪耳机', '音频', 499.00, 80),
('无线充电器', '配件', 99.00, 200);

创建完成

2.2 创建只读账号

强烈建议用只读账号,万一AI理解错了,不至于把数据删了

-- 创建一个只能查询的账号
CREATE USER 'dify_reader'@'%' IDENTIFIED BY '你的密码';
GRANT SELECT ON dify_demo.* TO 'dify_reader'@'%';
FLUSH PRIVILEGES;

2.3 安装数据库插件

Dify插件市场里有现成的数据库连接工具,登录Dify,点顶部「插件」→「插件市场」

搜索「Database」或「MySQL」

安装数据库连接插件

装完后,插件会出现在插件列表里

2.4 配置数据库连接

插件安装完成后,回到Agent应用编排页面,在「工具」区域点击「添加」,选择刚安装的database插件

配置数据库URI👇

我的 Dify 部署在 VMware 虚拟机上,192.168.1.2 是本地 Windows 电脑的 IP

mysql+pymysql://dify_reader:123456@192.168.1.2:3306/dify_demo

配置完成

03 创建Agent

3.1 创建应用

点「工作室」➔「创建空白应用」,应用类型选「Agent」

名称写「SQL查询助手」,点创建

3.2 选模型

选择已经配好的大模型,我用的是DeepSeek

3.3 写系统提示词

把下面这段复制到「提示词」框里

你是一个 SQL 查询助手。用户会用自然语言提问,你需要根据数据库表结构生成 SQL 并查询。

## 数据库表结构

products 表:
- id: 产品ID (INT)
- name: 产品名称 (VARCHAR)
- category: 产品分类 (VARCHAR),可选值:外设、显示设备、音频、配件
- price: 价格 (DECIMAL)
- stock: 库存数量 (INT)
- created_at: 创建时间 (DATETIME)

## 规则

1. 根据用户问题,生成对应的 SQL 查询
2. 只生成 SELECT 查询,禁止 UPDATE、DELETE、INSERT
3. 查询结果用自然语言回复用户
4. 如果用户问题与数据库无关,礼貌告知无法回答

## 示例

用户问:最贵的产品是什么?
回复:最贵的产品是「4K显示器」,价格 1999 元。

用户问:库存低于100的有哪些?
回复:以下产品库存低于100:4K显示器(50件)、降噪耳机(80件)。

上面是单表示例,多表场景请看第06节

3.4 添加工具

在「工具」区域,database插件列表中,添加「Text to SQL」 和「SQL Execute」

然后点右上角「发布」

04 测试效果

测试一:简单查询

产品列表有哪些?

测试二:条件筛选

库存低于100的产品有哪些?

测试三:聚合查询

最贵的产品是什么?

测试过程中如果遇到问题,别急,下面是几个常见坑和解决办法👇

05 常见问题

1. 连不上 MySQL,提示权限拒绝

检查两件事:

① Windows 防火墙是否允许了 3306 端口

② MySQL 是否允许远程连接

-- 查看用户允许的访问来源
SELECT user, host FROM mysql.user;

-- 如果 dify_reader 的 host 是 localhost,改成 %
UPDATE mysql.user SET host = '%' WHERE user = 'dify_reader';
FLUSH PRIVILEGES;

2. 提示认证方式不兼容

MySQL 8 默认用 caching_sha2_password,pymysql不兼容,执行

ALTER USER 'dify_reader'@'%' IDENTIFIED WITH mysql_native_password BY '123456';
FLUSH PRIVILEGES;

3. AI 不调用工具,直接瞎回答

提示词里没有明确告诉 AI 要用工具,在指令里加上

当用户问数据库相关问题时,你必须使用 Text to SQL 和 SQL Execute工具来查询,不能自己编造答案。

06 多表场景怎么办

上面演示的是一张表,提示词里把表结构写死了,但如果数据库里有几十上百张表,总不能全写进去吧?

这时候就需要动态获取表结构,database插件里有个「Get Table Schema」工具,可以自动读取数据库里所有表的结构,不需要手动写。

6.1 添加工具

回到Agent编排页面,在「工具」区域把「Get Table Schema」也勾选上

6.2 改造提示词

把「指令」框里的内容换成下面这段

你是一个 SQL 查询助手。用户会用自然语言提问,你需要查询数据库并返回结果。

## 工作流程

1. 先用 Get Table Schema 工具获取数据库中的所有表结构
2. 根据用户问题,找到相关的表
3. 用 Text to SQL 生成 SQL 语句
4. 用 SQL Execute 执行查询
5. 用自然语言回复用户

## 规则

- 只生成 SELECT 查询,禁止 UPDATE、DELETE、INSERT
- 如果用户问题与数据库无关,礼貌告知无法回答

这样表结构就不用再手动写了,AI会自己先去查一遍

数据库里咱们再加两张表👇

6.3 测试一下

重新发布后再测试一下

数据库里有哪些表

数据库里有哪些表,只告诉我表名就可以

07 写在最后

回顾一下今天做的事:

  1. 准备测试数据库和表

  2. 创建只读账号

  3. 安装 database 插件,配置连接

  4. 创建 Agent,写提示词,添加工具

  5. 测试查询效果

  6. 多表场景升级:用 Get Table Schema 动态获取表结构

以后查数据,不用开 Navicat,不用写 SQL,直接问就行。

这套方案的核心是👇

给AI足够的上下文 + 正确的工具 = 自然语言查数据库

53AI,企业落地大模型首选服务商

产品:场景落地咨询+大模型应用平台+行业解决方案

承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业

联系我们

售前咨询
186 6662 7370
预约演示
185 8882 0121

微信扫码

添加专属顾问

回到顶部

加载中...

扫码咨询

扫码登录
登录即表示您同意《53AI网站服务协议》
服务协议

欢迎您使用【53AI 官方网站】(以下简称“本网站”或“我们”)。本《会员服务协议》(以下简称“本协议”)是您(以下简称“会员”或“用户”)与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。

在您注册或登录前,请务必审慎阅读、充分理解各条款内容,特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时,即视为您已完全理解并同意接受本协议的全部内容。

一、 定义

本网站:指由【深圳市博思协创网络科技有限公司】运营的,域名为【53ai.com】的网站及相关移动端页面。

会员服务:指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。

知识库内容:指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。

二、 账号注册与登录

登录方式:本网站支持以下登录方式,您可根据实际情况选择:

微信公众号授权登录:您同意将您的微信OpenID信息授权给本网站,用于创建或关联会员账号。

手机验证码登录:您需提供真实有效的手机号码,并通过短信验证码完成身份验证与登录/注册。

账号安全:您的账号仅限您本人使用,禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失,由您自行承担。

实名认证:根据相关法律法规要求,我们可能要求您在特定功能下完成实名认证。如您拒绝提供,可能无法使用部分或全部服务。

未成年人保护:若您未满18周岁,请在法定监护人的陪同下阅读本协议,并在征得监护人同意后使用本服务。

三、 服务内容与规范

知识库查阅权限:会员登录后,有权按照其会员等级对应的权限范围,在线浏览、检索本网站知识库中的相关文章及内容。

服务变更:我们有权根据业务发展需要,调整、变更或终止部分服务内容,并将以网站公告、公众号消息等方式提前通知。

禁止行为:您在使用服务时不得实施以下行为:

利用技术手段批量爬取、下载、转存知识库内容;

将知识库内容用于商业目的或未经授权地向第三方传播;

干扰本网站正常运行或侵犯其他用户合法权益;

发布违法违规信息或从事违反公序良俗的活动。

四、 知识产权声明

权利归属:本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有,受《中华人民共和国著作权法》等法律保护。

有限许可:本网站授予会员一项非独占、不可转让、不可转授权的普通许可,仅限于个人学习、研究之目的在线查阅知识库内容。

侵权追责:未经书面许可,任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现,我们保留追究其法律责任的权利。

五、 个人信息保护

我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息,请单独阅读 《隐私政策》。

您通过微信公众号授权或手机号验证所提供的信息,我们将严格按照《个人信息保护法》的规定处理,仅用于身份识别、服务提供及安全验证等必要用途。

您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。

六、 免责声明

内容准确性:知识库内容仅供参考,不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证,您应自行判断并承担使用风险。

不可抗力:因自然灾害、政策法规变化、网络故障、第三方平台接口异常(如微信接口维护、运营商短信通道故障)等不可抗力导致的服务中断或延迟,我们不承担违约责任。

第三方链接:本网站可能包含指向第三方网站的链接,该等网站的内容和服务不受我们控制,请您自行甄别风险。

七、 违约责任

如您违反本协议约定,我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施,并保留要求赔偿损失的权利。

如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失,您应承担全部赔偿责任(包括但不限于罚款、赔偿金、律师费、公证费等)。

八、 法律适用与争议解决

本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。

因本协议产生的或与本协议有关的任何争议,双方应友好协商解决;协商不成的,任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。

九、 其他

本协议构成双方就本服务达成的完整协议,取代此前任何口头或书面约定。

本协议任一条款被认定为无效或不可执行的,不影响其他条款的效力。

我们对本协议享有最终解释权,并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效,继续使用服务即视为同意修订内容。


已查阅