DB31∕T 1240.2-2020 公共数据共享交换工作规范 第2部分：平台接入技术要求

ICS35.020L70DB31/T1240.2—2020公共数据共享交换工作规范第2部分：平台接入技术要求Workspecificationonpublicdatasharingandexchange—Part2:Technicalrequirementofplatformaccess2020-09-01发布2020-11-01实施上海市市场监督管理局发布IDB31/T1240.2—2020前言 Ⅲ 12规范性引用文件 13术语和定义 14接入技术要求 24.1接入方式 24.2接入要求 55接入流程要求 65.1接入服务分类 65.2接入准备 65.3部门接入 95.4区接入 附录A(资料性附录)级联错误码对照表 27附录B(资料性附录)级联数据库表格式 28B.1管控数据表 28B.2数据描述表 30附录C(资料性附录)级联文件操作接口 34C.1概述 34C.2数据文件读写 34C.3文件签名接口 35附录D(资料性附录)级联系统服务接口 37D.1服务列表查询接口 37D.2服务详情查询接口 38D.3服务信息注册接口 40D.4签名密钥获取接口 43参考文献 45DB31/T1240.2—2020ⅢDB31/T1240《公共数据共享交换工作规范》分为以下2个部分：——第1部分：平台建设和运行管理要求；—第2部分：平台接人技术要求。本部分为DB31/T1240的第2部分。本部分按照GB/T1.1—2009给出的规则起草。本部分由上海市人民政府办公厅电子政务办公室提出并组织实施。本部分由上海市公共数据标准化技术委员会归口。本部分起草单位：上海市大数据中心、上海计算机软件技术开发中心、北京东方通科技股份有限公司。本部分主要起草人：朱宗尧、刘迎风、储昭武、傅行晓、李雪凝、杨琳、郭大勇、李黎明、许志远。1DB31/T1240.2-2020公共数据共享交换工作规范本部分规定了上海市数据共享交换平台的接入技术要求和接人流程要求，包括接人方式、接入要求、接人准备、部门接入和区接入等内容。本部分适用于上海市数据共享交换平台各相关单位的接入工作。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。DB31/T1240.1-2020公共数据共享交换工作规范第1部分：平台建设和运行管理要求3术语和定义DB31/T1240.1-2020界定的以及下列术语和定义适用于本文件。3.1级联cascade市平台与区平台进行业务和数据对接，实现市、区两级平台的互联互通。3.2级联共享区cascadesharedarea用于市、区两级平台级联信息交互的区域，以数据表、文件的方式存储级联过程中的业务数据及交换过程中的资源数据。3.3级联数据文件cascadedatafile级联交换的实际业务数据的载体，主要有两种类型，源于数据库表的数据文件和传统的业务数据文件。3.4市级联系统municipalcascadesystem市平台中实现市、区级联的系统，由市平台负责开发实现，部署于市平台系统环境中(含区级前置系统)。3.5区级联系统districtcascadesystem区平台中实现市、区级联的系统，由区平台负责开发实现，部署于区平台系统环境中。3.6上行接口upstreaminterface市级联系统的组成部分，通过上行接口，区平台向市平台提交资源申请与审核数据、交换业务数据等。2DB31/T1240.2—20203.7上行数据表upstreamdatatable区级联系统的组成部分，数据库表的方式存在，部署于级联共享区。通过上行数据表，区平台向市平台提交资源交换信息，资源接收回执等。3.8下行数据表downstreamdatatable区级联系统的组成部分，数据库表的方式存在，部署于级联共享区。通过下行数据表，市平台向区平台下发资源申请与审核业务数据、交换业务数据、资源信息等。4接入技术要求4.1接入方式4.1.1接入方式类型区公共数据和管理部门、市级公共管理和服务机构可采用前置机交换和服务接口两种交换方式接入平台。a)前置机交换：平台通过前置数据库表或前置机文件目录进行数据交换，各接人单位通过桥接方式获取前置数据库表内容或前置机的文件，向前置数据库表或前置机文件目录推送数据：1)数据库表交换：在公共数据提供者以数据库表结构化方式存储，并以库表方式进行全量或增量数据的交换；2)文件交换：适用于非结构化资源或更新频率比较缓慢的结构化资源的交换。b)服务接口交换：以Web服务作为平台与各接人单位之间数据获取和推送的接口，在平台中代理业务系统提供的Web服务，对外隐藏该Web服务的真实URL,使用代理的URL即可访问业务系统真实的Web服务，以达到数据交换的目的。前置机交换有以下三种方式：a)基于任务交换：两个节点需要信息隐私保护机制的交换方式，在两个节点之间建立传输通道，通过库表或文件的形式，将数据或文件交换到对方节点，分为数据库交换和文件交换两种形式。基于任务交换的前提应是传输节点明确，任务明确，一般以下情形采用此类交换：1)节点库表1对1之间的传输任务；2)节点文件夹之间的传输任务；3)双方协商周期性交换的传输任务；4)双方协商一次性交换的传输任务。b)任务发布订阅：公共数据提供者发布数据资源任务，公共数据使用者进行订阅获取数据的交换方式。数据被订阅后，平台将数据推送到订阅单位前置节点。其中，任务的发布者负责对数据的发布，并限定订阅者的范围，不约束订阅者的行为。任务发布订阅交换的前提是发布者明确拥有的数据资源，一般下列情形采用此类交换：1)任务发布者无法明确订阅者对象的传输任务；2)任务发布者认为该数据有价值，可以对外共享的任务。c)资源发布订阅：资源发布订阅交换是通过资源目录中发布和订阅资源进行数据交换的方式。资源发布单位通过交换系统的资源目录注册数据资源的元数据信息，资源订阅单位通过数据3DB31/T1240.2—2020的元数据信息可以直观查看资源发布方数据的具体业务含义，并根据业务需要订阅数据。数据订阅后，交换系统将数据交换到资源订阅单位节点。一般下列情形采用此类交换：1)资源发布者无法明确订阅者对象的传输任务；2)资源发布者认为该资源有价值，可以对外共享的传输任务；3)资源订阅者需要了解资源发布方数据的业务含义。触发方式交换触发是控制平台内交换任务、发布订阅任务、资源发布订阅任务的运行或停止，触发方式主要包括：a)手动触发：基于直接交换中配置好的任务和流程，手动启动交换、停止交换的一种触发方式，手动触发方式任务只执行一次；b)自动触发：平台按照设定的运行周期执行交换的一种触发方式。抽取方式前置机抽取方式主要包括：a)触发器：在源数据库中建立相应触发器，当数据发送改变时直接触发数据的抽取和交换；b)时间戳：通过源表中的时间戳字段来标记数据的新增、修改，每次只抽取从上次抽取结束时间开始的增量数据；c)标志位：通过在源表中设计标志位字段来标记数据是否已经被抽取，交换系统在完成数据抽取后会修改该标志位，从而实现增量交换。交换运行周期交换运行周期设定是平台内交换任务、发布订阅任务、资源发布订阅任务的执行时间设定，平台提供两种交换运行周期：a)循环时间间隔：配置时间间隔为运行周期，交换以此时间间隔持续运行；b)定时器规则：配置的具体时间点为运行周期，当时间点满足时触发交换运行。交换策略交换策略是指平台运行时如何获取数据的规则，平台提供两种交换策略：a)全量交换：平台一次性将数据库表中的所有数据交换到目标节点的交换方式。全量交换要求业务库表应具有主键标识。b)增量交换：指平台周期性从数据库表中获取最新数据并交换到目标节点的交换方式：1)时间戳交换：平台根据业务数据的时间戳变化获取增量数据，并将增量数据交换到目标节点的交换方式；2)标识位交换：平台根据业务表中的标识字段值的变化获取增量数据并将增量数据交换到目标节点的交换方式；3)触发器交换：平台利用数据库触发器获取增量数据并将增量数据交换到目标节点的交换方式。平台具备全面的数据支撑能力，在表字段数量、长度和数据类型等方面无任何限制，表字段数量、长度和数据类型等仅受当前接入的数据库类型制约。平台提供多种数据库支持能力以及数据库类型转换支持能力，包括：a)数据库支持：支持DM、Kingbase、GBase、Oracle、DB2、Sybase、Mysql等多种数据库的适配接入；DB31/T1240.2—20204b)类型转换支持：不同数据库之间相同类型的字段可以相互转换。4.1.3服务接口服务接口类型公共数据提供者以服务接口方式共享资源时，可选择的接口类型包括：REST和WebService。服务接口协议为确保服务接口的标准性和可用性，服务接口统一按照以下协议规范和技术要求对外呈现：a)服务传输协议：采用HTTP/S1.0/1.1标准；b)服务消息协议：WebService服务消息封装协议采用SOAP1.1/1.2标准；REST服务消息封装协议采用HTTP1.0/1.1标准；c)服务描述：应包含服务调用者使用的具体访问接口内容，主要包括数据类型定义、操作、交互消息格式和内容、端口类型及绑定等内容，内容格式应按照WSDL1.1的规定进行描述：1)数据类型定义应按照XMLSchema1.0规范的规定使用；2)消息(Message)应采用类型定义整个消息的数据结构，消息类型定义应按照XMLSchema1.0规范的规定使用；3)端口类型(PortType)应定义Web服务的操作，及操作中对应的输人输出参数和消息交互模式；4)绑定形式应使用DocumentLiteral/Wrapped文档风格，禁止使用RPCEncoding及Doc-umentEncoded形式，应使用SOAP1.1/1.2版本标准，通信应绑定HTTP/S标准协议；5)消息字符集和编码应保持一致，应采用GBK或UTF-8。服务接口调用频次平台提供服务接口的调用频次控制功能，以实现对服务调用方在单位时间内调用某个具体服务接口的总次数进行控制。调用频次的单位为次/d。服务接口安全为确保服务接口的安全性，平台提供服务接口应统一按照以下方式进行安全控制：a)客户端访问控制：对公共数据使用者的使用权限进行控制，主要表现为申请授权和权限验证。公共数据使用者在需要使用某个服务接口时，需要首先通过市平台发起对该资源的使用申请，申请时需要添加身份信息(包括组织机构名称、IP地址、应用场景、应用系统、申请人、联系方式),市平台在完成相关信息审核或备案后，为申请方分配唯一的身份标识并提供授权码(AP-PKey),公共数据使用者每获得一个服务接口的使用授权，市平台都将为其生成一个授权码，即一事一码。公共数据使用者在获得服务接口的使用授权后，在发起服务调用时，需要在请求信息中携带自己的身份标识及相关签名信息，市平台在收到使用方的服务调用请求后，会验证请求信息中的身份签名信息，从而判断该请求是否为合法用户的请求，达到验权的目的。b)动态密钥：公共数据使用者在发起服务调用前，首先需要使用已经获得的授权码获得服务调用的动态密钥，然后使用动态密钥完成对服务的请求。动态密钥具有有效期限制，目前动态密钥的有效期为1d,每日24时后密钥自动过期。c)签名验签：公共数据使用者在发起服务调用时，需要使用获得的动态密钥对请求头信息进行签名，然后将签名信息写入消息头一并发送到市平台。市平台在收到公共数据使用者的请求后进行验签工作，即市平台使用同样的动态密钥、同样的签名算法对用户的请求信息进行加密，DB31/T1240.2—20205将加密结果与请求中携带的签名信息进行比对，从而验证该请求是用户的真实请求。d)请求时间戳：公共数据使用者在发起服务调用时，需要在请求头中携带本次请求的时间戳，市平台在收到请求信息后，会验证该时间戳的有效性，如果请求时间戳超时严重则拒绝该请求。e)服务端访问控制：服务端代理管控服务器在请求原始服务时，可通过事先约定的格式，在请求信息中携带原始服务提供方为其颁发的身份信息，从而使原始服务能够验证其身份合法性。目前支持HTTPBasic认证及自定义认证方式4.2接入要求4.2.1接入基本要求在数据共享交换过程中，平台的性能指标主要有数据库性能、消息传输性能、交换实例上限数等，其中部分性能指标与前置机的CPU、内存和网络环境等有密切的关系。在完成数据交换流程配置、监控和管理等过程时，其综合性能应全面考虑各项指标对平台的影响。4.2.2前置机指标项说明为保证前置机方式交换数据的性能，配置相关资源时应关注以下指标项：a)交换实例上限：数据交换实例是系统中真实运行的独立交换线程，每一个交换实例都对应于一张表的交换。在交换系统中，可以通过以下交换配置产生数据交换实例：1)数据交换流程配置，一个交换流程产生一个交换实例；2)数据发布订阅，一个订阅产生一个交换实例；3)资源目录发布订阅，一个订阅产生一个交换实例；b)数据库表交换吞吐量：数据库表交换的性能受硬件配置、网络带宽、通信交互等因素制约，随着综合环境的好转，最大数据库表交换的吞吐量呈线性增长c)文件交换最大值：文件交换的最大值与操作系统有重要关系，但在64位系统中，文件大小不受d)传输效率：数据传输过程中，要经过交换机、路由器、防火墙、加解密等各个环节，考虑到这些网络软、硬件对数据传输时间的损耗，实际传输效率最高大约为理论传输效率的70%。性能指标前置机性能指标见表1。表1前置机交换性能指标1硬件参数(最低配置)CPU:4核2.6GHz2345DB31/T1240.2—202064.2.3服务接口指标项说明为正确评估服务接口方式交换数据的性能，应关注以下指标项：a)TPS:服务器每秒处理的事务数。一个事务是指一个客户机向服务器发送请求，服务器做出反应的过程。客户机在发送请求时开始计时，收到服务器响应后结束计时，以此来计算使用的时间和完成的事务个数。b)响应时间：系统得到请求后对请求进行处理并将结果返回的全部时间。性能指标市平台服务接口支撑环境，应采用集群方式实现负载均衡，支持横向扩展，以满足不断增长的服务接口并发访问的性能需求。公共数据提供者采用服务接口进行资源共享时，应采用合理的性能设计与扩展方案，以确保满足并发访问接入与运行的性能需求。接口性能指标应满足：a)并发数：500个；b)TPS:5000以上；c)响应时间：1s,最长不超过3s。5接入流程要求5.1接入服务分类平台接入提供的共享交换服务类型包括：a)基于数据库表的共享交换服务；b)基于数据文件的共享交换服务；c)基于服务接口的共享交换服务。5.2接入准备5.2.1基础设施为保证前置机方式数据交换工作的顺利开展，应关注以下准备要求：a)前置机硬件要求：平台的交换性能与前置机的硬件配置有密切的关系，公共数据提供者和使用者根据交换业务需求确定前置机的基本硬件配置，交换量评估时应按照每条数据不超过10K计算，推荐配置见表2。表2前置机硬件要求交换量描述(条/d)磁盘(最低配置)b)前置机软件安装：1)交换节点软件：各接入单位按需在前置机部署交换节点软件，用于发送和接收数据；DB31/T1240.2—202072)数据库：各接入单位按需在前置机上部署交换前置数据库，在业务库表结构的基础上在前置数据库创建交换表；3)级联交换软件：区交换平台接入除安装交换节点软件外，还需部署级联交换软件级联共享区区交换平台接入，需建立级联共享区。准备工作主要包括：a)级联数据库安装及数据库初始化：1)数据库应选用符合市区级联需要的商用数据库产品；2)需在数据库中按照要求创建表并进行初始化，建表程序由市平台统一提供。b)文件存储区建立：1)级联共享服务器提供数据库和文件系统，前置机和级联系统服务器可共享使用，由各区进行管理，级联共享服务器中的文件系统需与区前置节点服务器连通，满足区平台和市平台对文件系统的读写能力；2)前置机中部署的级联程序需要访问级联共享服务器中的数据库和文件系统，各区需要配置网络端口保证前置机和级联共享服务器的联通；3)级联共享区主要用于存储级联过程中共享的数据，可根据各单位级联交换数据量大小配置磁盘，并及时对已过期数据进行清理。5.2.2网络接入IP规划各单位前置机IP由平台管理部门统一规划并下发。端口开放策略前置机需要单向、双向开放的网络端口及开放策略，见表3.表3端口开放策略端口号方向市平台一>前置机SSH远程安装级联程序、交换程序使用，此端口在程序部署时使用，后期可关闭市平台<->前置机库表、文件交换程序运行使用区平台->市平台服务接口程序运行使用交换管理中心与接入节点的双向链路测试，链路测试的方法包括：b)telnetIP端口。5.2.3共享资源库表资源对于计划通过数据库表方式共享的资源，公共数据提供者应对来源于内部系统的数据进行整理，形8DB31/T1240.2—2020成便于公共数据使用者识别与应用的可共享数据。为保证数据交换的顺利实施公共数据提供者应做好以下准备工作：a)数据交换方式、触发方式、抽取方式、运行周期、交换策略等应满足第4章接人技术要求中规定的接人方式；b)应将业务库和交换库进行隔离，避免因数据交换影响正常业务系统使用；c)应保证数据的有效性、完整性以及与实际业务数据的一致性，业务数据发生变化或更新需要按约定更新频率及时更新到交换前置库；d)应保证提供给多个使用方的数据是一致的，应针对公共数据使用者订阅时间不定等因素制定相关数据提供策略；e)应保证从业务数据库到交换前置库数据转移过程中的数据安全。文件资源公共数据提供者将已经明确的可共享信息资源，采用文件方式接入市平台，部门应根据自身业务数据形成周期、保存方式、文件大小等因素综合考虑设定文件交换任务，同时采用安全手段将文件传输至前置机。为保证数据交换的顺利实施，公共数据提供者应做好以下准备工作：a)应明确可共享的数据文件、共享范围及更新机制；b)应明确对数据的加密、签名等安全保密措施；c)应保证数据在前置机上的安全性；d)应通过FTP、SFTP等方式，按数据更新周期约定，及时将可共享文件上传至前置机交换目录。服务资源部门自建平台，并对外提供接口服务，作为公共数据提供者将已明确的可共享信息资源，采用服务接口方式接人市平台，部门根据内部信息系统整合的推进情况，做好以下准备工作：a)应明确服务接口的可共享信息项、共享数据及更新机制；b)根据业务需求完成服务接口的设计方案，应用于指导服务接口的技术实现；c)建立政务外网共享服务区，作为服务接口共享专用部署环境，接入政务外网，且要确保不影响部门内部信息系统的正常运行；d)服务接口应随着公共数据使用者的增多，实现性能的可扩展；e)公共数据提供者基于本部门可共享数据资源，进行服务接口开发，形成可以对外共享的服务接口；f)为确保服务接口的标准性和可用性，公共数据提供者提供服务接口应满足第4章节接入技术要求中规定的接入方式。建议事项包括：1)为避免外部服务调用对业务生产系统造成影响，建议将共享服务数据与生产数据分离，通过数据镜像等方式实现服务接口；2)为提供高并发、大规模的数据服务能力，公共数据提供者通过预估访问量，采用负载均衡、多读镜像库等方式提高服务接口并发能力；3)对于访问量小、不影响生产运行的系统，部门可以委托市平台进行接口开发并对外提供服务。5.2.4其他对接组织机构创建准备接入市平台的单位，需要向平台建设管理单位申请创建组织机构信息。DB31/T1240.2—20209用户账号创建准备接入市平台的单位，需要向平台建设管理单位申请创建相关账号，提交包括账号创建申请及创建账号信息。平台建设管理单位在接到接入单位的账号创建申请后，为其分配初始账号。用户账号授权平台建设管理单位将根据接人单位的申请为其账号分配相应权限，各接入单位用户账号可授权的角色权限包括：a)节点管理员：负责本部门的用户及权限相关设置；b)节点操作员：负责资源的注册、发布、订阅；c)节点审核员：负责对节点操作员的操作进行审核。5.3部门接入5.3.1数据归集数据归集范围市平台将各区及各委办桥接至前置机的发布资源归集至市级数据湖。库表资源发布公共数据提供者通过平台的任务发布订阅功能将资源进行归集，指定市级数据湖为接收节点(只有市级数据湖用户能够看到已发布的资源)。采用数据库表方式进行交换时，公共数据提供者需对库表资源进行数据源配置、资源归集，流程见开始开始数据桥接数据源配置资源创建资源归集结束业务系统技术人员节点操作人员图1库表资源发布流程库表资源发布流程步骤包括：a)数据桥接：业务系统技术人员应采用技术手段(如：系统数据同步、手工数据导入等),将需要对外共享交换的数据，加载到前置机交换数据库表中，并按照业务要求对交换库表中的数据进行及时更新；b)数据源配置：节点操作员应在平台中创建对应的数据源，作为对外交换的数据来源地，管理配置信息包括数据源名称、数据库类型、数据库驱动类名等；DB31/T1240.2—2020c)资源创建：基于创建好的数据源，节点操作员应发布数据库表资源，填写相关资源信息(数据源信息、所属前置节点、数据抽取方式、数据更新周期等),指定市级数据湖为接收节点，完成交换资源发布；d)资源归集：节点操作员应根据已发布资源信息创建数据库表资源，并对发布资源进行资源订阅，将数据交换到市级数据湖，完成数据的归集。文件资源发布采用文件或文件夹方式进行交换时，公共数据提供者需对文件、文件夹资源进行注册并发布，流程见图2。开始开始数据桥接资源创建资源归集结束业务系统技术人员节点操作人员图2文件资源发布流程文件资源发布流程步骤包括：a)数据桥接：业务系统技术人员应采用技术手段(如：FTP上传、手工拷贝等),将需要对外提供共享交换的文件，上传到前置节点服务器上的文件夹中；b)资源创建：针对已上传的共享文件，节点操作员应创建对应的文件资源，指定对应的文件路径、文件名，所属前置节点，发布时间间隔，指定市级数据湖为接收节点，完成交换资源发布；c)资源归集：交换到市级数据湖的文件，应由大数据平台抽取到大数据平台文件系统中，完成资源的归集。5.3.2数据共享数据共享范围市平台将已归集到数据湖中的资源挂接到目录系统并进行发布，供各区及各委办订阅。库表资源订阅采用数据库表方式进行交换时，公共数据使用者需对库表资源进行订阅，流程见图3。DB31/T1240.2—2020开始开始资源申请接收表建立数据源配置资源订阅结束节点操作员业务系统技术人员节点操作员图3库表资源订阅流程库表资源订阅流程步骤包括：a)资源申请：公共数据使用者节点操作员应通过目录系统查找所需资源，向公共数据提供者提出使用申请。b)接收表建立：业务系统技术人员进行数据接送准备，应在前置库中建立接收表，用于接收共享数据。c)数据源配置：针对用于接收共享数据的数据库表，节点操作员应在交换系统中创建对应的数据源，作为交换数据的目的地。d)资源订阅：节点操作员查找到所需资源后进行订阅，应将上一步创建的数据源设定为订阅接收并设置接收到的数据字段与接收表字段的映射关系。订阅成功后默认自动启动。业务系统技术人员采用技术手段(如：系统数据同步、手工数据导出等),将接收到的数据库表内容获取到业务系统中使用。文件资源订阅采用文件方式进行交换时，公共数据使用者需对文件、文件夹资源进行订阅，流程见图4。节点操作员资源申请资源申请资源订阅结束开始图4文件资源订阅流程DB31/T1240.2—2020文件资源订阅流程步骤包括：a)资源申请：公共数据使用者节点操作员应通过目录系统查找所需资源，向公共数据提供者提出使用申请。b)资源订阅：节点操作员查找到所需文件资源后应进行订阅，并设置订阅的文件接收目录。订阅成功后默认自动启动。业务系统技术人员采用技术手段(如：FTP下载、手工拷贝等),将前置机接收到的文件获取到业务系统中使用。服务资源订阅公共数据使用者通过目录系统查找所需资源，申请使用公共数据提供者发布的服务，流程见图5。开始开始服务资源查询服务资源申请服务资源授权服务资源使用结束节点操作员平台审核员/节点审核员节点操作员图5服务资源订阅流程服务资源订阅流程步骤包括：a)服务资源查询：节点操作员应通过目录系统提供的接口列表、分类检索和接口搜索功能进行资源信息的查找，从而获得相关的服务接口信息。b)服务资源申请：节点操作员查询到服务资源后，应在线填写服务使用申请，根据页面指示填写申请信息，如申请使用时间等。提交申请，等待授权。c)服务资源授权：对无条件共享的服务资源，应由平台审核员进行服务授权并向公共数据提供者备案；对有条件共享的服务资源，由公共数据提供者节点审核员进行服务授权。d)服务资源使用：公共数据使用者应在获得授权后按服务协议要求进行使用。公共数据使用者部门根据服务接口描述信息进行服务调用开发，封装申请授权等相关信息，进行服务接口调用，获取所需信息。5.3.3部门自建平台接入服务资源二次代理部门有自建交换平台，并对外提供接口服务，需通过市平台将服务二次代理发布供各部门使用。市部门对服务资源进行注册、发布，流程见图6。DB31/T1240.2—2020节点操作员节点操作员节点审核员平台审核员节点操作员开始服务注册服务注册审核服务质量审核发布进度查看结束图6服务资源发布流程公共数据提供者通过服务管理系统进行服务注册，经过审核发布后的服务信息在目录系统对外展现。部门自建平台服务资源发布流程主要包括：a)服务注册：节点操作员进行服务注册，应根据系统提示将服务信息注册到系统中，提交审核。b)服务注册审核：节点审核员登录平台，应对注册的服务进行审核，确认服务信息描述正确以及服务地址可访问。c)服务质量审核：平台审核员应对服务进行质量审核。质量审核通过之后，服务的状态会变成“待测试”,待通过可用性测试之后，服务自动发布，可供其他部门查询申请。d)服务发布进度查看：节点操作员可以随时登录交换系统中查看服务资源发布的审核状态，如果因信息填写或其他原因被平台管理员退回，则应及时进行信息的修改和重新提交等工作。如果服务审核通过，则可以通过目录系统查询到该服务。交换日志信息归集部门自建平台，应将自建平台数据资源的使用情况以交换日志形式归集到市平台，交换日志信息项、归集方式和归集周期要求主要包括：a)交换日志信息应采用明文、结构化方式存储，须归集数据字典用来说明信息项业务含义。信息项至少包括：1)库表交换：交换批次号、交换发送时间、交换接收时间、交换数据发送部门、交换数据接收部门、交换数据表名(源表、目标表)、发送数据量(条)、接收数据量(条)等；2)文件交换：文件发送时间、文件接收时间、文件发送部门、文件接收部门、文件名、文件大小等；3)服务调用：服务调用时间、服务调用IP、服务提供部门、服务调用部门、服务名，服务响应时间、服务调用结果(成功/失败)等；b)归集方式：交换日志信息可采用库表、文件或服务接口方式，通过前置机同步到市级数据湖；c)归集周期：在交换任务或服务调用发生时，同步将交换日志信息发送给市平台。DB31/T1240.2—20205.4.1使用市级分平台接入市级分平台建设所需服务器硬件资源要求如下：a)交换管理中心服务器硬件要求见表4;表4交换管理中心服务器硬件要求1b)中心交换节点服务器硬件要求见表5;表5中心交换节点服务器硬件要求22c)服务管理服务器硬件要求见表6。表6服务管理服务器硬件要求22市级分平台安装环境部署要求主要包括：a)软件安装：1)交换管理中心软件：市级分平台需在交换中心部署交换管理中心软件，用于交换过程的监控、管理。交换管理中心软件部署在交换管理中心服务器上。2)中心交换节点软件：市级分平台需在交换中心部署交换节点软件，用于发送和接收数据。中心交换节点软件部署在中心交换节点服务器上。3)服务管理软件：市级分平台需在交换中心部署服务管理软件，用于服务的发布、监控、管理。服务管理软件部署在服务管理服务器上。b)服务器端口开放策略见表7。DB31/T1240.2—202015表7各服务器需要开放的网络端口及开放策略注：市级分平台交换管理中心软件、中心交换节点软件、服务管理平台开通市级分平台联调测试通过后，交付区平台建设管理单位使用。5.4.2使用自建平台接入级联组成结构市区级联对接应基于统一的系统组成结构和接口报文通道标准进行基础设施建设，各区平台的级联模块(区端)的系统开发人员应参考本章节内容进行市区级联对接。系统组成结构和接口报文通道要求主要包括：a)系统组成结构：市平台与区平台的交换系统级联功能，由交换级联子系统提供实现。交换级联子系统的组成部分包括：交换软件、级联模块(市端)、级联共享区以及级联模块(区端),见图7:级联模块级联模块(市端)交换软件级联共享数据库访问文件读写服务访问级联模块(风端)区平台服务器市平台交换级联市端前置机图7系统组成结构DB31/T1240.2—20201)交换软件：交换软件应部署在区前置机上，实现市平台内跨节点的数据交换、服务接口调用功能。同时，交换软件与区平台之间应以服务接口方式进行互动。2)级联模块(市端):应将市平台推送给区平台的数据写入级联共享区，并将区平台推送给市平台的数据从级联共享区取出。3)级联共享区：应由数据库和文件存储构成，为级联模块(市端)与级联模块(区端)的交换缓存区，用于存储平台交换级联的资源发布信息和数据。4)级联模块(区端):应用于实现与级联模块(市端)对接。级联模块(区端)提供市、区平台交换数据在级联共享区的读取和写入功能，提供区平台内部资源的加工处理和接口调用功能。级联模块(区端)调用市平台交换软件提供的服务代理接口，实现对市平台服务接口资源的调用。b)接口报文通道：市平台与区平台的交换级联，应支持数据库表交换、文件交换和服务接口三种交换方式。级联模块(区端)与市平台之间的级联接口报文通信方式见表8。表8级联接口报文通信方式Web服务接口级联共享区及连接方式.1级联共享区描述市平台与区平台通过级联共享区进行库表与文件的级联交换，级联共享区中的内容包括管控数据和交换数据，具体要求包括：a)管控数据：平台级联时资源发布信息的交互报文，应用以触发对方级联模块对资源发布信息进行获取和处理。管控数据的存储方式是数据库表。级联共享区中的管控数据存放在两张库表中：1)MNG_DATA_DOWN表：管控数据下行表应用于存放市平台推送给区平台的资源发布信息；2)MNG_DATA_UP表：管控数据上行表应用于存放区平台推送给市平台的资源发布信息。b)交换数据：平台级联时的业务数据载体，包括数据描述信息和数据文件。数据描述信息存储方式是数据库表，数据文件的存储方式是文件。数据描述信息存放在两张库表中：1)DATA_DESC_DOWN表：数据描述下行表应用于存放市平台推送给区平台的数据文件描述信息；2)DATA_DESC_UP表：数据描述上行表应用于存放区平台推送给市平台的数据文件描述信息。市区级联管控数据和交换数据发生异常时，可参见附录A进行故障处理。.2级联共享区操作模式市平台与区平台进行级联交换时，两端的级联模块对级联共享区的典型操作模式见图8。DB31/T1240.2—2020级联模块级联模块(市端)数据写入数据描述下行表上行表交换数据级联共享区数据读取级联模块(区端)数据描述上行表数据文件数据文件级联模块(区端)管控下行表级联共享区数据写入数据读取交换数据管控图8共享区操作模式市平台向区平台级联交换时，级联模块(市端)应将管控数据或交换数据写入级联共享区，级联模块(区端)从级联共享区读取数据。区平台向市平台级联交换时，级联模块(区端)应将管控数据或交换数据写入级联共享区，级联模块(市端)从级联共享区读取数据。.3级联连接方式市区级联连接方式应按照如下标准执行：a)数据库连接：各区平台可根据实际情况选择合适的连接数据库的方式，如：JDBC、ODBC、数据库私有协议等。b)文件操作：数据文件应存放在市平台区前置机的文件路径下。各区平台可根据实际情况选择合适的访问和操作文件的方式，如：FTP、SSH、共享存储等。市平台提供生成和解析数据文件的API,保证不同平台对数据文件进行内容生成与解析时的一致性。级联共享区基本操作接口从级联共享区数据流向来看，级联模块(区端)会涉及对级联共享区的两种基本操作：从级联共享区接收数据、向级联共享区发送数据。.2接收级联交换数据接收级联交换数据应按照如下标准执行：a)接收资源发布信息：市平台推送资源发布信息到共享区后，级联模块(区端)应从共享区中获取资源发布信息。基本流程参考见图9:1)应从管控数据下行表(MNG_DATA_DOWN)中获取未读的记录(判断依据：OPERAT_STAT字段值为“未读”);2)获取记录中的资源发布信息，应进行处理(如：在区平台缓存，供区平台资源发布时使用);3)处理完成后，应更新管控数据下行表(MNG_DATA_DOWN)中该记录的读取状态，将DB31/T1240.2—202018OPERAT_STAT字段值由“未读”更新为“已读”。管控致据管控致据下行表MNG_DATA_DOWN获取管控数据交换数据数据描述下行表DATADESCDOWN级联共字区数据图9接收资源发布信息b)推送数据：当市平台推送交换数据给区平台时，级联模块(区端)从共享区中获取交换数据。基本流程参考见图10:1)应从数据描述下行表(DATA_DESC_DOWN)中获取未读的记录(判断依据：OPERAT_STAT字段值为“未读”);2)记录中的FILE_PATH字段定义了数据文件的存储路径，应解析获得该文件路径信息，根据文件路径，下载获得文件；3)应通过记录中的MNG_ID字段从管控数据下行表中找到对应的记录，得到本次交换数据关联的资源发布信息；4)应使用市平台提供的文件解析API对文件进行解析，并结合数据描述下行表中的文件描述信息进行数据内容校验；5)应结合发布资源信息、数据内容、数据描述相关信息，进行相应处理(如：在区平台缓存，供区平台数据交换时使用);6)处理完成后，应更新数据描述下行表(DATA_DESC_DOWN)中该记录的读取状态，将OPERAT_STAT字段值由“未读”更新为“已读”。交换数据交换数据数据下行表DATA_DESCDOWN级联共享区管控数据下行表MNGDATADOWN3.从管控表中检索关联的发布信息1.获取效据描述信息2.获取文件数据级联模块(×瑞，图10接收数据DB31/T1240.2—2020发送级联交换数据应按照如下标准执行：a)发送资源发布信息：当区平台需要发送资源发布信息给市平台时，级联模块(区端)向共享区中写入资源发布信息。基本流程参考见图11:1)应准备好资源发布信息等相关内容，向管控数据上行表(MNG_DATA_UP)中写人发布信息；2)应将OPERAT_STAT字段的值设置为“未读”;3)应将CREATE_TIME字段的值设置为当前时间；4)应将LAST_MODIFY_TIME字段的值设置为空。极联共享×极联共享×写入管控数据级联块【K端》管控数据上行表UP数据描述上行表DATA_DESC_UP数据文件交换数据图11发送资源发布信息b)发送交换数据：当区平台需要发送交换数据给市平台时，级联模块(区端)向共享区中写人交换数据。基本流程参考见图12:1)使用市平台提供的文件生成API,应将待交换的数据生成相应的数据文件，并将数据文件放入级联共享区相应文件路径下；2)应向数据描述信息上行表(DATA_DESC_UP)中写入待交换数据的描述信息，其中：FILE_PATH的值设置为上传文件的存放路径，OPERAT_STAT的值设置为“未读”、CREATE_TIME的值设置为当前的系统时间。级联人享区级联人享区2.写入数据描述信息1.放入文件组联模块(x端》管控致据上行表MNG_DATAUP数据描述上行表DATA_DESC_UP数据文件交换数据图12发送数据DB31/T1240.2—202020级联数据库表格式级联数据库表格式参见附录B。级联文件操作接口级联文件操作接口参见附录C。级联交换处理流程级联交换处理流程应按照如下标准执行：a)库表交换：应支持一次发布，多次供数。库表处理流程见图13:1)发布资源时，公共数据提供者应将库表类型的资源发布信息完整、准确地写入管控上行表。市平台进行处理后，资源信息即可在市平台上展现，并开始接受订阅；2)公共数据提供者每次提供数据时，应将数据文件放人级联共享区，同时提供与文件一一对应的数据描述信息；3)库表交换方式下，若已有多个部门或区级单位订阅，应由市平台提供单次数据的组播推送；4)区平台公共数据使用者应从管控数据下行表中获取资源发布信息，从数据描述下行表中获取下行数据文件的相关信息。21DB31/T1240.2—2020区平台(数据提供方)市平台区平台(数据需求方)开始开始向管控上行表写入资源发布信息资源发布信息获取资源发布信息，进行预处理检查是否有错误返回是更正信息否向级联共享区放入数据文件向数据描述上行表写入描途信息交换数据是否有是否错识返回是交换数据描述信息信息是否存错识否在市平台网站否在市平台网站上展现资源信息错误码返回错误码，提示提供方进错误码行修正获取管控下行表中将资源发布信息推送到指定范围内的区平台资源信息将资源发布信息推送到指定范围内的区平台资源信息进行处理后，在区内平合发布按服区内部门需求，登录市平台申请和订阅，指定数据需求部门描述信息数据文件描述信息数据文件.文件，进行预处理信息是否有错设是否描述信息文件返回错误码，提示提供方进行修将微据交换到求部门所在区华台描述信息文件返回错误码，提示提供方进行修将微据交换到求部门所在区华台错误码正b)文件夹交换：支持一次发布，多次供数。文件夹交换处理流程见图14:1)发布资源时，公共数据提供者将资源发布信息写入管控上行表，并提供包含文件夹路径的数据描述信息。市平台进行处理后，文件夹资源信息即可在市平台上展现，并开始接受订阅。2)公共数据提供者每次提供文件时，只需将文件放入指定的文件夹路径下即可。3)文件夹交换方式下，若已有多个部门或区级单位订阅，由市平台对每个文件进行组播推送。DB31/T1240.2—2020224)区平台公共数据使用者从管控数据下行表中获取资源发布信息，从数据描述下行表中获取下行数据文件的相关信息。区平台(数据提供方)开始向管控上行表写入资源发布信息向数据描述上行表写入描述信息是更正信息检查是否有错返回否向级联共享区放入文件准备下一个文件区平台市平台(致据需求方)市平台开始资源发布信息数据描述信息获取资源发布信息和数据描述信息，进行旗处理信息是否有错识是否返回错误码，提示提供方进行修正错误码在市平台网站返回错误码，提示提供方进行修正错误码将资源发布信息推送到指定范围内的区平将资源发布信息推送到指定范围内的区平台资源信息息，进行处理资源信息后，在区内平台发布按照区内部门需求，登录市平台申请和订阅，指定数据需求部门描述信息文描述信息文件文件获取文件，并交换到需求部门所在区文件获取文件，并交换到需求部门所在区平台文件，区内交换给儒求部门图14文件夹交换流程图c)文件交换：支持一次发布，一个文件。文件交换处理流程见图15:1)发布资源时，公共数据提供者将资源发布信息写入管控上行表，将文件放入级联共享区，并提供与文件对应的数据描述信息(文件共享时，一次发布只可包含一个共享文件);2)公共数据提供者完成上述整个流程后，市平台进行处理，文件资源信息即可在市平台上展现，并开始接受订阅；3)文件共享方式下，若先后有多个部门或区级单位订阅，由市平台针对本共享文件自动多次推送，无需公共数据提供者重复提供；4)区平台公共数据使用者从管控数据下行表中获取资源发布信息，从数据描述下行表中获取下行数据文件的相关信息。注：级联交换过程中，区平台提供资源发布信息或数据后，可通过管控上行表或数据描述上行表中的OPERAT_STAT(操作状态)和ERROR_CODE(错误码)获取市平台预处理的结果。市平台采用周期性处理模式，默认处理周期为1min。23区平台(数据提供方)开始向管控上行表写入资源发布信息向级联共享区放入文件向数据描述上行表入描述信息检查是否有错误返回是更正信息否结束市平台DB31/T1240.2—2020区平台(数据需求方)开始否资源发布信息数据描述信息文件获取资源发布信息、数据描述信息和文件，进行预处理信息是否有错突是在市平台网站返回错误码，在市平台网站错误码提示提供方进行修正上展现资源信错误码提示提供方进行修正将资源发布信息推送到指定范围内的区平台资源信息将资源发布信息推送到指定范围内的区平台资源信息平台发布按照区内部门省求，登录市平台申请和订阅，指定数拟需求部门描述倍息文件获取文件，并交涣到需求部门所在区描述倍息文件获取文件，并交涣到需求部门所在区平台软取文件，区内交换给需求部门图15文件交换流程图级联发布资源变更区平台向市平台提供库表或文件资源后，若需要对已发布资源的信息进行更新或状态变更，可通过对管控上行表(MNG_DATA_UP)记录中资源属性相关字段进行更新，实现资源信息更新和状态变更。DB31/T1240.2—202024表9管控上行表字段名称字段定义是否支持变更说明一不是资源属性或状态字段发布ID是一PUB_NAME发布资源的名称是—SOURCE_CODE资源来源机构编码是一TARGET_CODE资源发布范围机构编码是支持对发布范围内的机构进行调整(即：增删机范围机构编码即可。但删除机构时，受以下条件1.被删除的机构，不会得到系统提示通知；2.若对方已订阅，订阅流程不会被强制删除，即对方依然可获取后续发布的数据。对方一旦取消订阅，因该机构已不在发布范围内，将无法再3.若对方为市平台，已发布的资源信息不会被注：发布范围变更，不支持从机构编码变更为“all",也不支持从“all”变更为机构编码TYPE数据源类型否不准许更新DATA_SCHEMA用json串表示的公共数否不准许更新BIZ_CODE业务编码否不准许更新CATALOG_ID关联的目录ID是一STATUS发布资源的状态：缺省值为1是支持状态变更。不支持：启用->删除注：若连续两次进行状态变更，应间隔至少OPERAT_STAT操作状态：一不是资源属性或发布状态字段NOTE是CREATE_TIME该条记录的创建时间一不是资源属性字段LAST_MODIFY_TIME最后一次修改记录的时间一不是资源属性字段ERROR_CODE错误码—不是资源属性字段RESERVE_1预留扩展字段一RESERVE_2预留扩展字段RESERVE_3预留扩展字段一DB31/T1240.2—2020级联服务接口.1接口类型市平台为区平台访问市平台上的服务接口资源，提供了统一的服务访问入口，接口类型主要包括：a)业务服务接口：支持REST和WebService接口类型：1)REST上行入口地址：ip:port/httpproxy;2)WebService上行人口地址：ip:port/wsproxy,其中ip:port,为市平台服务人口的IP地址和端口，由市平台提供。b)系统服务接口：市平台提供了一组系统服务接口，入口地址为：ip:port/sysapi。ip和是市平台服务入口的IP地址和端口，由市平台提供。系统服务接口说明见附录D。.2签名使用方式区平台对市平台服务接口访问时，市平台采用签名或验签机制进行访问权限控制，未通过验签的请求会被拒绝。系统服务和业务服务签名流程包括：a)系统服务签名流程：市平台为区平台分配系统账户，提供平台身份标识、系统服务(列表查询、详情查询和服务注册)标识，以及用于签名的机构密钥。区平台调用系统服务接口时，使用机构密钥，对平台身份标识、服务标识和请求时间进行计算签名，进行服务列表查询、服务详情查询或服务注册的接口调用，流程见图16。图16系统服务签名流程b)业务服务签名流程：区平台用户登录市平台，进行服务检索申请，申请时需说明需求部门信息，审核通过后获得授权码。根据授权码，对请求者身份标识、服务标识和请求时间进行计算签名，调用平台的签名密钥获取接口，获取签名密钥。在后续的服务接口调用过程中，使用签名密钥进行请求签名，对请求者身份标识、服务标识和请求时间进行计算签名，进行服务接口调用。该签名密钥可以连续多次使用，直至密钥过期或主动更新。流程见图17。调用图17业务服务签名流程DB31/T1240.2—202026应根据实际请求部门，使用各自的授权信息(请求者身份标识和APPKey)。各部门应妥善保管授权信息，如果APPKey不慎泄露，应撤销此申请，重新申请服务使用APPKey获得密钥后，默认密钥有效期为1d(返回值中提示了密钥过期时间),在此过期时间之前，不能频繁获取密钥。级联交换日志信息归集区自建平台，应将自建平台数据资源的使用情况以交换日志形式归集到市平台，交换日志信息项、归集方式和归集周期要求包括：a)交换日志信息应采用明文、结构化方式存储，须归集数据字典用来说明信息项业务含义。信息项应至少包括：1)库表交换：交换批次号、交换发送时间、交换接收时间、交换数据发送部门、交换数据接收(使用)部门、交换数据使用人、交换数据表名(源表、目标表)、发送数据量(条)、接收数据量(条)等；2)文件交换：文件发送时间、文件接收时间、文件发送部门、文件接收(使用)部门、文件使用人、文件名、文件大小等；3)服务调用：服务调用时间、服务调用IP、服务提供部门、服务调用部门、服务名，服务响应时间、服务调用结果(成功/失败)等。b)归集方式：交换日志信息可采用库表、文件或服务接口方式，通过前置机同步到市级数据湖。c)归集周期：在交换任务或服务调用发生时，同步将交换日志信息发送给市平台。27DB31/T1240.2—2020(资料性附录)级联错误码对照表级联错误码对照表见表A.1。表A.1级联错误码对照表错误码错误描述1管控表PUB_ID值无效2管控表PUB_NAME值无效3管控表TYPE值无效4管控表STATUS值无效5管控表OPERAT_STAT值无效6管控表SOURCE_CODE值无效7管控表TARGET_CODE值无效8管控表DATA_SCHEMA值无效9管控表CREATE_TIME值无效管控表DATA_SCHEMA值不可变更管控表TYPE值不可变更管控表STATUS值变更不合规管控表TARGET_CODE值变更不合规管控表CATALOG_ID值无效管控表BIZ_CODE值无效文件夹类型资源，数据描述表中只可有一条关联记录数据描述表TYPE值无效，与管控表TYPE不一致数据描述表DATA_COUNT值无效数据描述表FILE_SIZE值无效数据描述表FILE_PATH文件路径无效文件与签名信息不一致DB31/T1240.2—202028(资料性附录)级联数据库表格式B.1管控数据表B.1.1表结构级联管控数据库表结构见表B.1。表B.1管控数据表结构字段名称字段类型说明truetrue发布ID,本次发布资源的编号PUB_NAMEtrue发布资源的名称SOURCE_CODEtrue资源来源机构编码(采用统一社会信用代码)TARGET_CODETEXTtrue资源发布范围机构编码(采用统一社会信用代码)。全国发布的情况：此处直接填写字符串“all”TYPEtrue数据源类型：DATA_SCHEMATEXT用json串表示的公共数据提供者的库表schema。TYPE值为0时，必填，描述表的信息，包括键、列名、数据类型等；TYPE值为1或4时，为空BIZ_CODEtrue管理部门统一通知)CATALOG_ID关联的目录IDSTATUS发布资源的状态：缺省值为1OPERAT_STATtrue操作状态0:未读NOTETEXTCREATE_TIMETIMESTAMPtrue该条记录的创建时间LAST_MODIFY_TIMETIMESTAMP最后一次修改记录的时间DB31/T1240.2—202029字段名称字段类型非空说明ERROR_CODEVARCHAR(10)错误码RESERVE_1VARCHAR(255)预留扩展字段RESERVE_2VARCHAR(255)预留扩展字段RESERVE_3VARCHAR(255)预留扩展字段B.1.2接口规范B.1.2.1管控数据操作描述B.级联模块(市端)将市平台上发布的可共享资源信息写人管控数据下行表(MNG_DATA_DOWN),级联模块(区端)从管控数据下行表中读取信息，并在区平台中进行资源发布。B.级联模块(区端)将区平台上的可共享资源信息写入管控数据上行表(MNG_DATA_UP),级联模块(市端)从管控数据上行表读取数据，并在市平台中进行资源发布。B.1.2.2管控数据表的读写B.级联模块(市端)连接管控数据下行表(MNG_DATA_DOWN),写入相应的信息。B.级联模块(区端)连接管控数据下行表(MNG_DATA_DOWN),读取相应的信息，根据处理结果，进行信息更新。B.级联模块(区端)连接管控数据上行表(MNG_DATA_UP),写入相应的信息。B.级联模块(市端)连接管控数据上行表(MNG_DATA_UP),读取相应的信息，根据处理结果，进行信息更新。B.1.2.3管控数据关键数据项定义与操作描述B.发布ID:本次发布资源的编号，要求保持表内唯一性。B.发布资源的名称：本次发布资源的名称，用于市平台或区平台对资源信息进行展现。为了具备可读性，建议在名称中含有资源提供部门、业务信息、资源类型等信息。B.资源来源机构编码：标识资源来源机构，即数据提供部门。B.资源发布范围机构编码：控制资源的发布范围，只有范围内的机构才可订阅资源。范围可以是一个或多个机构，对应地，机构编码可以是一个或多个，中间用逗号分隔。若发布范围为全国范围且不限机构，直接填写字符串“all”。B.数据源类型：待发布数据资源类型，包括数据库表(0)、文件(1)、文件夹(4)。B.数据schema:若发布的数据来源于库表，则描述表名、主键、列名、数据类型等必要信息，用于进行资源展现，并作为公共数据使用者准备数据接收库表的参考。B.业务编码：用于标识资源相关的业务种类。本阶段赋值“0”,后期扩展编码由市平台管理部门统一制定并通知。B.关联的目录ID:用于标识本次发布数据资源所关联的市平台政务信息资源目录，即：区平台上报资源目录到市平台后，由市平台生成的目录系统ID值。区平台应通过市平台目录系统提供的“目录查询”接口，获取ID并进行赋值。B.资源状态：设置本次发布资源的状态，如：1(启用)、2(停用)、3(删除)。默认发布为1(启用),表示资源当前可用；状态为2(停用)时，系统将不再进行数据推送；3(删除)是对已发布资源进行清DB31/T1240.2—2020理和删除，即取消发布。具体状态转换，详见“变更已发布资源”内容。B.1.2.3.10操作状态：用以提示对端级联模块进行信息处理的标志位，写入方赋值0(未读),读取方读取完成后更新该字段为1(已读)。B.1创建时间：标记本条记录的生成时间。B.2修改时间：标记本条记录最近一次处理的时间，任何一方在对记录中其他字段更新时同步更新。B.1.2.3.13错误码：标识本条记录在读取时发生的错误，由读取方进行赋值，提示写人方进行更正处理。B.1.2.4规则和约束B.1.2.4.1市平台、区平台在新增、停用、变更、删除发布之后，均需要级联模块操作相应级联共享区中的数据。B.1.2.4.2级联模块(区端)应能够及时地发现级联共享区中发生的变化，并据此进行相应的操作。数据写入方要保证“数据schema”能够真实有效地体现即将提供的数据格式。B.1.3操作说明B.1.3.1写入要求写入方发布资源时，根据管控表格式要求，准备资源发布信息，并按照标准的数据库操作方式写入。写入数据时，设置OPERAT_STAT的值为0(“未读”),设置CREATE_TIME的值为当前时间，设置LAST_MODIFY_TIME的值为空。B.1.3.2错误处理级联模块(区端)应对写人管控上行表的信息处理状态进行监控，若发现错误码，应按照错误码提示，对错误进行处理，并更新本条资源发布信息，更新时设置OPERAT_STAT的值为0(“未读”),设置LAST_MODIFY_TIME的值为当前时间。B.1.3.3记录检查读取方查询表中记录，对OPERAT_STAT值为0的记录进行读取和字段有效性检查，检查时若发现字段值存在错误，应更新记录中的错误码，并将OPERAT_STAT的值更新为1(“已读”),设置LAST_MODIFY_TIME的值为当前时间。B.1.3.4状态设置读取方读取数据处理完成后，将OPERAT_STAT的值更新为1(“已读”),设置LAST_MODIFY_TIME的值为当前时间。管控表中的DATA_SCHEMA字段，采用json串描述待发布数据的schema。如果资源类型为库表，则描述表的信息应包括：表名、主键、列名、数据类型等。B.2数据描述表B.2.1表结构数据描述表结构见表B.2。DB31/T1240.2—2020表B.2数据描述表结构数据项名称类型非空备注VARCHAR(50)true主键(UUID)MNG_IDVARCHAR(50)true管控数据表的外键TYPEtrue数据源类型：0:数据库表4:文件夹FILE_SIZEBIGINT关联的数据文件大小(单位：字节)。TYPE为0或1时，必填DATA_COUNTBIGINT关联的数据文件中包含的数据记录条数。TYPE为0时，必填FILE_PATHVARCHAR(255)true关联的数据文件存放路径。FILE_SIGNATURETEXT对文件的数字签名。COMPRESStrue数据文件是否为zip压缩格式：0:否OPERAT_STATtrue操作状态：TARGET_CODETEXT数据交换目标机构编码，以及送达状态、送达时间。targetCode是数据交换目标机构编码；status是送达状态，枚举值为：0:未到达time是送达时间，类型为TIMESTAMP,当status为0时，该字段的值为空CREATE_TIMETIMESTAMPtrue该条记录的创建时间EXPIRY_DATE数据清理期限(单位：d)LAST_MODIFY_TIMETIMESTAMP最后一次修改记录的时间ERROR_CODEVARCHAR(10)错误码RESERVE_1VARCHAR(255)预留扩展字段RESERVE_2VARCHAR(255)预留扩展字段RESERVE_3VARCHAR(255)预留扩展字段B.2.2接口规范B.2.2.1数据操作描述B.当进行实际的数据级联交换时，级联模块(市端)、级联模块(区端)将各自的交换数据写入到级联共享区，数据描述信息描述这些数据的相关信息；32DB31/T1240.2—2020B.当级联模块(市端)、级联模块(区端)从共享级联共享区中读取数据时，需要获取匹配的数据描述信息，并根据描述信息执行相关的动作(如获取文件，解析数据等)。B.2.2.2数据描述表的读写B.级联模块(区端)连接数据描述下行表(DATA_DESC_DOWN),读取相应的信息，根据处理结果，进行信息更新；B.级联模块(区端)连接数据描述信息上行表(DATA_DESC_UP),写入相应的信息；B.级联模块(市端)连接数据描述信息上行表(DATA_DESC_UP),读取相应的信息，根据处理结果，进行信息更新。B.2.2.3数据描述信息关键数据项定义与操作描述B.2.2.3.1管控数据表的外键：与管控数据关联，描述本次级联交换的数据所关联的资源信息。数据描述信息必须与管控数据关联，一条管控数据可以被一条(数据源为文件、文件夹)或者多条(数据源为库表)数据描述信息所关联。B.数据源类型：交换的数据源类型，取值为0(数据库表)、1(文件)或4(文件夹)。该字段的值，必须与关联管控数据TYPE字段的值一致。B.数据文件大小：记录数据文件的大小(单位：字节)。TYPE为0或1时必填，且为文件真实大小。TYPE为4时无需填写。B.数据记录条数：记录数据文件中的数据条数。TYPE为0(数据库表)时必填，且为文件中实际数据条数。B.数据文件路径：记录数据文件的存放路径。TYPE为0或1时，为文件全路径；TYPE为4(文件夹)时，为文件夹路径。B.文件签名：对文件的数字签名。双方的级联模块通过文件签名与验签，检查文件一致性。TYPE为0或1时，若写人方提供签名，读取方应进行验签。TYPE为4时，为空，为确保一致性，文件签名和验签使