国家数据共享交换平台(政务外网)库表交换、文件交换操作指南V2.0

国家数据共享交换平台（政务外网）库表交换、文件交换操作指南（V2.0）国家电子政务外网管理中心二〇一八年一月2目录一、指南说明.................................4（一）概述...............................4（二）内容概要...........................4（三）角色说明...........................5（四）术语和定义.........................5二、网络接入.................................6三、工作流程.................................6（一）资源准备...........................6（二）资源注册...........................6（三）资源申请...........................7（四）资源订阅...........................7四、库表交换.................................8（一）库表注册、发布.....................81、操作流程..........................82、操作步骤.........................10（二）库表申请、订阅....................421、操作流程.........................462、操作步骤.........................48五、文件交换................................50（一）文件注册、发布....................5131、操作流程.........................512、操作步骤.........................52（二）文件申请、订阅....................971、操作流程.........................972、操作步骤.........................994一、指南说明（一）概述为指导资源提供方和资源需求方通过国家数据共享交换平台（政务外网）提供和使用库表资源、文件资源，特制定本指南。国家政务信息资源共享的形式有服务接口、库表交换、文件交换。本指南主要指导资源提供方和资源需求方在国家共享平台通过库表交换、文件交换形式实现国家政务信息资源共享。服务接口方式的具体操作详见《国家数据共享交换平台（政务外网）服务接口操作指南》（试行）。（二）内容概要本指南主要包括网络接入、工作流程、库表交换、文件交换四部分。网络接入部分主要指导各中央政务部门进行网络整合、接入政务外网的操作。工作流程部分主要指导资源提供方和资源需求方提供和使用库表、文件资源需要做的关键工作。库表交换部分主要指导资源提供方和资源需求方进行库表注册、发布、申请、订阅等具体操作。文件交换部分主要指5导资源提供方和资源需求方进行文件注册、发布、申请、订阅等具体操作。（三）角色说明库表、文件资源的提供和使用涉及角色主要有资源提供方操作人员、审核人员和资源需求方操作人员、审核人员。资源提供方操作人员完成库表、文件注册、发布工作，资源需求方操作人员完成申请、订阅工作。资源提供方审核人员负责对库表文件注册、申请的审核，资源需求方审核人员负责对库表文件订阅的审核。（四）术语和定义本文涉及到的专用名词及术语定义如下：政务外网局域网：接入政务外网的逻辑隔离区域，与部门其他网络之间有明确边界。国家共享平台：国家数据共享交换平台（政务外网），对外服务的入口是共享网站（）。资源提供方：通过国家共享平台提供资源的中央政务部门、省（自治区、直辖市）。资源需求方：通过国家共享平台获取资源的中央政务部门、省（自治区、直辖市）。6二、网络接入中央政务部门需要在政务外网局域网设置政务外网服务区（DMZ）和政务外网终端区，政务外网服务区部署交换前置节点和参与共享交换的服务器，政务外网终端区能主动访问政务外网的终端。具体操作详见《国家数据共享交换平台（政务外网）部门接入指南》（试行版）中网络接入部分。三、工作流程（一）资源准备资源提供方应对来源于本单位政务信息系统的库表资源和文件资源进行整理，形成便于资源需求方识别与应用的可共享库表和文件资源。资源提供方应将共享的库表、文件资源对应的目录同步到国家共享平台。（二）资源注册资源提供方操作人员在国家共享平台，将准备好的库表、文件资源进行注册并完成发布。7（三）资源申请资源需求方操作人员在国家共享平台，按照需求进行资源申请。申请国家共享平台授权的资源，需要国家共享平台审核人员审核，审核通过后，服务接口类型申请审核自动备案，库表、文件申请审核没有备案；申请资源提供方授权的资源，需要资源提供方审核人员审核，审核通过后，服务接口类型申请审核自动备案，库表、文件申请审核没有备案。（四）资源订阅资源申请审核通过后，资源需求方操作人员根据资源提供方的资源共享方式（库表交换或文件交换）进行资源订阅，订阅时需指定具体的数据接收部门。（五）资源变更资源变更是操作人员对已成功发布并由平台审核员-发布审核【通过】的资源信息进行【变更】的操作过程，进入数据交换系统【资源交换-资源注册-数据库资源/文件资源】中对已注册的资源进行变更。（六）资源撤销资源撤销是操作人员对已成功发布并由平台审核员-发8布审核【通过】的资源信息进行【撤销】的操作过程，进入数据交换系统【资源交换-资源注册-数据库资源/文件资源】中对已注册的资源进行撤销。四、库表交换（一）库表注册、发布1、操作流程采用库表方式进行交换时，资源提供方需在国家共享平台对库表资源进行注册、发布，流程如下：（1）数据桥接业务系统技术人员将对外共享交换的数据加载到前置交换数据库表中，并按照业务要求，对交换库表中的数据进行及时更新。数据桥接数据源创建资源注册资源审核资源发布业务系统技术人员操作人员操作人员操作人员审核人员9（2）数据源创建并注册操作人员在交换系统中创建对应的数据源，并对数据源进行配置，配置信息包括数据源名称、数据库类型、数据库驱动类名等；数据源创建完成后进行注册。（3）资源注册基于创建好的数据源，资源提供方操作人员在国家共享平台的交换系统中注册数据库表资源，并完成库表资源与目录关联。（4）资源发布资源提供方操作人员在国家共享平台的交换系统中对审核通过的库表资源进行发布，并设置相应的发布属性（更新周期、范围、条件等）。（5）资源变更和撤销资源提供方操作人员在国家共享平台的交换系统中对平台发布审核通过的库表资源进行变更和撤销操作，即变更是变更注册表资源数据信息的操作；撤销是对已发布表资源信息的撤销和注册表资源信息的删除操作。102、操作步骤（1）数据源创建并注册数据源创建资源提供方操作人员登录国家共享网站，点击【用户中心】，进入用户中心首页，点击【交换系统】或点击【快捷操作-注册数据资源】跳转到交换系统首页进入到【数据交换系统】中。11在数据交换系统主界面点【基础设施】，然后点击【数据源管理】，进入数据源管理的界面，点击【新增】。在数据源管理中，关于数据源的详细信息介绍如下：拆分：将数据源拆分多个子数据源卸载：原名为“反部署”，现更名为“卸载”。卸载是指将节点上数据源的信息删除，卸载与部署对应部署：将中心的数据源下发到各节点上12修改：更改此数据源的配置信息删除：删除此数据源进入数据源新增页面，填写数据源信息，确认无误后，点击【确定】，也可点击【取消】，取消新增。在数据源新增界面中，填写数据源的相关信息如下：数据源名称：根据需求命名自己的数据源名称。交换所属域：选择该用户所在的域。节点名称：选择该用户所属的节点。数据库类型：选择该用户所使用到的数据库类型，支持Oracle、Sqlserver、Sybase、db2、Mysql5等。驱动类名：默认加载出来的。连接URL：连接数据库所在服务器的路径及端口号和库名等参数。用户名：数据库用户名。13密码：数据库密码。最小连接数：最小能够同时接受多少客户的连接，默认是5，可以选择默认即可。最大连接数：最大能够同时接受多少客户的连接，默认是25，可以选择默认即可。有效性检查SQL：用来验证数据库连接的查询语句。Schema名称：数据库对象的集合，一个用户对应一个Schema。备注：根据需求自己填写即可。查询数据源可以根据数据源名称、数据库类型、节点名称进行查询，如下图所示：新增数据库资源若添加数据库资源，进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，14点击【新增】。在数据库资源中，关于数据库资源的详细信息介绍如下：表资源：在该库下所有表的信息获取到并进行注册修改：更改此数据库资源的信息项删除：删除该数据库资源项进入数据库资源新增页面，填写数据库资源信息，确认无误后，点击【确定】，也可点击【取消】，取消新增。15新增数据库资源信息如下：数据库资源名称：数据库的名称。数据源名称：选择在数据源管理中创建的数据源。应用系统名称：该应用系统的名称。所属机构：默认显示即可。姓名：填写创建此数据库资源的操作人即可。职务：填写对应的职务即可。电话：根据相对应的格式填写电话。手机：根据相对应的格式填写手机号。邮箱：填写联系邮箱。数据库描述：填写数据库的备注信息。修改数据库资源进入数据库资源列表页面，找到要修改的数据库资源，在右侧【操作】列中，点击【修改】。16进入数据库资源修改页面，修改信息，确认无误后，点击【确认】，也可点击【取消】，取消修改。注：点击【确定】时，如果该数据库资源已经有交换任务或被发布/订阅资源使用，页面会提示“该数据库资源已被使用，并要求用户再次确认是否更新数据库资源”，避免错误操作。删除数据库资源在删除数据库资源操作时，一次可选中一个数据库资源进行删除操作，也可选中多个数据库资源进行批量删除操作。在数据库资源列表页面，选择要删除的数据库资源，点击【删除】。弹出删除提示框，点击【确定】，删除数据库资源；点击【取消】，取消删除。17注：如果要删除数据库资源已经有交换任务或已经被发布/订阅资源使用，则提示被哪个（些）资源使用，不允许删除。查询数据库资源进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，可根据数据库名称、注册时间等来进行查询。18数据库资源注册完成后，需要继续对数据库中的表进行注册。（2）资源注册资源提供方操作人员登录国家共享网站，点击【用户中心】，进入用户中心首页，点击【交换系统】或点击【快捷操作-注册数据资源】跳转到交换系统首页进入到【数据交换系统】中。19进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，找到数据库资源，点击操作列【表资源】。20进入表资源列表页面，点击【注册资源】，弹出请选择导入的表页面，选择要导入的表，点击【确定】，也可点击【取消】。点击【确定】后，进入表资源注册页面，填写表资源信息，确认无误后，点击【确定】，也可点击【取消】。21新增表资源信息如下：表资源名称：Source,表资源名称不可以重复。组织机构：该登录当前用户的所属机构。数据库表名：注册时选择的默认的表资源名称。Schema名称：该注册的表资源所在的数据库名称。更新周期：根据选择的对应的周期进行表资源的更新；每日/每日更新一次；每周/每周更新一次；每月/每月更新一次；每季度/每季度（三个月）更新一次；每半年/每半年更新一次；每年/每年更新一次；实时/根据表资源的改动同步进行更新。所属域：例如/公共域。来源系统：该用户所属的组织机构下的来源系统信息。目录标识：选择该用户所创建的目录标识作为注册该表资源的挂接目录。22是否共享：分为有条件共享和无条件共享；有条件共享/申请该表资源时由