数据源（商业版）功能详解

本文档详细介绍 AIFlowy 平台中的数据源功能（商业版），帮助您全面了解如何配置和管理外部数据库连接，为智能体提供实时数据查询能力。

注意： 数据源功能，仅在商业版提供（开源版没有此功能）。

一、功能概述

1.1 什么是数据源

数据源是 AIFlowy 平台（商业版）提供的外部数据库连接管理功能，允许用户将外部数据库接入平台，使智能体能够直接查询和访问业务数据，实现实时数据问答和分析。

1.2 核心价值

价值	说明
实时数据访问	智能体可以直接查询外部数据库，获取最新业务数据
多数据库支持	支持 MySQL、Oracle、SQL Server、PostgreSQL、OceanBase、达梦、高斯等多种数据库
安全连接	支持数据库连接测试，确保配置正确后再使用
智能体集成	数据源可挂载到智能体，增强智能体的数据查询能力

1.3 应用场景

• 业务数据实时查询
• 数据库智能问答
• 数据分析和报表生成
• 业务系统数据集成

二、支持的数据库类型

数据源功能支持以下数据库类型：

类型	标识	默认 JDBC URL 格式	默认端口
MySQL	0	jdbc:mysql://127.0.0.1:3306/aiflowy?useInformationSchema=true&characterEncoding=utf-8	3306
Oracle	1	jdbc:oracle:thin:@//127.0.0.1:1521/aiflowy	1521
SQL Server	2	jdbc:sqlserver://127.0.0.1:1433;databaseName=aiflowy;encrypt=false	1433
PostgreSQL	3	jdbc:postgresql://127.0.0.1:5432/aiflowy	5432
OceanBase	4	jdbc:oceanbase://127.0.0.1:2881/aiflowy	2881
达梦数据库	5	jdbc:dm://127.0.0.1:5236/aiflowy	5236
高斯数据库	6	jdbc:gaussdb://127.0.0.1:8000/aiflowy	8000

说明: 选择数据库类型后，系统会自动填充默认的 JDBC URL 格式，您可以根据实际情况修改。

三、数据源管理

3.1 数据源列表

进入 数据源 页面，可以看到所有已配置的数据源列表，包含以下信息：

字段	说明
数据源类型	数据库类型（MySQL、Oracle 等）
数据源别名	数据源的显示名称
数据源描述	数据源的描述信息
数据库名	数据库的名称标识
创建时间	数据源创建的时间

3.2 创建数据源

操作步骤:

1. 进入 数据源 页面
2. 点击右上角 添加 按钮
3. 在弹窗中填写数据源信息：

字段	必填	说明
数据源类型	是	选择数据库类型（MySQL、Oracle、SQL Server 等）
数据源别名	是	数据源的显示名称，便于识别
数据源描述	否	数据源的详细描述
数据库名	是	数据库的名称标识
数据库地址	是	数据库的 JDBC 连接地址
用户名	否	数据库访问用户名
密码	否	数据库访问密码

4. 点击 测试连接 验证数据库连接是否正常
5. 连接测试通过后，点击 保存 完成创建

3.3 编辑数据源

1. 在数据源列表中找到需要编辑的数据源
2. 点击 编辑 按钮
3. 修改数据源配置信息
4. 点击 测试连接 验证修改后的配置
5. 点击 保存 完成修改

3.4 删除数据源

1. 在数据源列表中找到需要删除的数据源
2. 点击操作栏的 更多 按钮
3. 选择 删除
4. 确认删除操作

注意: 删除数据源前，请确保没有智能体正在使用该数据源。

3.5 查看数据表

1. 在数据源列表中找到目标数据源
2. 点击 表信息 按钮
3. 进入数据表信息页面，查看该数据库中的所有表结构

四、数据源配置详解

4.1 数据库地址配置

数据库地址使用 JDBC URL 格式，不同数据库的格式有所不同：

MySQL 示例:

jdbc:mysql://192.168.1.100:3306/mydb?useInformationSchema=true&characterEncoding=utf-8

PostgreSQL 示例:

jdbc:postgresql://192.168.1.100:5432/mydb

Oracle 示例:

jdbc:oracle:thin:@//192.168.1.100:1521/orcl

SQL Server 示例:

jdbc:sqlserver://192.168.1.100:1433;databaseName=mydb;encrypt=false

4.2 连接参数说明

参数	说明
useInformationSchema	MySQL 特有，启用信息模式查询
characterEncoding	字符编码设置
encrypt	SQL Server 特有，是否启用加密
databaseName	SQL Server 特有，数据库名称

4.3 测试连接

在保存数据源配置之前，建议先进行测试连接：

1. 填写完整的数据库连接信息
2. 点击 测试连接 按钮
3. 系统会尝试连接数据库并返回结果
4. 如果连接失败，请检查：
   • 数据库地址是否正确
   • 端口是否开放
   • 用户名和密码是否正确
   • 数据库服务是否正常运行
   • 防火墙是否允许连接

五、智能体挂载数据源

5.1 功能说明

数据源可以挂载到智能体，使智能体能够直接查询外部数据库中的数据，实现智能数据问答。

5.2 挂载步骤

1. 进入智能体配置页面
2. 在 技能模块 中找到 数据源 折叠面板
3. 点击 + 按钮添加数据源
4. 在弹窗中选择要挂载的数据源
5. 点击确认完成挂载

5.3 数据源使用

智能体挂载数据源后，用户可以通过自然语言查询数据库：

示例对话:

• 用户: "查询上个月的销售数据"
• 智能体: 自动生成 SQL 查询并返回结果

示例对话:

• 用户: "统计各部门的员工数量"
• 智能体: 自动生成 SQL 查询并返回统计结果

5.4 管理已挂载数据源

在智能体配置页面：

• 查看已挂载的数据源列表
• 点击 删除 按钮移除数据源
• 点击 + 按钮添加新的数据源

六、数据源与数据中枢的区别

特性	数据源	数据中枢
数据来源	外部数据库	平台内部数据库
数据管理	只读查询	增删改查
数据结构	使用外部数据库表结构	平台自定义表结构
使用场景	查询外部业务系统数据	管理工作流产生的业务数据
数据写入	不支持	支持
Excel 导入导出	不支持	支持

七、最佳实践

7.1 安全建议

• 最小权限原则: 为数据源创建专用的数据库账号，只授予必要的查询权限
• 网络隔离: 确保数据库服务器与 AIFlowy 服务器之间的网络安全
• 密码管理: 定期更换数据库密码
• 连接测试: 配置完成后务必进行测试连接

7.2 性能建议

• 连接池配置: 合理配置数据库连接池大小
• 查询优化: 避免复杂的全表扫描查询
• 索引优化: 为常用查询字段创建索引
• 只读账号: 建议使用只读账号连接数据库

7.3 命名规范

• 数据源别名: 使用有意义的名称，如"生产环境-MySQL-订单库"
• 数据库名: 使用小写字母和下划线，如 order_db
• 描述信息: 详细说明数据源的用途和环境

7.4 环境管理

• 环境隔离: 为开发、测试、生产环境分别配置数据源
• 版本管理: 记录数据源配置的变更历史
• 备份策略: 定期备份数据源配置信息

八、常见问题

Q1: 测试连接失败怎么办？

可能原因:

• 数据库地址或端口不正确
• 用户名或密码错误
• 数据库服务未启动
• 防火墙阻止连接
• JDBC URL 格式不正确

解决方法:

1. 检查数据库服务是否正常运行
2. 验证数据库地址和端口
3. 确认用户名和密码
4. 检查防火墙设置
5. 参考默认 JDBC URL 格式修改配置

Q2: 支持哪些数据库？

支持的数据库:

• MySQL
• Oracle
• SQL Server
• PostgreSQL
• OceanBase
• 达梦数据库
• 高斯数据库

Q3: 数据源可以写入数据吗？

说明:

• 数据源主要用于只读查询
• 如需写入数据，建议使用数据中枢功能
• 可以通过工作流实现数据写入逻辑

Q4: 如何确保数据安全？

安全建议:

• 使用只读数据库账号
• 限制数据库账号的访问权限
• 使用内网连接数据库
• 定期审查数据源访问日志
• 启用数据库审计功能

Q5: 数据源和数据中枢可以同时使用吗？

说明:

• 可以同时使用数据源和数据中枢
• 智能体可以同时挂载数据源和数据中枢
• 根据业务需求选择合适的功能

Q6: 修改数据源配置会影响已挂载的智能体吗？

说明:

• 修改数据源连接信息后，已挂载的智能体会使用新的配置
• 建议修改前进行测试连接
• 修改后建议测试智能体的数据查询功能