我要投稿

Dify实战：不用写SQL，问就行

发布日期：2026-04-18 21:39:42 浏览次数： 1519

作者：小民AI实战笔记

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

大家好，我是小民，见字欢喜。

不用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
- 如果用户问题与数据库无关，礼貌告知无法回答