数据查询

数据查询用于查看 GatewayRuntime 已写入实时数据目标（当前值存储）和历史数据目标（按时间存储）的数据。页面分为“实时数据”和“历史数据”两个页签，适合运维人员确认采集值、转发落库结果和历史趋势。

先看术语

术语	现场理解
实时数据目标	保存每个变量最新值的存储目标，类似“当前值表”。
历史数据目标	按时间记录变量值的存储目标，用于趋势、追溯和导出。
自定义 SQL 宽表	按项目要求自定义表结构的历史数据表，字段可能不是标准变量列。
转发目标	数据写入的位置。数据查询页看到的数据来自数据转发目标，不是从 PLC 重新读取。
变量 ID	变量在系统内的唯一编号。变量改名后，ID 仍可用于精确筛选。
采集时间 / 更新时间	采集时间是网关拿到变量值的时间；更新时间是目标表记录被写入或更新的时间。

数据查询页面

页签	说明
实时数据	查询实时数据目标中的当前变量值。
历史数据	查询历史数据目标或自定义 SQL 宽表中的历史记录，并支持表格和图表视图。

实时数据和历史数据的目标来自数据转发中配置的对应目标。没有配置或目标未写入数据时，页面会显示暂无数据。

数据查询页查看的是“已经由数据转发目标写入的数据”，不是直接从 PLC 重新读取。现场查不到数据时，先确认数据链路走通，再判断查询条件。

检查项	说明
采集侧	变量在“采集配置”或“内存计算”中有当前值，状态正常。
转发侧	已配置实时数据、历史数据或自定义 SQL 目标，并且目标已启用、在线。
变量范围	数据转发组包含要查询的变量，在线过滤、采样策略没有把数据排除。
时间范围	历史查询的开始和结束时间覆盖采集时间，并确认网关时间同步正常。
权限	当前账号具备数据查询、导出和目标访问权限。

实时数据页签用于查询实时数据目标中的当前记录。

历史数据页签用于查询历史数据目标中的数值、字符串或自定义 SQL 宽表数据。

场景	建议
目标为空	先在“开发配置 → 数据转发”中配置并启用实时数据或历史数据目标。
页面无数据	检查转发目标是否运行、变量范围是否包含目标变量、时间范围是否正确。
实时数据不刷新	检查自动刷新是否暂停，或手动点击刷新。
历史数据查不到	确认历史数据目标已写入数据，查询时间范围覆盖采集时间。
图表不显示	图表仅适用于普通历史数据目标；自定义 SQL 目标只显示动态表格。
导出数据量大	缩小时间范围或变量范围，避免一次导出过多记录。

现象	处理建议
转发目标下拉为空	检查数据转发目标类型是否为实时数据、历史数据或自定义 SQL，并确认目标已保存。
变量 ID 搜索不到	确认变量存在且当前用户有查看变量权限。
在线状态异常	回到“采集配置”或“内存计算”查看变量运行状态和错误信息。
历史曲线断点	检查变量采集周期、历史数据采样策略、网络状态和目标缓存。
导出失败	缩小查询范围后重试，并查看系统日志中的后台日志。