数据源管理
数据源统一维护数据库连接。配置完成后，GoView 从下拉列表选择数据源，无需填写数据库地址和密码。
操作入口：报表管理 → 报表数据源配置管理。 本页供数据源管理员使用；制作报表时已有可用数据源，可直接进入查询模板配置。
列表中的“新增”用于配置连接，“查询数据”用于调试模板。下文表单截图使用示例主机名和账号，密码留空，仅说明填写位置；不代表连接已保存或测试成功。
新增数据源
- 点击“新增”。
- 填写基本信息，选择数据库类型。
- 按数据库类型填写连接信息。
- 点击“测试草稿连接”，成功后点击“保存”。
- 在列表中对已保存的数据源点击“测试连接”，随后用“查询数据”验证实际查询。
基本信息
| 字段 | 填写说明 |
|---|---|
| 数据源名称 | 填写便于识别的业务名称，例如“运营报表 MySQL” |
| 数据源编码 | 小写字母、数字、下划线或横线，1～64 字符；创建后不可修改 |
| 数据库类型 | MYSQL、ES、TDENGINE、REDIS；创建后不可修改 |
| 密码 | 填写实际连接密码；已保存的密码不会在详情中回显 |
| 状态 | 选择“启用”后才可用于签发新查询和执行查询 |
| 备注 | 说明业务用途，不填写密码、令牌等敏感内容 |
连接信息
| 类型 | 必须核对的连接信息 | 默认值与说明 |
|---|---|---|
| MYSQL | 主机、端口、数据库、用户名、密码、TLS | 端口默认 3306 |
| ES | 节点协议、主机、端口、用户名和密码 | 支持 1～5 个节点；协议 http/https，端口默认 9200 |
| TDENGINE | 主机、实际 REST 端口、数据库、用户名和密码 | 协议选择“REST（独立 HTTP 连接）”；端口必须明确填写 |
| REDIS | 主机、端口、Redis DB、用户名、密码、TLS | 端口默认 6379，DB 默认 0；用户名按实际 ACL 配置 |
主机或节点地址只填写主机名或 IP。协议、端口已有独立输入框，不要把 URL、路径、用户名或密码拼入主机字段。默认端口仅作初始值，以维护人员提供的信息为准。
数据库账号应由维护人员设置为只读。开启 TLS 时使用有效证书；连接测试不能证明账号只具有读取权限。
MySQL 配置示例
分别填写主机、端口、数据库和用户名。图中的 db.example.invalid 是示例地址，不能直接用于连接；密码和 TLS 按实际环境填写。
Elasticsearch 配置示例
每个节点独立填写协议、主机和端口；需要多个节点时点击“添加节点”。这里配置连接，查询使用的索引及 SQL/DSL 模式在查询模板中选择。
TDengine 配置示例
选择“REST（独立 HTTP 连接）”，填写实际提供 REST 服务的端口。图中的 6041 仅为示例，不是所有环境都使用的固定端口。
Redis 配置示例
Redis DB 是数字编号；用户名是否需要填写取决于实际 ACL 配置。应确认只读账号能够读取模板使用的 Key 前缀。
高级资源限制
没有特殊要求时可先保留默认值，根据实际查询量由管理员调整。
点击“高级资源限制”展开配置。建连、等待、查询、空闲回收的时间单位均为毫秒，最大返回行数单独设置。
| 项目 | 默认值 | 用途 |
|---|---|---|
| 最大连接数 | 3 | 限制该数据源使用的连接资源 |
| 建连超时 | 5000 ms | 限制建立连接的等待时间 |
| 等待超时 | 5000 ms | 限制等待可用资源的时间 |
| 查询超时 | 30000 ms | 限制查询执行时间 |
| 空闲回收 | 600000 ms | 空闲达到设定时间后回收运行资源 |
| 最大返回行数 | 5000 | 限制查询结果行数 |
出现超时、超限时，先缩小时间范围、减少字段和返回数量，再评估是否需要提高限制。不要依赖浏览器截断无限量的查询结果。
测试与保存
| 操作 | 检查对象 | 是否保存配置 |
|---|---|---|
| 测试草稿连接 | 弹窗中当前填写的连接 | 否，成功后仍需点击“保存” |
| 保存 | 数据源配置本身 | 是，但不代表数据库已连通 |
| 列表“测试连接” | 已保存的数据源 | 不修改配置 |
| 查询数据 | 已保存的数据源与具体查询 | 执行真实只读查询，不自动保存查询模板 |
打开列表、查看详情和选择数据源不会主动连接目标数据库。“测试连接”使用临时连接资源；查询运行资源在实际查询时按需使用。
连接成功后，继续按照明文查询调试执行最小查询。返回 0 行可能只是没有符合条件的数据，应结合查询条件判断。
编辑与密码维护
在列表中点击“编辑”，修改后测试并保存。数据源编码和数据库类型不能修改；需要另一种数据库类型时新建数据源。
| 密码操作 | 适用情况 |
|---|---|
| 保留 | 继续使用已保存密码，密码框没有旧值是正常现象 |
| 替换 | 数据库密码已变更，必须填写新密码 |
| 清空 | 连接实际允许无密码，确认后删除已保存密码 |
提示配置版本变化时，关闭并重新打开编辑页，核对最新配置后保存。不要反复提交旧表单覆盖他人的修改。
更换连接目标或身份后，已有查询密文可能失效。请恢复原模板、核对新数据源、重新生成密文，再更新使用该模板的报表，详见模板恢复。
停用与删除
停用后不能为该数据源签发新查询或执行查询，依赖它的报表会受影响。操作前应确认哪些报表仍在使用，并通知相关人员。
需要恢复使用时，启用数据源，测试连接并检查查询；如提示密文绑定变化，重新生成密文。停用源不在加解密下拉列表时，可用原数据源编号恢复模板，不能用该恢复入口继续执行停用源的查询。
删除前确认不再需要该配置，并保留必要的模板与替代数据源安排。不要将删除数据源作为普通查询失败的处理办法。