《基礎教育管理信息化技術規(guī)范 第5部分：數(shù)據(jù)交換規(guī)范》

ICS35.080

CCSL77

DB4403

深圳市地方標準

DB4403/TXXXXX—2022

代替SZDB/Z6.2—2007

基礎教育管理信息化技術規(guī)范

第5部分：數(shù)據(jù)交換規(guī)范

Technicalspecificationsfor

basiceducationmanagementinformatization—

Part5：Dataexchangespecification

2022-XX-XX發(fā)布2022-XX-XX實施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/TXX—2022

基礎教育管理信息化技術規(guī)范

第5部分：數(shù)據(jù)交換規(guī)范

1范圍

本文件規(guī)定了教育管理數(shù)據(jù)共享交換原則、交換方式及共享平臺接入規(guī)范。

本文件適用于深圳市教育管理信息化建設工作。

2規(guī)范性引用文件

本文件沒有規(guī)范性引用文件。

3術語和定義

本文件沒有需要界定的術語和定義。

4數(shù)據(jù)共享交換原則

數(shù)據(jù)共享交換遵循“數(shù)據(jù)驅動、應用牽引、協(xié)同共進”的原則，旨在打破各教育單位之間的數(shù)據(jù)壁

壘，促進信息互聯(lián)互通。

數(shù)據(jù)共享交換參與方主要包括：數(shù)據(jù)提供方、數(shù)據(jù)需求方和平臺管理方。以下為各數(shù)據(jù)共享交換參

與方的主要職責：

——數(shù)據(jù)提供方應保障所提供教育數(shù)據(jù)的完整性、準確性、時效性和可用性；

——數(shù)據(jù)需求方應嚴格按照數(shù)據(jù)申請流程獲取數(shù)據(jù)，嚴格按照共享范圍使用數(shù)據(jù)；

——平臺管理方應負責數(shù)據(jù)對接/共享平臺的運行維護和數(shù)據(jù)資源的歸集、更新和發(fā)布。

5數(shù)據(jù)共享交換方式

5.1基于數(shù)據(jù)庫的交換方式

5.1.1結構說明

基于數(shù)據(jù)庫的交換方式結構圖見圖1：

1

DB4403/TXX—2022

圖1基于數(shù)據(jù)庫的交換方式

5.1.2適用場景

基于數(shù)據(jù)庫的數(shù)據(jù)交換方式適用于實時、周期性、大數(shù)據(jù)包、小數(shù)據(jù)包、結構化數(shù)據(jù)場景。

5.1.3數(shù)據(jù)庫接入參數(shù)

基于數(shù)據(jù)庫的接入參數(shù)參見附錄A。

5.2基于文件的交換方式

5.2.1結構說明

基于文件的交換方式結構圖見圖2：

圖2基于文件的交換方式

2

DB4403/TXX—2022

5.2.2適用場景

基于文件的交換方式適用于實時、周期性、大數(shù)據(jù)包、小數(shù)據(jù)包、結構化數(shù)據(jù)、非結構化數(shù)據(jù)、半

結構化數(shù)據(jù)場景。

5.2.3文件上傳下載接口說明

文件上傳和下載接口協(xié)議使用HTTP（HTTPS）協(xié)議，通過提供訪問的URL，用戶使用HTTPPOST方

法發(fā)送請求。以下列出了具體的文件上傳下載接口說明：

a)文件上傳接口參數(shù)見表1。

表1文件上傳接口參數(shù)表

接口參數(shù)參數(shù)說明

uploadPath文件上傳路徑

fileName上傳文件名稱

userName賬戶名稱

passWord賬戶密碼

b)文件下載接口參數(shù)見表2。

表2文件下載接口參數(shù)表

接口參數(shù)參數(shù)說明

targetFile文件下載路徑

userName賬戶名稱

passWord賬戶密碼

c)服務端會返回調用狀態(tài)碼，見表3。

表3服務端返回調用狀態(tài)碼表

狀態(tài)碼狀態(tài)說明

200調用成功

401鑒權異常：用戶不存在、用戶密碼錯誤

400參數(shù)為空

417下載文件不存在、上傳時創(chuàng)建文件夾失敗

5.3基于服務接口的交換方式

5.3.1服務接口結構說明

基于服務接口的數(shù)據(jù)交換方式見圖3：

3

DB4403/TXX—2022

圖3基于服務接口的交換方式

5.3.2適用場景

基于服務接口的交換方式適用周期性、小數(shù)據(jù)包、結構化數(shù)據(jù)、非結構化數(shù)據(jù)、半結構化數(shù)據(jù)場景。

5.3.3服務接口請求對象參數(shù)

服務接口請求對象的XMLSchema格式為：

<?xmlversion="1.0"encoding="UTF-8"?>

<xs:schemaxmlns:xs="/2001/XMLSchema"elementFormDefault="qualified">

<xs:elementname="DBExRequest">

<xs:complexType>

<xs:sequence>

<xs:elementref="esb_service_id"/>

<xs:elementref="esb_token"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:elementname="esb_service_id"type="xs:int"/>

<xs:elementname="esb_token"type="xs:string"/>

</xs:schema>

服務接口請求對象的參數(shù)說明，見表4。

表4服務接口請求對象參數(shù)表

參數(shù)名稱參數(shù)類型參數(shù)說明

esb_service_idInteger訪問服務標識，關聯(lián)以下8個屬性：

senderCode:數(shù)據(jù)請求發(fā)送方機構代碼

senderName:數(shù)據(jù)請求發(fā)送方機構名稱

receiverCode:數(shù)據(jù)請求接收方機構代碼

receiverName：數(shù)據(jù)請求接收方機構名稱

4

DB4403/TXX—2022

表4服務接口請求對象參數(shù)表（續(xù)）

參數(shù)名稱參數(shù)類型參數(shù)說明

resourceID:資源標識符（業(yè)務編碼）

resourceName:資源名稱（業(yè)務名稱）

userID:用戶標識符

userName:用戶名稱

esb_tokenString認證令牌

6共享平臺接入規(guī)范

6.1接入流程

6.1.1接入流程圖

共享平臺接入流程圖見圖4。

圖4共享平臺接入流程

6.1.2共享平臺注冊

第三方應用首先在共享平臺注冊，并通過審核，否則無權接入交換平臺。

6.1.3初始化數(shù)據(jù)

審核通過以后，可以調用初始化接口進行數(shù)據(jù)的初始化。

5

DB4403/TXX—2022

6.1.4激活隊列

初始化的同時調用接口激活生產隊列，激活后只要有變化消息就會被分發(fā)到生產隊列中，否則不會

有消息產生。

6.1.5調試數(shù)據(jù)

以下為調試過程中產生的主要數(shù)據(jù)：

a）激活測試隊列

調用接口激活測試隊列，可以通過接口獲取測試隊列名。

b）觸發(fā)測試消息

調用接口生成測試消息到測試隊列，客戶端即可從相應的測試隊列獲取測試消息進行調試，測試

消息是可以配置的假數(shù)據(jù)，測試過程中可以隨時使用接口清空測試消息，然后重新生成。

c）完成調試

測試完成以后，可以使用接口清除測試隊列，如果需要再次調試，則需重新激活測試隊列。

6.1.6接收生產隊列處理數(shù)據(jù)

完成調試以后，即可連接生產隊列接收正式的生產的消息?？梢酝ㄟ^接口獲取生產隊列名。

6.1.7刪除應用

當應用在共享平臺刪除時，其對應的生產隊列和測試隊列均會被清除，應用無權繼續(xù)接入交換平臺。

6.2接口說明

接口均需連接共享平臺校驗token，客戶端在調用接口之前需先向共享平臺申請token。

接口返回的校驗信息包含錯誤碼和錯誤信息，默認為xml格式。

錯誤碼信息參見附錄B。

6.3消息確認模式

消息確認模式包括同步響應、異步回調和輪詢三種模式。

消息體格式參見附錄C。

6.3.1同步響應模式

接收方收到消息后，通過發(fā)送方發(fā)送消息的消息傳送連接（如HTTP連接）向發(fā)送方發(fā)送對該消息

的確認消息。

6.3.2異步回調模式

接收方收到消息后，建立一個消息傳送連接，并通過該連接向發(fā)送方發(fā)送對該消息的確認消息。

6.3.3輪詢模式

輪詢模式可分為同步輪詢和異步輪詢兩種模式：

a）同步輪詢模式

發(fā)送方在向接收方發(fā)送一定數(shù)目的消息后，對其發(fā)送的所有消息發(fā)送一個確認請求消息給接

收方。接收方接收到這個確認請求后，查詢已經收到的消息，查找其中是否有滿足確認請求

消息中包括的ID值的消息，并在這個確認請求消息所在的連接上，返回查詢的確認結果。

6

DB4403/TXX—2022

b）異步輪詢模式

發(fā)送方在向接收方發(fā)送一定數(shù)目的消息后，對其發(fā)送的所有消息提出一個確認請求消息。接

收方接收到這個確認請求后，輪詢自己已經收到的消息，查找其中是否有滿足確認請求消息

中包括的ID值的消息，新建一個連接，將查詢的結果發(fā)送給發(fā)送方。

7

DB4403/TXX—2022

附錄A

（規(guī)范性）

數(shù)據(jù)庫接入規(guī)范

A.1Mysql數(shù)據(jù)庫接入規(guī)范

Mysql數(shù)據(jù)庫接入規(guī)范見表A.1。

表A.1Mysql數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名mysql數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.2ORACLE數(shù)據(jù)庫接入規(guī)范

ORACLE數(shù)據(jù)庫接入規(guī)范見表A.2。

表A.2ORACLE數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

是否集群如果是集群，提供信息為“是”，不是集群，提供信息為“否”。是

數(shù)據(jù)庫名/SIDoracle數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.3GBase8a數(shù)據(jù)庫接入規(guī)范

GBase8a數(shù)據(jù)庫接入規(guī)范見表A.3。

8

DB4403/TXX—2022

表A.3GBase8a數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

是否集群如果是集群，提供信息為“是”，不是集群，提供信息為“否”。是

數(shù)據(jù)庫名Gbase8a數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.4SQLSERVER數(shù)據(jù)庫接入規(guī)范

SQLSERVER數(shù)據(jù)庫接入規(guī)范見表A.4。

表A.4SQLSERVER數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名sqlserver數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.5LibrA數(shù)據(jù)庫接入規(guī)范

LibrA數(shù)據(jù)庫接入規(guī)范見表A.5。

表A.5LibrA數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

是否集群如果是集群，提供信息為“是”，不是集群，提供信息為“否”。是

數(shù)據(jù)庫名libra數(shù)據(jù)庫名稱是

9

DB4403/TXX—2022

表A.5LibrA數(shù)據(jù)庫接入規(guī)范表（續(xù)）

接入參數(shù)說明是否必填

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.6PostgreSQL數(shù)據(jù)庫接入規(guī)范

PostgreSQL數(shù)據(jù)庫接入規(guī)范見表A.6。

表A.6PostgreSQL數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名postgresql數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.7Dameng數(shù)據(jù)庫接入規(guī)范

Dameng數(shù)據(jù)庫接入規(guī)范見表A.7。

表A.7Dameng數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名Dameng數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.8DB2數(shù)據(jù)庫接入規(guī)范

DB2數(shù)據(jù)庫接入規(guī)范見表A.8。

10

DB4403/TXX—2022

表A.8DB2數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名DB2數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.9GP數(shù)據(jù)庫接入規(guī)范

GP數(shù)據(jù)庫接入規(guī)范見表A.9。

表A.9GP數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

數(shù)據(jù)庫名GP數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

數(shù)據(jù)庫表列表數(shù)據(jù)庫表列表是

數(shù)據(jù)庫表結構數(shù)據(jù)庫表列表是

A.10HDFS數(shù)據(jù)庫接入規(guī)范

HDFS數(shù)據(jù)庫接入規(guī)范見表A.10。

表A.10HDFS數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

NameserviceHDFSNameservice是

Namenode列表HDFS的Namenode列表用逗號隔開是

如果是Kerberos認證，提供信息為“是”，不是Kerberos認證，

開啟Kerberos認證是

提供信息為“否”。

11

DB4403/TXX—2022

A.11Hbase11x數(shù)據(jù)庫接入規(guī)范

Hbase11x數(shù)據(jù)庫接入規(guī)范見表A.11。

表A.11Hbase11x數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

Zk服務的IP：port，如果是集群用逗號隔開（Ip1:port1，

ZK地址是

IP2:port2）

A.12Hive數(shù)據(jù)庫接入規(guī)范

Hive數(shù)據(jù)庫接入規(guī)范見表A.12。

表A.12Hive數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址是

JDBC端口數(shù)據(jù)庫端口是

MetaStore端口MetaStore端口是

數(shù)據(jù)庫名hive數(shù)據(jù)庫名稱是

用戶名數(shù)據(jù)庫賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼數(shù)據(jù)庫密碼是

Zk服務的Ip:port，如果是集群用逗號隔開（Ip1:port1，

ZK地址是

Ip2:port2）

hive命名空間hive命名空間是

配置文件目錄Hive配置文件目錄是

如果需要開啟Kerberos認證，填寫“是”；不需要開啟Kerberos

開啟Kerberos認證是

認證，填寫“否”

A.13Kafka數(shù)據(jù)庫接入規(guī)范

Kafka數(shù)據(jù)庫接入規(guī)范見表A.13。

表A.13Kafka數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

kafka地址kafka的IP和端口，集群用逗號隔開是

12

DB4403/TXX—2022

表A.13Kafka數(shù)據(jù)庫接入規(guī)范表（續(xù)）

接入參數(shù)說明是否必填

如果需要開啟Kerberos認證，填寫“是”；不需要開啟Kerberos

開啟Kerberos認證是

認證，填寫“否”

topickafka的主題名稱是

主題數(shù)據(jù)kafka主題中的數(shù)據(jù)樣例(注釋)是

A.14RocketMQ數(shù)據(jù)庫接入規(guī)范

RocketMQ數(shù)據(jù)庫接入規(guī)范見表A.14。

表A.14RocketMQ數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

nameserverrocketmq的nameserver地址是

topic主題名稱是

主題數(shù)據(jù)主題中的數(shù)據(jù)樣例是

A.15Rabbitmq數(shù)據(jù)庫接入規(guī)范

Rabbitmq數(shù)據(jù)庫接入規(guī)范見表A.15。

表A.15Rabbitmq數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

服務器地址RabbitmqIP地址是

端口Rabbitmq端口是

用戶名Rabbitmq賬號，必須提供有讀取數(shù)據(jù)表權限的賬號是

密碼Rabbitmq密碼是

queue名稱Rabbitmq隊列的名稱是

A.16Activemq數(shù)據(jù)庫接入規(guī)范

Activemq數(shù)據(jù)庫接入規(guī)范見表A.16。

表A.16Activemq數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

集群地址IP地址是

13

DB4403/TXX—2022

表A.16Activemq數(shù)據(jù)庫接入規(guī)范表（續(xù)）

接入參數(shù)說明是否必填

topic主題名稱是

主題數(shù)據(jù)主題中的數(shù)據(jù)樣例是

A.17ES數(shù)據(jù)庫接入規(guī)范

ES數(shù)據(jù)庫接入規(guī)范見表A.17。

表A.17ES數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

ES集群名ES集群名是

URLESIP：端口是

TransportEs傳輸客戶端IP:端口否

versionES的版本號是

索引名稱es索引名稱是

索引typees索引所使用的type是

數(shù)據(jù)結構數(shù)據(jù)結構，帶注釋是

A.18MongoDB數(shù)據(jù)庫接入規(guī)范

MongoDB數(shù)據(jù)庫接入規(guī)范見表A.18。

表A.18MongoDB數(shù)據(jù)庫接入規(guī)范表

接入參數(shù)說明是否必填

數(shù)據(jù)源名稱自定義是

數(shù)據(jù)源描述自定義是

數(shù)據(jù)庫IP數(shù)據(jù)庫IP地址