跳到主要内容

数据查询

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

先看术语​

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

功能入口​

登录 GatewayRuntime Web 后，点击左侧菜单“数据与告警 → 数据查询”。

数据查询页面

页面结构​

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

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

查询前确认​

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

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

实时数据​

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

控件或列说明
转发目标选择实时数据目标。目标来自数据转发中的实时数据目标。
变量 ID按变量 ID 多选筛选，支持远程搜索变量。
自动刷新开启后按设定间隔刷新数据，可暂停或恢复。
刷新立即重新加载当前查询条件下的数据。
导出导出当前查询条件下的实时数据。
列设置控制表格列显示。
变量名称变量名称。
设备名称变量所属设备名称。
变量 ID变量唯一 ID。
当前值目标中保存的当前值。
在线显示变量是否在线。
采集时间变量采集时间。
更新时间实时数据目标记录更新时间。

历史数据​

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

控件或列说明
转发目标选择历史数据目标或自定义 SQL 目标。
数据类型普通历史数据目标可选择数值数据或字符串数据。
时间范围选择查询开始时间和结束时间。
变量 ID按变量 ID 多选筛选。自定义 SQL 目标不显示该筛选项。
刷新重新加载历史数据。
导出导出当前查询条件下的历史数据。
列设置普通历史数据目标可控制列显示。
表格以表格查看历史记录。
图表普通历史数据目标可切换到图表视图，查看趋势曲线。
设备名称变量所属设备名称。
变量名称变量名称。
变量 ID变量唯一 ID。
值历史记录值。
采集时间变量采集时间。
在线历史记录对应的在线状态。
创建时间历史记录写入时间。
自定义列自定义 SQL 目标会按目标表列动态显示。

查询步骤​

  1. 进入“数据与告警 → 数据查询”。
  2. 根据需要切换“实时数据”或“历史数据”页签。
  3. 选择转发目标。
  4. 实时数据可选择变量 ID 并开启自动刷新；历史数据应选择时间范围、数据类型和变量 ID。
  5. 点击刷新查看结果。
  6. 需要归档时点击导出。

使用注意​

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

故障处理​

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

相关链接​

最后由 Diego 于 更新