Dify 1.0+版本的数据库连接能力迎来全面升级，为开发者提供了API接入与插件工具两套解决方案。无论是通过Http请求节点对接企业级数据库，还是利用SQL查询、Database、SQLite三大插件实现自然语言转SQL等高级功能，本文都将提供详细的配置指南与实战技巧，助你轻松驾驭Dify的数据处理能力。

版本说明

本教程基于Dify 1.0+ 版本制作，适用于Dify 1.0及以上版本。如果你使用的是更早版本的Dify，建议先升级到1.0版本以获得更好的数据库连接功能和稳定性。

版本特性：

• Dify 1.0+ 版本提供了更完善的插件工具支持
• 改进了数据库连接的稳定性和安全性
• 优化了工作流中的Http请求节点功能
• 增强了错误处理和调试能力

版本检查方法：

登录Dify平台后，在右下角或设置页面可以查看当前版本号

确保版本号为1.0.0或更高版本

Dify连接数据库的两种方法概述

• Dify平台提供了两种连接数据库的方法：
• API接口接入：通过工作流或对话流中的Http请求节点处理数据库操作

插件工具接入：使用Dify提供的数据库相关插件工具，包括SQL查询、Database工具和SQLite工具

每种方法都有其适用场景，下面详细介绍。

方法一：API接口接入

适用场景

• 需要连接自定义数据库API
• 数据库有现成的REST API接口
• 需要复杂的数据库操作逻辑
• 对安全性要求较高的场景

实施步骤

1. 准备工作

确保你的数据库有可用的API接口，常见的包括：

• MySQL/MariaDB的REST API
• PostgreSQL的REST API
• MongoDB的REST API
• 自建的数据库API服务

2. 在Dify中配置Http请求节点

步骤1：创建工作流或对话流

• 登录Dify平台
• 创建新的工作流或对话流
• 添加Http请求节点

步骤2：配置Http请求节点

节点类型：Http Request

请求方法：GET/POST/PUT/DELETE（根据API需求选择）

URL：你的数据库API地址

Headers：

Content-Type: application/json

Authorization: Bearer your_api_token（如果需要）

下面例子为我在某项目中的其中一个例子，Get的请求方式获取ERP系统中的库存数据：

步骤3：测试接口和节点

可以直接在Http请求节点，按以下操作：

注意事项

• 确保API接口的安全性，使用HTTPS
• 合理设置请求超时时间
• 处理API调用失败的情况
• 注意API调用频率限制

方法二：使用插件工具

插件工具概述

Dify提供了三种主要的数据库插件工具：

1. SQL查询工具：数据库查询工具，支持多种数据库
2. Database工具：连接现有数据库，执行SQL语句和自然语言转SQL
3. SQLite工具：AI代理查询和管理SQLite数据库

工具功能详解

1. SQL查询工具功能

主要功能：

• 直接SQL查询：支持编写和执行标准SQL语句
• 多数据库支持：兼容MySQL、PostgreSQL、SQL Server、Oracle等主流数据库
• 参数化查询：支持动态参数，防止SQL注入攻击
• 结果格式化：自动格式化查询结果，便于阅读和处理
• 错误处理：提供详细的错误信息和调试建议

适用场景：

• 需要执行复杂SQL查询的场景
• 对查询性能有较高要求的应用
• 需要精确控制SQL语句的情况
• 数据库管理员和开发人员使用

2. Database工具功能

主要功能：

SQL Execute：在已存在的数据库中执行SQL查询

• 支持完整的SQL语法（DDL、DML、DCL）
• 可以执行复杂的多表关联查询
• 支持事务处理和批量操作

Text to SQL：自然语言转SQL功能

• 用户可以用自然语言描述查询需求
• AI自动生成对应的SQL语句
• 支持上下文理解和智能优化

Get Table Schema：获取数据库表结构

• 自动获取表的字段信息
• 显示字段类型、约束、索引等详细信息
• 便于了解数据库结构

CSVQuery：在CSV文件上运行SQL查询

• 支持CSV文件作为数据源
• 可以像操作数据库表一样查询CSV数据
• 适用于数据分析和报表生成

适用场景：

• 需要自然语言查询的场景
• 数据分析师和业务人员使用
• 快速原型开发和测试
• 复杂业务逻辑的数据处理

3. SQLite工具功能

主要功能：

创建表 (Create Table)：使用SQL CREATE TABLE语句创建新表

• 支持完整的表结构定义
• 可以设置字段类型、约束、索引等
• 适用于数据库初始化和管理

删除表或行 (Delete Table or Row)：使用SQL DELETE或DROP语句删除表或行

• 支持删除整个表或特定行
• 提供数据清理和管理功能
• 支持条件删除操作

插入行 (Insert Row)：使用SQL INSERT语句插入行

• 支持单行和多行插入
• 可以指定字段和值
• 适用于数据录入和导入

插入行 (JSON) (Insert Row (JSON))：使用JSON字符串插入行

• 支持JSON格式的数据插入
• 可以插入JSON对象数组
• 便于处理结构化数据

查询行 (QueryRow)：使用SQL SELECT语句查询行

• 支持复杂的查询条件
• 可以执行多表关联查询
• 提供数据检索和分析功能

更新行 (Update Row)：使用SQL UPDATE语句更新行

• 支持条件更新操作
• 可以批量更新数据
• 适用于数据维护和修改

更新行 (JSON) (Update Row (JSON))：使用JSON字符串更新行

• 支持JSON格式的数据更新
• 可以批量更新多个字段
• 便于处理复杂的数据结构

适用场景：

• 轻量级应用开发
• 移动应用后端数据
• 临时数据存储和处理
• 原型开发和测试环境

安装和配置步骤

第一步：安装插件工具

1. 进入Dify管理后台

• 登录Dify平台
• 选择”工具”选项

2. 搜索并安装数据库工具

在Dify市场中搜索”SQL”、”Database”或”SQLite”

找到对应的插件工具

点击”安装”按钮

3. 验证安装

安装完成后，在工具列表中应该能看到新安装的数据库工具

确保工具状态为”已启用”

第二步：配置数据库连接

重要提示：这是最关键的步骤，配置错误会导致连接失败！

1）SQL查询工具使用和配置

工具使用（下面以工作流为例子）：

新建工作流，添加插件到工作流中：

配置参数详解：

点击节点我们可以看到有相关的参数需要配置

数据库类型：用于选择数据库类型，mysql、oracle、oracle11g、postgresql或mssql。

数据库地址：数据库服务器IP地址或域名

端口：数据库端口号（MySQL默认3306，PostgreSQL默认5432）

库名：要连接的数据库名称

用户名：数据库用户名

密码：数据库密码

SQL查询语句：需查查询数据的SQL语句

配置示例

数据库类型：MySQL

主机地址：192.168.1.100

端口：3306

数据库名：myapp_db

用户名：dify_user

密码：your_secure_password

2. Database工具使用和配置

重要提示：Database工具安装后需要先进行授权配置，然后才能配置数据库参数。

第一步：API Key授权配置

• 安装Database工具后，在工具配置界面会看到”API Key 授权配置”按钮
• 点击该按钮进行授权配置
• 根据提示输入相应的API Key或认证信息
• 确保授权状态显示为”已授权”

以下为授权的具体操作：

凭据名称：可以自己填写（我是填写Dify_Data)

目前这个项目支持的数据库有

mysql，postgresql，sqlite，sqlserver，oracle

mysql+pymysql://root:123456@localhost:3306/test

postgresql+psycopg2://postgres:123456@localhost:5432/test

sqlite:///test.db

mssql+pymssql://<username>:<password>@<freetds_name>/?charset=utf8

oracle+oracledb://user:pass@hostname:port[/dbname][?service_name=<service>[&key=value&key=value…]]oracle+oracledb://user:pass@hostname:port[/dbname][?service_name=<service>[&key=value&key=value…]]er:pass@hostname:port[/dbname][?service_name=<service>[&key=value&key=value…]]

我提供mysql参考上述链接字符串

mysql+pymysql://root:123456@localhost:3306/dify_test

这里还有一个小技巧，就是如果数据库密码是带有@符号的，我们需要转义一下。否自会出现错误。

上述因为密码也带有特殊符号“@” 和后面的数据链接符号@产生了歧义 这样程序连接就会报错

如何解决

若要借助转义的方式来处理包含特殊字符@的连接字符串，在标准的数据库连接字符串里，一般没有通用转义符号能直接用在字符串里。不过可以对特殊字符@进行 URL 编码，@对应的 URL 编码是%40。

最后的变成

mysql+pymysql://root:zzz%40123@192.168.11.84:19030/test_db

这样修改后在连接就OK 了

看到授权成功了，那就可以开始使用了

同样新建工作流（下面也是以工作流为例），在工作流中增加节点。

以下为我在某项目中的实际案例，我主要使用了Text2sql的数据库查询：

工作流中使用：

Database工具功能说明：

Database工具提供4个主要功能：

1. SQL Execute：在已存在的数据库中执行SQL查询
2. Text to SQL：提供数据库上下文和用户问题，生成SQL语句
3. Get Table Schema：从数据库中获取表结构
4. CSVQuery：在CSV文件上运行SQL查询

3. SQLite工具配置

重要提示：SQLite工具安装后，需要先进行API Key授权配置，然后才能配置数据库参数。

第一步：API Key授权配置

• 安装SQLite工具后，在工具配置界面会看到”API Key 授权配置”按钮
• 点击该按钮进行授权配置
• 根据提示输入相应的API Key或认证信息
• 确保授权状态显示为”已授权”

第二步：配置数据库连接参数

授权完成后，配置以下参数：

配置参数详解：

数据库文件路径：本地SQLite数据库文件路径（例如：/data/sqlite.db）或内存数据库：勾选此项使用内存数据库，数据不会持久化

1. 本地文件数据库

文件路径：/data/myapp.db

权限：确保Dify有读写权限

2. 云数据库连接

数据库URL：https://your-sqlite-cloud.com/database

认证信息：用户名和密码或API密钥

3. 内存数据库

类型：内存数据库

用途：临时数据存储，测试环境

注意：重启后数据会丢失

高级配置

1. 连接池配置

最大连接数：10-50（根据并发需求调整）

连接超时：30秒

查询超时：60秒

空闲超时：300秒

2. 安全配置

SSL连接：启用SSL/TLS加密

证书验证：验证服务器证书

防火墙设置：只允许Dify服务器IP访问数据库

3. 性能优化

索引优化：为常用查询字段创建索引

查询优化：避免SELECT *，只查询需要的字段

连接复用：合理使用连接池

SQLite工具功能说明：

SQLite工具提供7个主要功能：

1. 创建表 (Create Table)：使用SQL CREATE TABLE语句创建新表
2. 删除表或行 (Delete Table or Row)：使用SQL DELETE或DROP语句删除表或行
3. 插入行 (Insert Row)：使用SQL INSERT语句插入行
4. 插入行 (JSON) (Insert Row (JSON))：使用JSON字符串插入行，支持表名和JSON对象数组
5. 查询行 (Query Row)：使用SQL SELECT语句查询行
6. 更新行 (Update Row)：使用SQL UPDATE语句更新行
7. 更新行 (JSON) (Update Row (JSON))：使用JSON字符串更新行，支持表名、更新数据和条件

注意权限验证

• 确保数据库用户有足够的权限
• 测试基本的SELECT、INSERT、UPDATE、DELETE操作

常见问题与解决方案

1. 连接失败问题

问题描述：配置完成后无法连接到数据库

可能原因和解决方案：

原因1：网络连接问题

解决方案：

– 检查Dify服务器与数据库服务器之间的网络连通性

– 使用ping命令测试网络连接

– 检查防火墙设置

原因2：数据库服务未启动

解决方案：

– 检查数据库服务状态

– 重启数据库服务

– 查看数据库日志文件

原因3：配置参数错误

解决方案：

– 仔细检查主机地址、端口、用户名、密码

– 确认数据库名称是否正确

– 验证字符集和时区设置

2. 权限问题

问题描述：连接成功但无法执行某些操

– 为用户授予必要权限

GRANT SELECT, INSERT, UPDATE, DELETE ON database_name.* TO ‘username’@’host’;

GRANT CREATE, DROP, ALTER ON database_name.* TO ‘username’@’host’;

FLUSH PRIVILEGES;

3. 性能问题问题描述：查询速度慢

解决方案：

— 创建索引

CREATE INDEX idx_user_status ON users(status);

CREATE INDEX idx_user_created_at ON users(created_at);

— 优化查询

SELECT id, name, email FROM users WHERE status = ‘active’ LIMIT 100;

4. 插件工具不显示

问题描述：安装插件后在工作流中找不到解决方案：检查插件是否正确安装和启用刷新浏览器页面检查Dify版本兼容性联系Dify技术支持

5. Database工具授权问题问题描述：Database工具安装后无法配置数据库连接解决方案：确保已完成API Key授权配置检查授权状态是否显示为”已授权”如果授权失败，检查API Key是否正确重新进行授权配置授权完成后才能配置数据库连接参数

6. SQLite工具授权问题问题描述：SQLite工具安装后无法配置数据库连接或执行操作解决方案：确保已完成API Key授权配置检查授权状态是否显示为”已授权”如果授权失败，检查API Key是否正确重新进行授权配置授权完成后才能配置数据库连接参数和执行操作

最佳实践建议

1. 安全性建议

数据库安全：

• 使用强密码
• 定期更换密码
• 限制数据库访问IP
• 启用SSL连接
• 定期备份数据

API安全：

• 使用HTTPS协议
• 实现API认证机制
• 限制API调用频率
• 记录API访问日志

2. 性能优化建议

查询优化：

• 避免使用SELECT *
• 合理使用索引
• 分页查询大数据集
• 使用连接池

配置优化：

• 调整连接池大小
• 设置合理的超时时间
• 启用查询缓存
• 定期清理无用数据

3. 监控和维护

监控指标：

• 数据库连接数
• 查询响应时间
• 错误率
• 资源使用率

维护任务：

• 定期备份数据
• 清理日志文件
• 更新数据库版本
• 优化数据库性能

4. 开发建议

代码规范：

• 使用参数化查询防止SQL注入
• 合理处理异常情况
• 记录详细的操作日志
• 实现数据验证机制

测试建议：

• 在测试环境充分测试
• 模拟各种异常情况
• 进行压力测试
• 验证数据一致性

总结

Dify平台连接数据库提供了两种灵活的方法：API接口接入和插件工具接入。选择哪种方法取决于你的具体需求和环境。

API接口接入适合：

• 有现成数据库API的场景
• 需要复杂业务逻辑的场景
• 对安全性要求较高的场景

插件工具接入适合：

• 直接连接数据库的场景
• 需要自然语言转SQL的场景
• 快速开发和测试的场景

无论选择哪种方法，都要注意安全性、性能和可维护性。希望这份保姆式教程能够帮助你成功连接Dify平台与数据库，如果遇到问题，可以参考常见问题部分或联系技术支持。