1、 ICS 35.020 L 70 上 0031 海市士也方标2佳 DB31月1240.2-2020 公共数据共享交换工作规范 第2部分:平台接入技术要求 Work specification 00 public data sharing and exchange一 Part 2: Technical requirement of platform access 2020-09-01发布2020-11-01实施 FTfX .町、飞/1 配音Z4乌tf 置，结a士如 上海市市场监督管理局发布 4 DB31月1240.2-2020 目次 前言. . . . . . . . . . . . . . .
2、 . . . . . . . . . . . . m 1 范围 2 规范性引用文件. 3 术语和定义 4 接人技术要求. . . . . . . 2 4.1 接入方式. . . . . . 2 4.2 接人要求. . . 5 接入流程要求. 5.1 接入服务分类. . . . . . . . . . . .6 5.2 接人准备. . . . . . 6 5.3 部门接入. . . . . . . . . . . . . . . . 9 5.4 区接入. . . . . . . . 14 附录A(资料性附录级联错误码对照表. . . . . . . 27 附录B(资料性附录级联数据库表格式. .
3、 . . . 28 B.1 管控数据表. . . . . . . . . . .28 B.2 数据描述表. . . . . . . 30 附录C(资料性附录级联文件操作接口. . . . . . . 34 C.1 概述. . . . . . 34 C.2 数据文件读写. . . . . . 34 C.3 文件签名接口. . . . . . . . . . . . . 35 附录O(资料性附录级联系统服务接口. . . . . . . . 37 0.1 服务列表查询接口. . . . . . . . . 37 0.2 服务详情查询接口. .,. . . . . . . . . . 38 0.3
4、服务信息注册接口. . . . . . . . . . . . . . 40 0.4 签名密钥获取接口G 参考文献. . . . . . . .,.ltlt. . . . 45 I DB31月1240.2-2020 前言 DB31/T 1240(公共数据共事交换工作规范分为以下2个部分z 一一第1部分z平台建设和运行管理要求z 一一第2部分z平台接入技术要求。 本部分为DB31/T1240的第2部分。 本部分按照GB/T1.1-2009给出的规则起草。 本部分由上海市人民政府办公厅电子政务办公室提出并组织实施。 本部分由上海市公共数据标准化技术委员会归口。 本部分起草单位z上海市大数据中心、上
5、海计算机软件技术开发中心、北京东方通科技股份有限 公司。 本部分主要起草人z朱宗尧、刘迎风、储昭武、傅行晓、李雪凝、杨琳、郭大勇、李黎明、许志远。 mm 1 范围 公共数据共享交换工作规范 第2部分:平台接入技术要求 DB31/T 1240.2-2020 本部分规定了上海市数据共享交换平台的接入技术要求和接人流程要求，包括接入方式、接人要 求、接人准备、部门接人和区接入等内容。 本部分适用于上海市数据共享交换平台各相关单位的接人工作。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本(包括所有的修改
6、单)适用于本文件。 DB31/T 1240.1 -2020 公共数据共享交换工作规范第1部分z平台建设和运行管理要求 3 术语和定义 DB31/T 1240.1-2020界定的以及下列术语和定义适用于本文件。 3.1 级联cascade 市平台与区平台进行业务和数据对接，实现市、区两级平台的互联互通。 3.2 级联共享区cascade sh町ed町ea 用于市、区两级平台级联信息交互的区域，以数据表、文件的方式存储级联过程中的业务数据及交 换过程中的资源数据。 3.3 级联鼓据文件cascade data me 级联交换的实际业务数据的载体，主要有两种类型，源于数据库表的数据文件和传统的业务数
7、据 文件。 3.4 市级联系统municipal cascade system 市平台中实现市、区级联的系统，由市平台负责开发实现，部署于市平台系统环境中(含区级前置 系统)。 3.5 区级联系统district cascade system 区平台中实现市、区级联的系统，由区平台负责开发实现，部署于区平台系统环境中。 3.6 上行接口upstream inlerface 市级联系统的组成部分，通过上行接口，区平台向市平台提交资源申请与审核数据、交换业务数 据等。 DB31月1240.2-2020 3.7 上行敢据表opstream data table 区级联系统的组成部分，数据库表的方式存
8、在，部署于级联共享区。通过上行数据表，区平台向市 平台提交资源交换信息，资掘接收回执等。 3.8 下行数据表downstream data table 区级联系统的组成部分，数据库表的方式存在，部署于级联共享区。通过下行数据表，市平台向区 平台下发资源申请与审核业务数据、交换业务数据、资据信息等。 4 接入技术要求 4.1 接入方式 4.1.1 接入方式类型 区公共数据和管理部门、市级公共管理和服务机构可采用前置机交换和服务接口两种交换方式接 人平台。 a) 前置机交换E平台通过前置数据Jl表茹前置机文件目录进行数据交换，各接人单位通过桥接方 式挟取前置数据库表内容或前直机的文件，向前置数据库
9、表i桌前置机文件目录推送数据= 1) 数据库表交换E在公共数据提供者以数据库表结构化方式存储，并以库表方式进行全量或 增量数据的交换$ 2) 文件交换z适用于非结构化资mt或道新频率比较缓慢的结构化资源的交换。 b) 服务接口交换z以Web服务作为平台与各接人单位之间数据获取和推送的接口，在平台中代 理业务系统提供的Web服务，对外隐藏该Web服务的真实URL，使用代理的URL即可访问 业务系统真实的Web服务，以达到数据交换的目的。 4.1.2 前置机 4.1.2.1 交换方式 2 前置机交换有以下三种方式: a) 基于任务交换z两个节点需要信息隐私保护机制的交换方式，在两个节点之间建立传输
10、通道， 通过库表或文件的形式，将数据或文件交换到对方节点，分为数据库交换和文件交换两种形 式。基于任务交换的前提应是传输节点明确，任务明确般以下情形采用此类交换z 1) 节点库表1对l之间的传输任务p 2) 节点文件夹之间的传输任务; 3) 双方协商周期性交换的传输任务$ 4) 双方协商一次性交换的传输任务。 b) 任务发布订阅z公共数据提供者发布数据资源任务，公共数据使用者进行订阅获取数据的交 换方式。数据被订阅后，平台将数据推送到订阅单位前置节点。其中，任务的发布者负责对 数据的发布，并限定订阅者的范围，不约束订阅者的行为。任务发布订阅交换的前提是发布 者明确拥有的数据资源般下列情形采用此
11、类交换z 1) 任务发布者无法明确订阅者对象的传输任务p 2) 任务发布者认为该数据有价值，可以对外共享的任务。 c) 资掘发布订阅z资源发布订阅交换是通过资源目录中发布和订阅资摞进行数据交换的方式。 资眼发布单位通过交换系统的资源目录注册数据资源的元数据信息，资由、订阅单位通过数据 DB31月1240.2-2020 的元数据信息可以直观查看资源发布方数据的具体业务含义，并根据业务需要订阅数据。数 据订阅后，交换系统将数据交换到资源订阅单位节点。一般下列情形采用此类交换z 1) 资源发布者无法明确订阅者对象的传输任务F 2) 资源发布者认为该资拥有价值，可以对外共享的传输任务; 3) 资源订阅
12、者需要了解资源发布方数据的业务含义。 4.1.2.2 触发方式 交换触发是控制平台内交换任务、发布订阅任务、资源发布订阅任务的运行或停止，触发方式主要包括z a) 手动触发z基于直接交换中配置好的任务和流程，手动启动交换、停止交换的一种触发方式，手 动触发方式任务只执行一次; b) 自动触发z平台按照设定的运行周期执行交换的一种触发方式。 4.1.2.3 抽取方式 前置机抽取方式主要包括z a) 触发器z在源数据库中建立相应触发器，当数据发送改变时直接触发数据的抽取和交换F b) 时间戳E通过源表中的时间戳字段来标记数据的新增、修改，每次只抽取从上次抽取结束时间 开始的增量数据z c) 标志位
13、z通过在源表中设计标志位字段来标记数据是否已经被抽取，交换系统在完成数据抽取 后会修改该标志位，从而实现增量交换。 4.1.2.4 交换运行周期 交换运行周期设定是平台内交换任务、发布订阅任务、资源发布订阅任务的执行时间设定，平台提 供两种交换运行周期z a) 循环时间间隔z配置时间间隔为运行周期，交换以此时间间隔持续运行p b) 定时器规则z配置的具体时间点为运行周期，当时间点满足时触发交换运行。 4.1.2.5 交换策略 交换策略是指平台运行时如何获取数据的规则，平台提供两种交换策略z a) 全量交换z平台一次性将数据库表中的所有数据交换到目标节点的交换方式。全量交换要求 业务库表应具有主
14、键标识。 b) 增量交换z指平台周期性从数据库表中获取最新数据并交换到目标节点的交换方式z 1) 时间戳交换z平台根据业务数据的时间戳变化获取增量数据，并将增量数据交换到目标 节点的交换方式p 2) 标识位交换z平台根据业务表中的标识字段值的变化获取增量数据并将增量数据交换到 目标节点的交换方式p 3) 触发器交换z平台利用数据库触发器获取增量数据并将增量数据交换到目标节点的交换 方式。 4.1.2.6 数据支持 平台具备全面的数据支撑能力，在表字段数量、长度和数据类型等方面无任何限制，表宇段数量、长 度和数据类型等仅受当前接人的数据库类型制约。平台提供多种数据库支持能力以及数据库类型转换 支
15、持能力，包括z a) 数据库支持:支持DM、Kingbase，GBase、Oracle、DB2、Sybase、Mysql等多种数据库的适配接人; DB31月1240.2-2020 b) 类型转换支持z不同数据库之间相同类型的字段可以相互转换。 4.1.3 服务接口 4.1.3.1 服务接口类型 公共数据提供者以服务接口方式共享资源时，可选择的接口类型包括:REST和WebService. 4.1.3.2 服务接口协议 为确保服务接口的标准性和可用性，服务接口统一按照以下协议规范和技术要求对外呈现z u 服务传输协议z采用HTTP/S1.0/1.1标准; b) 服务消息协议:Web Servic
16、e服务消息封装协议采用SOAP1.1/1.2标准;REST服务消息封装 协议采用HTTP1.0/1.1标准z c) 服务描述z应包含服务调用者使用的具体访问接口内容，主要包括数据类型定义、操作、交互消 息格式和内容、端口类型及绑定等内容，内容格式应按照WSDL1.1的规定进行描述: 1) 数据类型定义应按照XMLSchema 1.0规范的规定使用; 2) 消息(Message)应采用类型定义整个消息的数据结构，消息类型定义应按照XML Schema 1.0规范的规定使用z 3) 端口类型(PortType)应定义Web服务的操作，及操作中对应的输入输出参数和消息交互 模式; 4) 绑定形式应使
17、用DocumentLiteral/Wrapped文挡风格，禁止使用RPCEncoding及Doc ument Encoded形式，应使用SOAP1.1/1.2版本标准，通信应绑定HTTP/S标准协议; 5) 消息字符集和编码应保持一致，应采用GBK或UTF-8。 4.1.3.3 服务接口调用频次 平台提供服务接口的调用频次控制功能，以实现对服务调用方在单位时间内调用某个具体服务接 口的总次数进行控制。调用频次的单位为次/d. 4.1.3.4 服务接U安全 4 为确保服务接口的安全性，平台提供服务接口应统一按照以下方式进行安全控制z a) 客户端访问控制z对公共数据使用者的使用权限进行控制，主要
18、表现为申请授权和权限验证。 公共数据使用者在需要使用某个服务接口时，需要首先通过市平台发起对该资源的使用申请， 申请时需要添加身份信息(包括组织机掏名称，IP地址、应用场景、应用系统、申请人、联系方 式).市平台在完成相关信息审核或备案后，为申请方分配唯一的身份标识并提供授权码(AP PKey) .公共数据使用者每获得一个服务接口的使用授权，市平台都将为其生成一个授权码， 即一事一码。公共数据使用者在获得服务接口的使用授权后，在发起服务调用时，需要在请求 信息中携带自己的身份标识及相关签名信息，市平台在收到使用方的服务调用请求后，会验证 请求信息中的身份签名信息，从而判断该请求是否为合法用户的请求，达到验权的目的。 b) 动态密钥z公共数据使用者在发起服务调用前，首先需要使用已经获得的授权码获得服务调 用的动态密钥，然后使用动态密钥完成对服务的请求。动态密钥具有有效期限制，目前动态密 钥的有效期为1d.每
个人主页
