国家工业互联网大数据中心体系+数据交换与共享接口规范

国家工业互联网大数据中心体系标准QB/CAII04-01-2023中国工业互联网研究院发布国家工业互联网大数据中心体系数据交换与共享接口规范NationalIndustrialInternetBigDataCenterSystemDataExchangingandSharingInterfaceSpecifications7-01发布7-01实施IQBCAII-2023 QBCAII-2023前言-1-QBCAII-2023用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。C-2019国家政务服务平台数据交换与共享接口第1部分数据交换要求C-2019国家政务服务平台数据交换与共享接口第2部分共享接口要求QBCAII01-2023国家工业互联网大数据中心体系总体框架与术语定义renter指国家工业互联网大数据中心体系在全国重点省(自治区、直辖市)建设的省级新型基industrialsubcenterthirdpartyplatformchannelaexchangingtaaggregating-2-QBCAII-2023tadistributingataexchangepreprocessor3.10eprovider3.11demanderJSONJavaScriptJavaScriptObjectNotation)RPC：远程过程调用(RemoteProcedureCall)RESTFUL传递(RepresentationalStateTransfer)SOAP议(SimpleObjectAccessProtocol)换资源需求方，数坝通过API接口或文件交-3-QBCAII-2023资源需求方。数据交换总体流程见图2。a)数据汇聚b)数据分发-4-QBCAII-2023服交换三种交换方式。b)服务接口调用方式是通过实时请求服务接口实现数据交换，适用于时效性和灵活b)交换数据应采用UTF-8编码格式。c)文件交换方式，数据提供方需为每条交换数据记录增加设置两个数据项：记录时间指数据传送文件生成的时间。XML、包头和包体三部分组成。xmlversionencodingUTF"?>数据量和更新频率，如表1所示。-5-QBCAII-2023顺序号标记长度是否必填含义说明1ATASOURCENAME是称2UREAUCODE是关、人民团体及其他机构代码表;省和国行政区划代码;法人及社会组织按照GB32100法人和其他组织统一码编码规则3UREAUNAME是名称4TE8是mdd5AG1是6TATOTAL是数据记录数量7EQ2是:PACKAGEDATASOURCENAMExxxBUREAUCODE="320000"BUREAUNAME单位名称"SYNC_DATE="20230201"SYNC_FLAG="1"SYNC_FREQ="DATA_TOTAL="150"xmlns:xsi="/2001/XMLSchema-instancexsinoNamespaceSchemaLocation="">c交换数据包体部分由多条数据记录集合组成，每条数据记录由数据项和数据内容下:COLUMNNAME>${数据项内容}</COLUMN>…XML应遵循的其他约定:L&<>“’amp;lt;gt;quot;quot;XMLSchema参见附录A.2。a)每一行记录位于一个单独的行上，用回车换行符CRLF(也就是\r\n)分割。-6-QBCAII-2023e引号进行转义。f)CSV格式限定文件大小,单个CSV格式文件不超过150M,如超出,需要拆分成多个CSVa)第一行为数据资源描述信息,包括数据资源描述项及描述内容。数据资源描述项及“^”。d)TXT数据资源描述信息格式示例如表3。BUREAUNAMExxxSYNCDATESYNCFLAGSYNCFREQCrnErn应遵循的其他约定:a。b)TXT格式限定文件大小,单个TXT格式文件不超过150M,如超出,需要拆分成多个T号为“\\”。“文件名”+“_卷号”+“.ZIP”。文件大小不要超过2G，可由多个压缩文件构成(压缩文件卷号由3位数字表示,由数据提供方生成,为十进制表示的小于999的数字,起始值为001)。循以下内容:a)交换双方的数据库应与国家中心的数据库为同构数据库。b)进行库表对接的双方需要保持数据库、数据表结构的一致性。各区域分中心、各行业分中心、第三方平台应以全量/增量更新的方式，按规定的频率a)业务数据批量交换，交换频率原则上应不低于1次/天。b)业务数据实时交换，交换频率需遵照各服务接口约定。-7-QBCAII-2023据库交换方式的汇聚流程见图3；服务调用方式的汇聚流程见图4。-8-QBCAII-2023完成以下工作：向数坝发起汇聚申请。其中，服务调用方式需按照7.3.1的服务接口注册信息表发起服务注册申请；文件交换和数据库交换方式需参照的资请准1资源名称(中文)。2资源名称(英文)文名称3push：汇聚(申请人为资源提供方)；pull：拉取(申请人为资源需求方)4的简单描述5码数据资源的提供部门代码(统一社会信用代码)6称供部门名称7据交换方式：数据库交换、文件交换8数量或容量9数据交换频率(比如：小时、天、月等，选择定时交换方式时需注明)数据交换方式(比如：一次性、定时交换)读权限的数据库连接信息、用户信息、库名、表名、表结构件名资源的有效截止日期，日期格式(YYYY-MM-DD)a)服务调用方式：完成汇聚服务接口注册。b)文件交换方式：完成文件资源目录、文件的权限确认等前置汇聚准备工作。机库表的库表数据同步信息。a)服务调用方式：按汇聚申请单的约定准备好服务接口及其运行方式。b换方式：按资源申请单约定的文件类型生成待汇聚数据资源文件(文件规范参见6.2.3)，同时留存文件备份用于文件数据对账。-9-QBCAII-2023a)资源提供方的系统软件升级，业务数据表的唯一标识字段(主键)发生变化。b)汇聚数据内容不符合数据汇聚标准。c)汇聚数据内容不符合本文件的代码集标准。d障，无法继续识别增量数据。文件交换方式的数据分发流程见图6。-10-QBCAII-2023接口申请信息表向数坝发起服务接口调用申请；文件交换方式需按照的资源申请信成申。QBCAII-2023受共享服务接口总体框架见图7。a)资源提供方将服务接口注册到国家中心。b核及统一封装，并完成对外发布服务接口。c)资源需求方向国家中心提出服务接口调用申请。e)资源需求方按服务接口使用要求进行调用。f)资源需求方对资源提供方进行意见反馈(如有需要)或应用资源。-12-QBCAII-20231服务名称(中文)资源名称。2服务名称(英文)源的英文名称3单描述4码服务接口资源的提供部门代码(统一社会信用代码)5称源的提供部门名称6录源所属的资源目录，资源目录由资源提供方编目并注册到国家中册时，选择相应的资源目录7地址，必须是通过国家中心能够访问的地址，否则无法注册或被8HTTPRPCRESTFUL、SOAPWEBSERVICE9法调用频率上限值(比如：100次/秒)长响应时间(比如：6ms)期服务接口调用的有效截止日期，日期格式(YYYY-MM-DD)header；2：body)stringintlongarray、boolean、object等)明“2：有条件共享”时的说明明文档访服务接口使用说明文档中暴露原始服务接口地址-13-QBCAII-2023进行备案记录。通过后撤销成功。案记录。参心为资源使用方授权认证信息。服务接口申请信息见表6。1称2请部门的统一社会信用代码3请部门名称4请部门联系人5请部门联系人电话6请部门联系人邮箱7用部门的统一社会信用代码8用部门的名称9人用部门的联系人人电话用部门的联系人电话人邮箱用部门的联系人邮箱业务系统名称于哪些事项的办理。国家中心提供事项目录清成上述事项办理的相关法律、法规、政策的用频次用频次(平均)次/秒章的申请表及相关技术参数文档口调用，调用流程详见图8。-14-QBCAII-2023a)获取安全访问令牌。资源需求方使用国家中心分配的client_id和client_secret。URL式authtoken取国家中心访问资源令牌URL数是ret是tpokenshTokenokenExpiredTime令牌过期时间(Timestamp类型，值为毫秒(处理正常){sTokenxxxeshTokenxxxntxxxsTokenExpiredTimexxx}n值代码见附录A.1。-15-QBCAII-2023(资料性附录)A1共享服务接口返回值代码表的返回值代码，参见表A.1。PIKEYAPI不可用或APIKEY错误API过期失必须是JSON格式后访问能用POST能用GET能用PUT能用DELETE-16-QBCAII-2023AXML实例及Schema实例XML实例xmlversion"encoding="UTF-8"?>SYNCDATE20230201"SYNC_FLAG="1"SYNC_FREQ="月"DATA_TOTAL="150"xmlnsxsi/2001/XMLSchema-instance"inoNamespaceSchemaLocationqualifiedDVALUEFIELDDVALUEFIELDDVALUEFIELDSchema实例xmlversionencodingUTF-8"?><xs:schemaxmlns:xs="/2001/XMLSchema"ormDefaultqualifiedmentnamePACKAGETypeeequiredtypexsstringxsattributenameBUREAUCODEuserequiredtype"xs:string"/>xsattributenameBUREAUNAMEuserequiredtype"xs:string"/>xsattributenameSYNCDATEuserequiredtype"xs:string"/>xsattributenameSYNCFLAGuserequiredtype"xs:integer"/>xsattributenameSYNCFREQuserequiredtype"xs:integer"/>xsattributenameDA