SY/T 7797-2024 油气工业互联网平台架构与集成规范

　　ICS75-010CCSE07

　　中华人民共和国石油天然气行业标准

　　SY/T7797—2024

　　油气工业互联网平台架构与集成规范

　　Architecture and integration specification ofindustrial internet platformfor oiland gasindustry

　　2024-09-24发布2025-03-24实施

　　国家能源局发布

　　SY/T7797—2024

　　目次

　　前言 Ⅲ

　　1范围 1

　　2规范性引用文件 1

　　3 术语和定义 1

　　4缩略语 2

　　5平台架构 2

　　6边缘层 3

　　6.1 数据采集 3

　　6.2边缘计算 3

　　6.3 数据上云 3

　　6.4边缘管理 4

　　7网络层 4

　　8平台层 4

　　8.1 油气PaaS平台 4

　　8.2油气大数据 5

　　8.3 油气建模分析 6

　　8.4 油气微服务 6

　　9应用层 6

　　9.1油气APP监管 6

　　9.2油气APP市场 6

　　10 系统安全防护体系 7

　　10.1 管理安全 7

　　10.2数据安全 7

　　10.3 系统安全 7

　　10.4 应用安全 7

　　附录A (资料性)边缘采集数据内容及接口 8

　　附录B (资料性)边缘处理接口 13

　　附录C (资料性)油气大数据集成接口 15

　　附录D (资料性)通用信息系统数据集成接口 16

　　附录E (资料性)油气大数据存储接口 20

　　SY/T 7797—2024

　　附录F (资料性)油气大数据建模分析接口 21

　　附录G (资料性)油气微服务目录接口 22

　　参考文献 24

　　SY/T7797—2024

　　前

　　本文件按照GB/T1.1—2020《标准化工作导则

　　言

　　第1部分：标准化文件的结构和起草规则》的 规定起草。

　　请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

　　本文件由石油工业标准化技术委员会石油信息与计算机应用专业标准化委员会提出并归口。

　　本文件起草单位：昆仑数智科技有限责任公司、中国石油集团有限公司数字和信息化管理部、中国石油化工集团有限公司、石化盈科信息技术有限责任公司、中海石油气电集团有限责任公司信息技术中心、中国海洋石油集团有限公司信息技术中心、中国石油天然气股份有限公司勘探开发研究院。

　　本文件主要起草人：裴沛、孙东旭、曾高辉、李国美、侯振宇、刘东菊、赵学良、索寒生、廖爱明、王杰、贾文清、韩永强。

　　油气工业互联网平台架构与集成规范

　　1范围

　　本文件给出了油气工业互联网平台架构及集成方法，规定了边缘层、网络层、平台层、应用层和系统安全防护体系方面的要求。

　　本文件适用于油气工业互联网平台架构的建设和应用，以及不同平台间集成建设。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。

　　GB/T 20988 信息安全技术信息系统灾难恢复规范

　　GB/T 22239 信息安全技术 网络安全等级保护基本要求

　　GB/T 22240 信息安全技术网络安全等级保护定级指南

　　GB/T25070信息安全技术网络安全等级保护安全设计技术要求

　　GB/T37931信息安全技术Web应用安全检测系统安全技术要求和测试评价方法

　　GB/T 43206 信息安全技术信息系统密码应用测评要求

　　YD/T2698 电信网和互联网安全防护基线配置要求及检测要求网络设备

　　YD/T2699 电信网和互联网安全防护基线配置要求及检测要求安全设备

　　YD/T 2700 电信网和互联网安全防护基线配置要求及检测要求 数据库

　　YD/T 2701 电信网和互联网安全防护基线配置要求及检测要求 操作系统

　　YD/T2702 电信网和互联网安全防护基线配置要求及检测要求 中间件

　　YD/T2703 电信网和互联网安全防护基线配置要求及检测要求web应用系统

　　YD/T3865 工业互联网数据安全保护要求

　　3术语和定义

　　下列术语和定义适用于本文件。

　　3.1

　　工业互联网平台industrialinternetplatform

　　面向制造业数字化、网络化、智能化需求，构建基于海量数据采集、汇聚、分析的服务体系，支撑制造资源泛在连接、弹性供给、高效配置的工业云平台。

　　3.2

　　边缘计算edgecomputing

　　将数据处理、存储放在物联网边缘侧的计算架构。

　　[来源：GB/T41780.1—2022,3.1]

　　SY/T7797—2024

　　3.3

　　数据预处理datapreprocessing

　　对原始数据进行过滤、清洗、聚合、质量优化(剔除坏数据等)和语义解析的过程。

　　3.4

　　数据治理data governance

　　对数据资产管理活动行使权力和控制的活动集合(规划、监控和执行)。

　　注：数据治理职能指导其他数据管理职能如何执行。数据治理制订正确的原则、政策、流程、操作规程，确保以正确的方式对数据和信息进行管理。

　　3.5

　　状态监测conditionmonitoring

　　检测与收集反映机器状态的信息和数据。

　　[来源：GB/T 20921—2007,2.5]

　　4缩略语

　　下列缩略语适用于本文件。

　　APP:应用程序(Application)

　　API:应用程序编程接口(Application Programming Interface)

　　CPU: 中央处理器(CentralProcessingUnit)

　　F5G: 第五代固定网络(The5thGenerationFixedNetworks)

　　GIS:地理信息系统(GeographicInformationSystem)

　　IPv4:互联网协议第四版(InternetProtocolVersion4)

　　IPv6: 互联网协议第六版(Internet Protocol Version 6)

　　JSON:对象简谱(JavaScriptObjectNotation)

　　IAM: 身份认证管理系统(IdentityAuthenticationManagementSystem)

　　LoRa: 远距离无线电(LongRangeRadio)

　　MES: 制造执行系统(ManufacturingExecutionSystem)

　　MQ: 消息队列(MessageQueue)

　　MQTT:消息队列遥测传输(Message Queuing Telemetry Transport)

　　NB-IoT: 窄带物联网(NarrowBandInternetofThings)

　　OLE:对象连接与嵌入(ObjectLinkingandEmbedding)

　　OPC:用于过程控制的OLE(OLEforProcessControl)

　　OT:运营技术(OperationalTechnology)

　　PaaS:平台即服务(Platform as aService)

　　TSN:时间敏感网络(Time-SensitiveNetwork)

　　URL:统一资源定位系统(UniformResourceLocator)

　　WiFi6: 第六代无线网络技术(6th Generation Wireless Fidelity)

　　XML: 可扩展标记语言(ExtensibleMarkupLanguage)

　　5平台架构

　　油气工业互联网平台包括边缘层、网络层、平台层、应用层、系统安全防护体系五个方面。平台架构见图1。

　　图1平台架构图

　　6边缘层

　　6.1数据采集

　　数据采集模块应能通过设备工控系统、设备传感器、工艺实时数据、设备在线监测系统等各类数据采集接口，对油气行业现场各类应用场景的生产运行数据、状态监测数据、音视频数据等数据信息进行采集。

　　边缘数据采集接口宜满足：

　　——传输方式：通过HTTP/OPC/WebService来进行消息传输;

　　——输入参数：以JSON/XML/ 字符串/二进制流的方式传输;

　　——请求方式：对应于HTTP/WebService使用GET方法;

　　——返回值：定义返回值类型JSON/XML/ 二进制流格式;

　　——授权证书：授权码或认证。

　　油气行业典型业务应用场景数据采集内容及接口定义见附录A。

　　6.2边缘计算

　　边缘计算模块应能通过边缘计算主程序进行实时数据智能处理。用户通过配置管理功能，对边缘计算主程序及计算模型、规则进行配置。

　　边缘计算模块应提供事件类接口和控制类接口。边缘计算类接口宜满足：

　　——传输方式：通过MQ或者MQTT来进行消息传输;

　　——输入参数：以JSON/XML/ 字符串/二进制流的方式传输;

　　——请求方式：支持CREATE、UPDATE、DELETE、SELECT四种操作;

　　——授权证书：授权码。

　　事件类和控制类接口示例见附录B。

　　6.3数据上云

　　数据上云模块应提供数据传输、传输监控、断点续传等功能，将边缘层数据加密、压缩后转发至 平台层管理软件，并根据网络状况和缓存策略进行本地数据缓存。在数据传输过程中应能查看消息统计、服务器状态等传输状态信息。

　　数据上云模块提供运行类接口，为边缘层数据提供数据传输服务。边缘数据上云类接口宜满足：——传输方式：通过MQTT来进行消息传输;

　　——输入参数：以JSON/XML/ 字符串/二进制流的方式传输;

　　——返回值：定义返回值类型JSON/XML/ 二进制流格式。

　　6.4边缘管理

　　6.4.1设备管理

　　设备管理模块应能对现场设备、智能网关进行管理。通过为用户开通、设置相关权限，赋予设备管理能力。

　　6.4.2数据管理

　　数据管理模块应衔接数据处理与数据上云程序，包含边缘数据收集、运行监控、预警等功能。

　　7网络层

　　网络层应能通过F5G、5G、NB-IoT、LoRa、IPv4、IPv6、WiFi6、TSN等通信技术，组成企业专网、4G 网络、5G 网络、工业环网等在设备端和控制器端的应用，在保障安全的前提下打通企业工业控制网、管理信息网和无线网，建设IT-OT融合网络，以地理空间为参考系，帮助企业建立覆盖范围更广、连接更多、带宽更大的基础网络，通过IPv4、IPv6等通信协议，以满足对海量过程数据的采集、传输、分析需要。

　　8平台层

　　8.1油气PaaS平台

　　8.1.1项目管理

　　项目管理功能应支持敏捷项目管理与传统项目管理。通过为用户开通、设置项目管理相关权限，提供项目管理能力。

　　8.1.2源码管理

　　源码管理功能应支持与代码及环境集成，实现源代码的版本、分支、合并、导入导出等。通过为用户开通、设置源码管理相关权限，提供源码管理能力。

　　8.1.3流水线管理

　　流水线管理功能应支持项目个性化流水线创建与修改，以及代码更新获取、持续构建、自动编译、执行测试、自动打包等一系列能力。通过为用户开通、设置流水线管理相关权限，提供流水线管理能力。

　　8.1.4油气应用管理

　　油气应用管理功能应能对各类应用镜像进行上下架、版本更新、订阅发布。通过为用户开通、设 置油气应用管理权限，提供油气应用管理能力。

　　8.1.5部署管理

　　部署管理功能应能对油气应用进行资源分配、参数配置及发布上线等。通过为用户开通、设置部署管理的相关权限，提供部署管理能力。

　　8.2油气大数据

　　8.2.1数据集成

　　8.2.1.1实时数据集成

　　实时数据集成功能应支持对边缘层已采集实时数据的接入、转换、处理、分发。实时数据集成接口定义示例见附录C。

　　8.2.1.2关系数据集成

　　关系数据集成功能应支持不同信息系统的关系型数据库及存储类型之间数据迁移，完成对油气生产现场关系型数据的集成。信息系统关系型数据集成接口定义示例见附录D。

　　8.2.1.3非结构化数据集成

　　非结构化数据集成功能应支持不同非结构化数据库及存储类型之间数据迁移，完成对油气工业中各种图形图像、音视频数据、遥感数据等非结构化工业数据的数据集成。

　　8.2.2数据存储

　　数据存储功能应支持结构化数据存储与非结构化数据存储，实现对数据接入功能采集的结构化和非结构化油气数据的安全、有效存储。数据存储接口定义示例见附录E。

　　8.2.3数据计算

　　数据计算功能应支持对油气实时数据、关系数据和非结构化数据进行实时计算或离线计算，应支持并发任务调度及任务编排等。通过为用户开通、设置数据计算的相关权限，提供数据计算能力。

　　8.2.4数据治理

　　数据治理应支持通过数据目录功能进行数据资产管理，通过元数据管理功能进行元数据资料库管理，通过数据质量管理功能进行数据质量评估及报警，通过数据共享功能进行数据注册及发布等。通过为用户开通、设置数据治理相关权限，提供数据治理能力。

　　8.2.5数据可视化

　　数据可视化应支持通过数据对接功能与数据库、数据流、文件系统等进行数据对接，通过数据分析功能进行数据筛选、钻取等分析操作，通过数据处理功能进行关联、聚合等处理操作，通过可视化展示功能进行图表配置及数据展示，通过仪表盘将数据发布为超链接、图片、文档、表格等格式。通过为用户开通、设置数据可视化相关权限，提供数据可视化能力。 8.3油气建模分析

　　8.3.1油气模型算子库

　　油气建模分析功能宜提供油气数据预处理算子，通过交互式建模工具进行算子参数调节，支持数据预处理、特征工程、统计分析、绘制图形等操作。油气建模分析接口定义示例见附录F。

　　8.3.2油气模型设计

　　油气模型设计功能应能支持针对油气工业中各类设备、设施、工艺、流程等进行预警、预测等智能场景的模型设计与开发。

　　8.3.3油气模型训练

　　油气模型训练功能应能支持针对油气工业中预警、预测等智能场景设计开发的模型进行训练、迭代。

　　8.4油气微服务

　　8.4.1服务目录

　　服务目录应提供API版本管理、API在线沙箱测试及API调用代码示例等能力。服务目录中宜上架设备设施类、智能模型类、数据统计与分析类、数据共享类、工单流程类等微服务接口。以典型的设备在线监测系统为例，服务目录下典型的油气微服务宜包括报警管理、故障管理、设备案例、设备信息、工业模型、统计分析等。服务目录接口定义示例见附录G。

　　8.4.2服务治理

　　服务治理应支持服务注册发现、服务网关、弹性伸缩、版本管理和运行监控等。通过为用户开通、设置服务治理相关权限，提供服务治理能力。

　　9应用层

　　9.1 油气APP监管

　　9.1.1应用管理

　　应用管理应提供对应用的统一发布与管理能力，对应用进行上下架、集成、分类分级、推荐、收藏、部署、订阅等操作。

　　9.1.2应用监控

　　应用监控应提供针对线上应用的CPU、内存、网络、存储等内容的运维管理能力，进行应用版本管理、运行状态监控及告警、健康检查、升级补丁等操作。

　　9.2 油气APP市场

　　油气APP市场应提供针对特定应用或类别的查询能力，应能查看应用详情，获取、评价、收藏及订阅应用。宜支持通过应用收藏列表或最近使用等入口进入应用系统。

　　SY/T7797—2024

　　10系统安全防护体系

　　10.1管理安全

　　10.1.1平台安全等级保护要求

　　平台安全等级保护应满足现场部署的生产系统的安全等级保护要求，并符合GB/T 22239中安全等级的要求。

　　10.1.2配置基线检查

　　配置基线检查应包括网络设备、安全设备、数据库、操作系统、中间件、Web应用系统等安全防护基线配置要求及检测要求。具体应符合YD/T2698、YD/T2699、YD/T2700、YD/T2701、YD/T

　　2702、YD/T2703的要求。

　　10.1.3数据备份与容灾

　　数据备份与容灾应对平台各类数据根据既定策略进行备份，同时应符合GB/T20988的要求。

　　10.1.4日志安全

　　日志安全应确保系统日志保存6个月以上，并确保日志的安全性和完整性定期进行日志审计。日志应对以下活动进行记录：

　　——登录认证日志;

　　——用户/权限管理;

　　——恶意软件/外部威胁;

　　——网络活动;

　　——系统操作。

　　10.2数据安全

　　数据安全应提供数据完整性、数据保密性、备份和恢复等安全防护能力。数据安全保护应符合YD/T 3865的要求。

　　数据传输应区分非涉密网络和涉密网络。非涉密网络不应采集、存储、处理、传输涉及国家秘密和商业秘密相关数据。

　　密码技术的应用应符合GB/T43206的要求。

　　10.3系统安全

　　平台安全应提供身份认证、权限管理、操作审计等安全防护能力。

　　应根据GB/T22240确定系统的安全等级保护级别，并按照GB/T 25070中对于相应等级的技术要求对系统进行安全防护和安全加固。

　　10.4应用安全

　　应用安全应提供API访问密钥申请与审核流程、应用系统运行监控等能力，对设计、编码、测 试、部署等环节进行访问控制、安全测试、编码审计等合规管控。具体应遵循GB/T37931的要求。

　　附录A

　　(资料性)

　　边缘采集数据内容及接口

　　A.1 数据采集接口概述

　　油气行业专业厂商设备状态监测系统数据采集接口包含运行类接口、标识类接口和事件类接口。运行类接口进行设备实时数据的采集;标识类接口包括获取设备列表接口、获取设备组态信息接口，分别获取设备列表和设备的组态信息;事件类接口根据机组编码定期获取设备历史事件记录数据。

　　A.2设备列表信息及接口

　　A.2.1设备列表信息

　　设备列表信息定义见表A.1。

　　表A.1设备列表信息 字段名称 数据类型 定义 是否可空 groupID string 集团代码 否 plateID string 板块代码 否 regComID string 地区公司代码 否 branchID string 一级(厂或分公司或油气矿代码) 一 districtID string 二级(车间/作业区/大队) 一 factoryName string 三级(装置或小队或场站代码) 一 machineType string 设备类型 否 machineID string 机组编号(位号) 否 machineERPID string 机组编码 否

　　A.2.2获取设备列表信息接口

　　设备列表信息接口包括以下内容。

　　a)功能描述：定期获取地区公司下的设备列表。

　　b)请求方法：

　　·Method:GET;

　　·URL:/data/getDeviceList/v1。

　　c) 参数描述：接口入参见表A.2。A.3 设备组态信息及接口

　　A.3.1设备组态信息详情

　　设备组态信息详情见表A.3。

　　SY/T7797—2024

　　表A.2获取设备列表接口入参信息 参数名称 数据类型 定义 是否可空 groupID string 集团代码 否 plateID string 板块代码 否 regComID string 地区公司代码 否

　　表A.3设备组态信息 字段名称 数据类型 定义 是否可空 machineID string 机组编号(位号) 否 machineERPID string 机组编码 否 pointName string 测点名称(子设备/机组)

　　(振动测点/工艺量测点) 否

　　dataType

　　string 测点类型：

　　1:位移(d);

　　2:速度(v);

　　3:加速度(a);

　　4:其他振动信号;5:压力(p);

　　6:温度(t);

　　7:流量(f);

　　8:其他工艺参数;9:键相/转速

　　否

　　dataUnit

　　string 单位：

　　1:MPa;2:℃;

　　3:pm;

　　4:mm/s;5:mm/s²;6:g;

　　否 hAlarm float 高报门限值 否 hhAlarm float 高高报门限值 否 1Alarm float 低报门限值 否 lAlarm float 低低报门限值 否

　　A.3.2获取设备组态信息接口

　　设备组态信息接口包括以下内容。

　　a) 功能描述：定期获取设备组态信息。 b)请求方法：

　　·Method:GET;

　　·URL:/data/getDeviceConfig/v1。

　　c)参数描述：接口入参见表A.4。

　　表A.4获取设备组态信息接口入参信息

　　参数名称 数据类型 定义 是否可空 machineERPID string 机组编码 否

　　A.4设备实时数据信息及接口

　　A.4.1设备实时数据信息

　　设备实时数据信息详情见表A.5。

　　表A.5设备实时数据信息 属性 字段名称 数据类型 定义

　　振动通道信息 samplePoint_async int 异步采样点数(采样长度) sampleFrequency_async int 异步采样频率[单位赫兹(Hz)] vibWave_async float 异步波形，以逗号分隔开 samplePoint_sync int 同步采样点数(采样长度) samplePeriod_sync int 同步采样周期 vibWave_sync float 同步波形，以逗号分隔开 vibCharacteristicData float 振动特征值数据，是某一类数据的统称，宜根据具体传感器及特征提取算法定义编码规则 speed float 旋转速度[单位为每分钟转数(r/min)]

　　过程通道

　　procOperationData

　　float 工艺运行数据，是某一类数据的统称，宜根据具体传感器及特征提取算法定义编码规则。显示数值， 保留小数点后两位 时间戳 timestamp long 振动数据和工艺量数据Unix时间戳，精确到毫秒(ms)

　　设备状态量信息

　　staType

　　String 0:无启停机;

　　1:运行中，运行开始时间戳;

　　2:启机中，启机开始和启机结束时间戳;

　　3:停机中，停机开始和停机结束时间戳;

　　4:已停机，停机时间戳;

　　5:1倍频幅值波动异常;

　　6:2倍频幅值波动异常;

　　7:残余量波动异常;

　　8:监测参数斜率预警;

　　9:监测参数包络预警;…… timestamp long Unix时间戳，精确到毫秒(ms),针对设备状态量

　　A.4.2 获取设备实时数据信息接口

　　获取设备实时数据信息接口包括以下内容。

　　a) 功能描述：获取设备实时数据;如果测点名称为空，则返回该机组下所有测点的实时数据;如果测点不为空，则返回该机组、测点的实时数据。

　　b)请求方法：

　　·Method:GET;

　　·URL:/data/getDeviceTelemetry/v1。

　　c)参数描述：接口入参见表A.6。

　　表A.6获取设备实时数据接口入参信息

　　参数名称 数据类型 定义 是否可空 machineERPID string 机组编码 否 pointName string 测点名称(子设备/机组)振动测点/工艺测点 是 machineType string 设备类型 否

　　A.5设备历史事件信息及接口

　　A.5.1设备历史事件信息

　　设备历史事件信息详情见表A.7。

　　表A.7设备历史事件信息 属性 字段名称 数据类型 定义

　　事件

　　记录 timestamp long Unix时间戳，精确到毫秒(ms) machinelD float 机组id(发生记录事件的机组)

　　type

　　int 事件类型：

　　1:设备报警

　　2:设备启动

　　3:设备停机

　　4:转速升高突变5:转速降低突变6:系统重置

　　7:系统维护8:仪表故障9:通信报警10:组态异常

　　A.5.2获取设备历史事件信息接口

　　获取设备历史事件信息接口包括以下内容。 a) 功能描述：定期获取设备事件记录数据。

　　b)请求方法：

　　·Method:GET;

　　·URL:/data/getHistoryEvent/v1。

　　c) 参数描述：接口入参见表A.8。

　　表A.8获取设备历史事件信息接口入参信息 参数名称 数据类型 定义 是否可空 machineERPID string 机组编码 否 startTime long 查询开始时间，从1970年1月1号开始到现在时刻的秒数 否 dueTime long 查询结束时间，从1970年1月1号开始到现在时刻的秒数，如果为空则为现在时刻 是

　　附录B

　　(资料性)

　　边缘处理接口

　　B.1事件类接口定义

　　B.1.1事件类接口

　　边缘处理事件类接口定义见表B.1。

　　表B.1边缘处理事件类接口 服务名称 静默指令下达 服务定义 由于仪表故障、工艺波动或者工况改变等原因导致误报，需要下发静默指令到边缘端，暂停该测点或者设备的预警功能 接口方法 CREATE/UPDATE/DELETE/SELECT 参数定义 包括operation、entityType、deviceGroupld和measurePoint等参数 返回值 无 备注 一

　　B.1.2事件类接口参数

　　边缘处理事件类接口参数见表B.2。

　　表B.2边缘处理事件类接口参数

　　序号 参数 数据类型 含义 是否可空 备注 1 operation string 操作类型 否 包含CREATE/SELECT/UPDATE/

　　DELETE 2 entityType string 实体类型 否 用于区别所传送的消息类型 3 deviceGroupld string 机组编码 否 一 4 measurePoint string 测点编码 是 一

　　B.2控制类接口定义

　　B.2.1控制类接口

　　边缘处理控制类接口定义见表B.3。 B.2.2 控制类接口参数

　　边缘处理控制类接口参数见表B.4。

　　SY/T 7797—2024

　　表B.3边缘处理控制类接口

　　服务名称 预警结果上传 服务定义 将自适应阈值预警模型、趋势预警模型、多变量联动预警模型和固定门限预警的预警结果及时上传至云端 接口方法 CREATE/UPDATE/DELETE/SELECT 参数定义 包括deviceGroupld、measurePoint、alarmLevel、alarmType、alarmValue等参数 返回值 无 备注 一

　　表B.4边缘处理控制类接口参数 序号 参数 数据类型 含义 是否可空 备注 1 deviceGroupId string 机组编码 否 一 2 measurePoint string 测点编码 否 一 3 alarmLevel string 报警级别 否 一 4 alarmType string 报警类型 否 一 5 alarmValue double 报警阈值 否 一

　　附录C

　　(资料性)

　　油气大数据集成接口

　　C.1油气实时数据集成接口

　　油气实时数据集成接口定义见表C.1。

　　表C.1油气实时数据集成接口

　　服务名称 实时数据集成 服务定义 边缘设备管理软件将边缘计算的数据采集模块采集的实时数据通过规则链发送到消息队列中间件，油气大数据接入软件消费消息队列中间件的消息 接口方法 采用消息中间件方式 参数定义 包括设备编码、设备类型、设备名称、实时数据key、实时数据value和采集时间等参数 返回值 无 备注

　　C.2油气非实时数据集成接口

　　油气非实时数据集成接口定义见表C.2。

　　表C.2油气非实时数据集成接口 服务名称 非实时数据集成 服务定义 通过配置库的连接，选择源数据库，选择表。配置目标数据库连接，指定目标存储表。数据集成中有定时任务的配置，在每天固定的时间实现不同数据库之间的数据同步 接口方法 参数定义 包括源数据库、目标数据库的连接方式和表 返回值 无 备注 一

　　SY/T7797—2024

　　附录D

　　(资料性)

　　通用信息系统数据集成接口

　　D.1通用设备管理功能模块集成接口

　　D.1.1概述

　　通用设备管理功能模块集成内容包括接口定义和接口格式的集成要求。

　　D.1.2接口定义

　　在管理网通过企业服务总线与集中部署的通用设备管理功能模块集成的数据，包括设备基础信息、设备保养记录、设备故障记录、设备维修记录、设备评估信息等。

　　D.1.3 接口格式

　　通用设备管理功能模块数据集成接口格式如下。

　　——交换数据格式：交换数据包括设备基本信息、设备部件信息、设备故障信息、设备维修记录、设备维护记录等。

　　——数据调用方式：采用WebService等方式抽取数据。

　　——数据接口：

　　·设备台账数据接口：获取某个单位纳人平台管理的所有设备信息;

　　·设备基础数据接口：获取单台设备所有基础信息，包括设备编号、设备类型、设备型号、设备名称、所属公司、所属分厂、所属作业区、所属站、部署位置(设备一级)、设备部署位置(二级)、设备部署位置(三级)、设备位号、设备所属站、设备图示名称等;

　　·设备部件信息接口：获取单台设备所属部件信息，包括设备部件类型、生产厂家、型号等信息;

　　·设备保养信息接口：获取单台设备所有保养数据，包括保养开始时间、结束时间、保养人员等信息;

　　·设备故障记录接口：获取单台设备历史故障记录，包括故障时间、故障部位、处理措施、处理结果等信息;

　　·设备维修信息接口：获取单台设备所有维修数据，包括维修情况、开始时间、结束时间、维修人员等信息。

　　D.2MES 系统集成接口

　　D.2.1概述

　　以MES系统中设备管理模块互通集成为例，集成内容包括接口定义和接口格式的集成要求。

　　D.2.2 接口定义

　　在控制网通过OPC等方式与分布式部署在地区公司工厂生产网的各个MES系统集成的数据，包括设备测点信息、设备实时数据、设备图谱等。 D.2.3 接口格式

　　MES系统数据集成接口格式如下。

　　——交换数据格式;交换数据格式包括设备测点数据、设备实时数据、设备图谱信息等。

　　——数据调用方式;采用WebService、OPC等接口，从MES抽取工艺量数据。

　　——数据接口：

　　·设备测点信息接口：获取单台设备所有测点信息，包括测点名称、当前值、高限值、高高限值、下限值、下下限值等信息;

　　·单个测点实时数据接口：获取单个测点实时数据接口;

　　·设备实时数据接口：获取单台设备实时数据，包括转速、动力缸温度、排气温度、发动机冷却水温度、轴瓦缸温度、进气温度、高位油箱油温、外循环油温度、排气压力、进气压力、燃气压力等信息;

　　·设备图谱信息接口：获取单台设备展示某类图谱所需的数据，包括趋势类型、时间段、波形数据等。

　　D.3IAM系统集成接口

　　D.3.1 概述

　　IAM系统互通集成内容包括接口定义和接口格式的集成要求。

　　D.3.2 接口定义

　　在管理网通过API与集中部署的IAM系统集成的数据，包括机构信息、用户基本信息、用户认证信息等。

　　D.3.3接口格式

　　IAM系统数据集成接口格式如下。

　　—交换数据格式：交换数据包括用户基本信息、组织机构信息等。

　　——数据调用方式：采用RESTfulAPI等方式，与IAM进行双向数据交互。

　　——数据接口：

　　·登录回调接口：应用系统获取IAM传来的授权码code, 使用授权码向IAM请求带有用户身份信息的临时票据token,获取到token后证明IAM已经为应用系统完成授权，应用系统使用token向IAM请求正在登录的用户信息，获取用户信息中的账号名，单点登录已经完成。

　　·账号查询接口：IAM在创建应用账号时，需向应用方查询是否存在该应用账户。应用系统判断accountName在系统中是否存在，IAM创建账号时会限制accountName唯一。

　　·账号同步接口：应用方在和IAM集成后，需要在IAM中管理账号数据，IAM通过调用应用方的账号同步接口，实现应用账号的新增、修改、禁用、启用和删除功能。除了IAM提供的如员工编号、姓名等字段，应用方可自定义用户属性字段，和IAM管理员商定之后在IAM中为该应用配置自定义属性。

　　·账号分批查询接口：应用系统需要向IAM提供账号分批查询服务，应用接收并解析参数对象，根据查询条件查询并返回账号集合。

　　·组织机构读取接口：IAM从应用方读取组织机构。在向应用系统同步账号时，可为用户选择在该应用中所属的组织机构。 ·账号数量查询接口：应用系统需要向IAM提供账号数量查询服务，IAM调用该接口获知应用系统具体可用账号数量。

　　·账号自映射接口：IAM向应用系统查询是否可认领该账号。如果可认领，应用系统方需返回账号信息，IAM将根据返回账户信息创建应用账号。

　　·账号推送接口：应用系统管理员在IAM平台为用户创建、修改、禁用、启用、删除应用账号时，IAM调用接口进行账号操作，应用接口接收到请求报文，获知是对相应账号进行操作。应用方在对应用账号进行操作之后返回给IAM相应的响应，通知IAM该操作是否完成。

　　·单点登出接口：应用系统退出时，如需要清空IAM的登录会话，可在退出时将用户浏览器定向到IAM的登出接口，注销IAM的登录会话。

　　·请求token接口：应用系统请求token。

　　·用户信息请求接口：应用系统使用用户token请求用户信息。

　　D.4GIS 系统集成接口

　　D.4.1概述

　　GIS系统集成内容包括接口定义和接口格式的集成要求。

　　D.4.2接口定义

　　在管理网通过页面与集中部署的GIS系统集成的数据，包括单位地理位置、设备地理位置信息等。

　　D.4.3接口格式

　　GIS系统数据集成接口格式如下。

　　——交换数据格式：交换数据包括单位位置信息及设备位置信息。

　　—数据调用方式：采用WebService等接口方式，从GIS系统获取数据。

　　——数据接口：获取单位位置信息及设备位置信息(如矢量及栅格数据)。

　　D.5短信系统集成接口

　　D.5.1概述

　　短信系统互通集成内容包括接口定义和接口格式的集成要求。

　　D.5.2接口定义

　　在管理网与集中部署的短信系统集成的数据，包括用户基本信息等。

　　D.5.3接口格式

　　短信系统数据集成接口格式如下。

　　——交换数据格式：交换数据包括用户基础信息及短信内容。

　　—数据调用方式：采用WebService等接口方式，向短信系统推送数据。

　　——数据接口：直接调用接口发送短信。 D.6其他信息系统集成接口

　　D.6.1 概述

　　其他系统集成内容包括接口定义和接口格式的集成要求。

　　D.6.2接口定义

　　在控制网与分布式部署的自建系统集成的数据，包括设备基础信息、设备测点信息、设备实时数据、设备图谱等。

　　D.6.3接口格式

　　其他信息系统数据集成接口格式如下。

　　——交换数据格式：交换数据包括设备基础信息、设备案例信息、设备部件信息、设备维修维护数据等。

　　——数据调用方式：通过OPCServer、RESTfulAPI等接口方式进行数据交互。

　　——数据接口：

　　·设备台账数据接口：获取某单位纳入平台管理的所有设备信息;

　　·设备基础数据接口：获取单台设备所有基础信息，包括设备编号、设备类型、设备型号、设备名称、所属公司、所属分厂、所属作业区、所属站、部署位置(设备一级)、设备部署位置(二级)、设备部署位置(三级)、设备位号、设备所属站、设备图示名称等;

　　·设备部件信息接口：获取单台设备所属部件信息，包括设备部件类型、生产厂家、型号等信息;

　　·设备保养信息接口：获取单台设备所有保养数据，包括保养开始时间、结束时间、保养人员等信息;

　　·设备故障记录接口：获取单台设备历史故障记录，包括故障时间、故障部位、处理措施、处理结果等信息;

　　·设备维修信息接口：获取单台设备所有维修数据，包括维修情况、开始时间、结束时间、维修人员等信息。

　　附录E

　　(资料性)

　　油气大数据存储接口

　　E.1油气实时数据存储接口

　　油气实时数据存储接口定义见表E.1。

　　表E.1油气实时数据存储接口 服务名称 实时数据存储 服务定义 边缘设备管理软件将边缘计算的数据采集模块采集的实时数据通过规则链发送到消息队列中间件，油气大数据接入软件消费消息队列中间件的消息并通过油气大数据存储软件实现数据存储 接口方法 采用消息中间件方式 参数定义 包括设备编码、设备类型、设备名称、实时数据key、实时数据value和采集时间等参数 返回值 无 备注

　　E.2油气非实时数据存储接口

　　油气非实时数据存储接口定义见表E.2。

　　表E.2油气非实时数据存储接口 服务名称 非实时数据存储 服务定义 通过配置库的连接，选择源数据库，选择表。配置目标数据库连接，指定目标存储表。数据集成中有定时任务的配置，在每天固定的时间实现不同数据库之间的数据同步 接口方法 一 参数定义 包括源数据库、目标数据库的连接方式和表 返回值 无 备注 一

　　附录 F

　　(资料性)

　　油气大数据建模分析接口

　　油气大数据建模分析接口定义见表F.1。

　　表F.1油气大数据建模分析接口 服务名称 大数据建模分析 服务定义 按照指定指标和维度查询多维模型的分析结果 接口方法 GET 参数定义 立方体、指标、纬度等 返回值 结果集 备注 一

　　附录G

　　(资料性)

　　油气微服务目录接口

　　G.1服务目录注册接口

　　服务目录注册接口定义见表G.1。

　　表G.1服务目录注册接口

　　服务名称 API网关服务注册 服务定义 通过API网关将异构外部服务进行注册，对微服务实现调度、监控、授权等管理操作;通过swagger文件的方式进行服务在API网关的注册 接口方法 一 参数定义 IP地址、端口、服务URL 返回值 无 备注

　　G.2服务目录发现接口

　　服务目录发现接口定义见表G2。

　　表G.2服务目录发现接口

　　服务名称 Spring Cloud服务发现

　　服务定义 当客户端向Server注册时，需要提供自身的元数据;客户端每隔30s发送一次心跳来续约;正常情况下，如果Server在90s没有收到客户的续约，它会将实例从其注册表中删除;客户端从服务器获取注册表信息，并将其缓存在本地;客户端在程序关闭时向服务器发送取消请求 接口方法 Register、Renew、Fetch Registries、Cancel,Eviction 参数定义 IP地址、端口、服务URL 返回值 无 备注 一

　　G.3服务目录接口调用

　　服务目录接口调用定义见表G.3。

　　表G.3服务目录接口调用

　　服务名称 目录服务 服务定义 对于外部服务，调用者申请使用API,服务提供者授权使用API。对于内部服务通过注册表实现内存服务目录

　　SY/T 7797—2024

　　表G.3 (续) 服务名称 目录服务 接口方法 一 参数定义 IP地址、端口、服务URL 返回值 无 备注 一

　　SY/T 7797—2024

　　参考文献

　　[1]GB/T 20921—2007机器状态监测与诊断词汇

　　[2]GB/T 41780.1—2022 物联网边缘计算第1部分：通用要求

　　[3]GB/T 42021—2022 工业互联网 总体网络架构

　　[4]GB/T 42564—2023信息安全技术 边缘计算安全技术要求

　　[5]GB/T 42568—2023 工业互联网平台 微服务参考框架

　　[6]IEC 62443(所有部分)工业自动化和控制系统网络安全(Security for industrial automationand controlsystems)