返回首页

使用指南

数据源配置

概述

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+
  • CSV 文件：单个 CSV 文件或按目录批量导入
  • Excel 文件：支持 .xlsx 文件导入

数据源管理

1. 添加数据源

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

2. 编辑数据源

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

3. 删除数据源

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

4. 复制数据源

  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 数据源通过选择数据库文件确定位置：

  • 数据库文件：SQLite 数据库文件路径（字段为 connection.filename，兼容旧字段 connection.fileName）

SQLite 不需要填写主机、端口、用户名、密码等网络连接信息。

4. CSV 文件数据源

连接参数

  • 管理方式：单文件 / 文件夹
  • 文件路径：CSV 文件路径（单文件模式）
  • 目录路径：CSV 文件夹路径（文件夹模式）
  • 文件匹配：pattern（如 *.csv）
  • 递归扫描：是否递归扫描子目录
  • 生成汇总视图：可选生成一个 all 视图，将匹配到的多个文件按 UNION ALL 汇总（适合做统一查询）
  • 分隔符：字段分隔符，默认 ,
  • 包含表头：是否将首行作为表头
  • 编码：默认 utf-8

CSV/Excel 文件数据源会将文件导入到本地缓存数据库中，再以表的方式提供给查询编辑器使用。文件内容变化后，可在数据源处执行”刷新连接/刷新数据源”触发重新导入。

5. Excel 文件数据源

连接参数

  • 文件路径：Excel 文件路径（.xlsx）
  • 包含表头：是否将首行作为表头
  • 编码：默认 utf-8

数据查询

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

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

数据预览和测试

1. 数据预览

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

2. 数据测试

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

数据源最佳实践

1. 连接管理

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

2. 查询优化

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

3. 数据安全

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

4. 性能优化

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

常见问题

1. 连接失败

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

2. 查询执行缓慢

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

3. 数据显示异常

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