ToChart

# 数据源配置

# 概述

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. 添加数据源

  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 数据库文件的绝对路径
  • 只读模式：是否以只读模式打开数据库

# 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. 数据显示异常

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

← 高级功能 →