不用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 写在最后
回顾一下今天做的事：
准备测试数据库和表
创建只读账号
安装 database 插件，配置连接
创建 Agent，写提示词，添加工具
测试查询效果
多表场景升级：用 Get Table Schema 动态获取表结构
以后查数据，不用开 Navicat，不用写 SQL，直接问就行。
这套方案的核心是👇
给AI足够的上下文 + 正确的工具 = 自然语言查数据库
