数据源配置

数据源配置

概述

ToChart 支持多种数据源类型，允许您从不同的数据库和文件中获取数据，用于图表和仪表板的设计。

支持的数据源类型

ToChart 当前支持以下关系型数据库数据源：

MariaDB：MariaDB 5.5+
MySQL：MySQL 5.7+
PostgreSQL：PostgreSQL 9.5+
SQLite：SQLite 3.0+
Oracle：Oracle 11g+
SQL Server：SQL Server 2012+

数据源管理

1. 添加数据源

点击左侧导航栏中的「数据源」图标
在资源管理器中点击「新建数据源」按钮
选择数据源类型
填写数据源连接信息
点击「测试连接」按钮，验证连接是否成功
点击「保存」按钮，保存数据源

2. 编辑数据源

在资源管理器中选中要编辑的数据源
点击右键，选择「编辑」选项
修改数据源连接信息
点击「测试连接」按钮，验证修改后的连接
点击「保存」按钮，保存修改

3. 删除数据源

在资源管理器中选中要删除的数据源
点击右键，选择「删除」选项
在确认对话框中点击「确定」按钮，删除数据源

4. 复制数据源

在资源管理器中选中要复制的数据源
点击右键，选择「复制」选项
修改新数据源的名称和连接信息
点击「保存」按钮，保存新数据源

数据源配置详情

1. MySQL 数据源

连接参数

主机名/IP：数据库服务器的主机名或 IP 地址
端口：MySQL 服务端口，默认 3306
数据库名：要连接的数据库名称
用户名：数据库登录用户名
密码：数据库登录密码
字符集：数据库字符集，默认 utf8mb4
SSL 连接：是否使用 SSL 连接

高级选项

连接超时：连接超时时间，单位秒
查询超时：查询超时时间，单位秒
最大连接数：最大连接池大小

2. PostgreSQL 数据源

连接参数

主机名/IP：数据库服务器的主机名或 IP 地址
端口：PostgreSQL 服务端口，默认 5432
数据库名：要连接的数据库名称
用户名：数据库登录用户名
密码：数据库登录密码
SSL 连接：是否使用 SSL 连接

高级选项

连接超时：连接超时时间，单位秒
查询超时：查询超时时间，单位秒
模式：数据库模式，默认 public

3. SQLite 数据源

连接参数

文件路径：SQLite 数据库文件的绝对路径
只读模式：是否以只读模式打开数据库

4. CSV 文件数据源

连接参数

文件路径：CSV 文件的绝对路径
分隔符：字段分隔符，默认逗号
编码：文件编码，默认 UTF-8
包含表头：文件是否包含表头行
引用字符：字段引用字符，默认双引号

5. REST API 数据源

连接参数

URL：API 请求 URL
请求方法：GET、POST、PUT、DELETE 等
请求头：API 请求头信息
请求体：API 请求体数据
认证方式：无认证、基本认证、API Key、OAuth 等

高级选项

响应数据路径：从响应中提取数据的 JSON Path
刷新间隔：数据自动刷新间隔，单位秒

数据查询

ToChart 支持直接编写 SQL 查询语句：

在图表设计器的「数据」标签页中，选择数据源
在查询编辑器中编写 SQL 查询语句
点击「预览数据」按钮，查看查询结果
调整查询语句，直到获得满意的结果

数据预览和测试

1. 数据预览

在数据源配置页面，点击「测试连接」按钮，验证连接是否成功
在查询编辑器中，点击「预览数据」按钮，查看查询结果
数据预览显示前 100 行数据，便于验证查询结果

2. 数据测试

检查数据类型是否正确
验证数据完整性
测试数据量大小，评估查询性能

数据源最佳实践

1. 连接管理

使用连接池管理数据库连接，提高性能
合理设置连接超时和查询超时时间
定期检查数据源连接状态

2. 查询优化

编写高效的 SQL 查询语句
避免在查询中使用复杂的计算和子查询
合理使用索引
限制返回的数据量，只查询必要的字段

3. 数据安全

不要在数据源配置中使用管理员账号
为不同的数据源创建专用的数据库用户，授予最小必要权限
定期更换数据库密码

4. 性能优化

对于大数据集，考虑使用数据聚合和预计算
合理设置数据刷新间隔
使用缓存机制，减少数据库查询次数

常见问题

1. 连接失败

检查数据库服务器是否正在运行
验证主机名/IP 和端口是否正确
检查用户名和密码是否正确
确认数据库是否存在
检查防火墙设置，确保允许应用访问数据库端口

2. 查询执行缓慢

优化 SQL 查询语句
检查数据库索引是否合理
考虑增加数据库服务器资源
减少返回的数据量

3. 数据显示异常

检查数据类型是否匹配
验证数据格式是否正确
检查数据映射是否正确
查看控制台日志，获取详细错误信息