公共數(shù)據(jù)平臺(tái)數(shù)據(jù)歸集規(guī)范

DB3209/T1258-2023

公共數(shù)據(jù)平臺(tái)數(shù)據(jù)歸集規(guī)范

1范圍

本文件界定了公共數(shù)據(jù)平臺(tái)數(shù)據(jù)歸集的術(shù)語(yǔ)和定義，規(guī)定了歸集流程、數(shù)據(jù)歸集要求、數(shù)據(jù)更新要

求及數(shù)據(jù)歸集安全。

本文件適用于指導(dǎo)鹽城市各級(jí)公共管理和服務(wù)機(jī)構(gòu)歸集數(shù)據(jù)至鹽城市公共數(shù)據(jù)平臺(tái)。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求

GB/T35273信息安全技術(shù)個(gè)人信息安全規(guī)范

GB/T35295信息技術(shù)大數(shù)據(jù)術(shù)語(yǔ)

GB/T37973信息安全技術(shù)大數(shù)據(jù)安全管理指南

3術(shù)語(yǔ)和定義

GB/T35295-2017界定的以及下列術(shù)語(yǔ)和定義適用于本文件。

3.1

數(shù)據(jù)歸集dataingestion

指將來(lái)源于不同數(shù)據(jù)源的數(shù)據(jù)按照一定的規(guī)則進(jìn)行采集、清洗加工、整合和更新，以支持公共數(shù)據(jù)

平臺(tái)的數(shù)據(jù)分析和應(yīng)用。

3.2

公共數(shù)據(jù)commondata

指各級(jí)行政機(jī)關(guān)、法律法規(guī)授權(quán)的具有管理公共事務(wù)職能的組織、公共企事業(yè)單位為履行法定職責(zé)，

提供公共服務(wù)收集、產(chǎn)生的各類數(shù)據(jù)資源，包括文件、資料、圖表、圖像、音頻、視頻、電子證照、電

子檔案等。

3.3

結(jié)構(gòu)化數(shù)據(jù)structureddata

一種數(shù)據(jù)表示形式，按此種形式，由數(shù)據(jù)元素匯集而成的每個(gè)記錄的結(jié)構(gòu)都是一致的并且可以使用

關(guān)系模型予以有效描述。

[來(lái)源:GB/T35295-2017,2.2.13]

3.4

結(jié)構(gòu)化文件structuredfile

按照特定結(jié)構(gòu)或格式組織的文件，并便于機(jī)器解析和讀取。結(jié)構(gòu)化文件通常用于存儲(chǔ)和組織大量的

數(shù)據(jù)，如數(shù)據(jù)庫(kù)文件、CSV文件、JSON文件等。

-1-

DB3209/T1258-2023

3.5

非結(jié)構(gòu)化文件unstructuredfile

不具有預(yù)定義模型或未以預(yù)定義方式組織的文件，通常以二進(jìn)制格式或自由文本形式存儲(chǔ)，沒有固

定的結(jié)構(gòu)和格式，如辦公文檔、圖片、HTML、各類報(bào)表、圖像和音頻/視頻等。

4歸集流程

4.1明確歸集范圍

按照“按需歸集、應(yīng)歸盡歸”的原則，將相關(guān)部門及機(jī)構(gòu)所有可歸集的公共數(shù)據(jù)持續(xù)歸集至公共數(shù)

據(jù)平臺(tái)。

4.2明確歸集方式

結(jié)合歸集數(shù)據(jù)的范圍、數(shù)據(jù)傳輸要求等，確定數(shù)據(jù)的歸集方式。歸集方式主要包括庫(kù)表、文件、服

務(wù)接口三種，其中庫(kù)表、文件方式適用于對(duì)數(shù)據(jù)傳輸速度和實(shí)時(shí)性無(wú)特殊要求的情況，服務(wù)接口方式適

用于對(duì)數(shù)據(jù)傳輸速度和實(shí)時(shí)性有較高要求的情況。

4.3開展數(shù)據(jù)歸集

應(yīng)將數(shù)據(jù)庫(kù)表結(jié)構(gòu)發(fā)送至公共數(shù)據(jù)主管部門，并根據(jù)數(shù)據(jù)歸集方式和數(shù)據(jù)實(shí)際情況，做好數(shù)據(jù)歸集

前準(zhǔn)備工作并開展數(shù)據(jù)歸集:

a)將原始數(shù)據(jù)不進(jìn)行處理地采集存放在公共數(shù)據(jù)平臺(tái)的貼源層中；

b)對(duì)貼源層中的數(shù)據(jù)進(jìn)行清洗加工使其滿足公共數(shù)據(jù)平臺(tái)使用的質(zhì)量要求，清洗加

工后的數(shù)據(jù)存放在公共數(shù)據(jù)平臺(tái)的公共層中；

c)對(duì)公共層中的數(shù)據(jù)進(jìn)行個(gè)性化面向應(yīng)用、業(yè)務(wù)的整合，最終數(shù)據(jù)存放在公共數(shù)據(jù)

平臺(tái)的主題層。

4.4歸集結(jié)果確認(rèn)

數(shù)據(jù)歸集結(jié)果確認(rèn)應(yīng)包含：

a)數(shù)據(jù)清洗加工：對(duì)采集到的數(shù)據(jù)進(jìn)行清洗加工，去除無(wú)效和冗余數(shù)據(jù)，對(duì)缺失數(shù)據(jù)進(jìn)行填補(bǔ)，

確保數(shù)據(jù)的準(zhǔn)確性和完整性；

b)數(shù)據(jù)整合：將清洗加工后的數(shù)據(jù)進(jìn)行整合，將不同來(lái)源的數(shù)據(jù)進(jìn)行融合和映射，形成統(tǒng)一的數(shù)

據(jù)格式和標(biāo)準(zhǔn)；

c)數(shù)據(jù)更新：定期對(duì)數(shù)據(jù)進(jìn)行更新，通過數(shù)據(jù)采集、清洗加工、整合等環(huán)節(jié)，保障數(shù)據(jù)的實(shí)時(shí)性

和準(zhǔn)確性。

5數(shù)據(jù)歸集要求

5.1總體要求

在數(shù)據(jù)歸集過程中，明確數(shù)據(jù)的歸集要求，從數(shù)據(jù)完整性、及時(shí)性、安全性等方面確保數(shù)據(jù)歸集的

質(zhì)量和高效。

a)數(shù)據(jù)完整性：確保所歸集的數(shù)據(jù)準(zhǔn)確、完整且沒有重復(fù)。在數(shù)據(jù)歸集過程中，需要對(duì)數(shù)據(jù)源進(jìn)

行充分的調(diào)研和驗(yàn)證，確保數(shù)據(jù)被完整地收集并沒有遺漏，同時(shí)，需要進(jìn)行數(shù)據(jù)清洗和數(shù)據(jù)校

驗(yàn)，排除無(wú)效數(shù)據(jù)和錯(cuò)誤數(shù)據(jù)，保持?jǐn)?shù)據(jù)的準(zhǔn)確性和一致性；

-2-

DB3209/T1258-2023

b)數(shù)據(jù)安全性：采取相關(guān)安全防護(hù)措施，確保歸集的數(shù)據(jù)不會(huì)受到未經(jīng)授權(quán)的訪問、篡改或泄露

的風(fēng)險(xiǎn)。采用嚴(yán)格的身份認(rèn)證、權(quán)限控制和脫敏加密技術(shù)，保障數(shù)據(jù)的安全；

c)數(shù)據(jù)及時(shí)性：建立高效的數(shù)據(jù)歸集機(jī)制，需定期檢查數(shù)據(jù)源的更新頻率，設(shè)置合理的數(shù)據(jù)歸集

周期，確保數(shù)據(jù)能夠及時(shí)歸集和更新，確保歸集的數(shù)據(jù)始終具備實(shí)時(shí)性和可信度，滿足各級(jí)部

門和公眾對(duì)數(shù)據(jù)的需求。

5.2庫(kù)表歸集

5.2.1前置庫(kù)

在前置機(jī)中建設(shè)前置庫(kù)，用于臨時(shí)存儲(chǔ)業(yè)務(wù)數(shù)據(jù)表、對(duì)賬數(shù)據(jù)表等，可根據(jù)業(yè)務(wù)需要?jiǎng)?chuàng)建多個(gè)前置

庫(kù)。前置庫(kù)應(yīng)支持國(guó)產(chǎn)數(shù)據(jù)庫(kù)，字符編碼應(yīng)支持包括但不限于：UTF-8、GB2312、UTF-16。

5.2.2業(yè)務(wù)數(shù)據(jù)表

業(yè)務(wù)數(shù)據(jù)表存儲(chǔ)待歸集的業(yè)務(wù)數(shù)據(jù)，包含記錄ID、批次號(hào)、業(yè)務(wù)操作標(biāo)識(shí)、更新時(shí)間及業(yè)務(wù)

字段，字段說明如下：

a)記錄ID：業(yè)務(wù)數(shù)據(jù)的唯一記錄標(biāo)識(shí)，使用UUID主鍵策略；

b)批次號(hào)：業(yè)務(wù)數(shù)據(jù)按批次更新時(shí)生成，是數(shù)據(jù)日期和數(shù)據(jù)序號(hào)的組合，應(yīng)保證唯一性。其中數(shù)

據(jù)日期指數(shù)據(jù)更新的日期，格式為YYYYMMDD：數(shù)據(jù)序號(hào)為8位數(shù)字，每日從00000001順

序遞增；

c)業(yè)務(wù)操作標(biāo)識(shí)：用于標(biāo)識(shí)業(yè)務(wù)數(shù)據(jù)的操作屬性，數(shù)據(jù)新增為“I”，數(shù)據(jù)修改為“U”，數(shù)據(jù)刪

除為“D”；

d)更新時(shí)間：業(yè)務(wù)數(shù)據(jù)寫入業(yè)務(wù)數(shù)據(jù)表的時(shí)間，格式為YYYY-MM-DDhh:mm:ss。

示例：2023-10-0108:10:56。

業(yè)務(wù)數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表A.1。

5.2.3對(duì)賬數(shù)據(jù)表

對(duì)賬數(shù)據(jù)表存儲(chǔ)數(shù)據(jù)的對(duì)賬情況，包含對(duì)賬記錄唯一標(biāo)識(shí)、表名、批次號(hào)、批次條數(shù)、批次

時(shí)間、批次狀態(tài)字段，字段說明如下：

a)對(duì)賬記錄唯一標(biāo)識(shí)：對(duì)賬表主鍵，使用UUID主鍵策略；

b)表名：該批次更新數(shù)據(jù)所在業(yè)務(wù)數(shù)據(jù)表的名稱；

c)批次號(hào)：與業(yè)務(wù)數(shù)據(jù)表中批次號(hào)一致；

d)批次條數(shù)：該批次更新的數(shù)據(jù)條數(shù)，應(yīng)與業(yè)務(wù)數(shù)據(jù)表中該批次數(shù)據(jù)實(shí)際更新條數(shù)一致；

e)批次時(shí)間：對(duì)賬數(shù)據(jù)寫入對(duì)賬表的時(shí)間，采用數(shù)據(jù)庫(kù)時(shí)間函數(shù)的值，格式為YYYY-MM-DD

hh:mm:ss；

示例：2023-10-0108:10:56。

f)批次狀態(tài)：本批次數(shù)據(jù)歸集狀態(tài)，0為初始默認(rèn)值，1為完成歸集，-1為對(duì)賬數(shù)據(jù)表批次數(shù)量

與業(yè)務(wù)數(shù)據(jù)表實(shí)際數(shù)量不一致。

對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表C.1。

5.3文件歸集

-3-

DB3209/T1258-2023

5.3.1文件系統(tǒng)

在前置機(jī)中建設(shè)文件系統(tǒng)，用于臨時(shí)存儲(chǔ)待歸集的文件。文件系統(tǒng)可采用FTP、SFTP等。

5.3.2文件要求

命名約束

文件夾的命名格式為：/目錄名稱/業(yè)務(wù)名稱/年/月/日/。文件夾、文件的命名應(yīng)由阿拉伯?dāng)?shù)字（0~9）、

英文字符（a~z、A~Z）、下劃線“_”組成。

示例：文件夾命名：/公司資料/銷售數(shù)據(jù)/2023/12/05/，文件命名：daily_sales_report_20231205.xlsx。

文件大小

需設(shè)置文件大小閾值，文件超出閾值應(yīng)拆分成多個(gè)小文件。

文件類型

文件類型包括結(jié)構(gòu)化文件和非結(jié)構(gòu)化文件，結(jié)構(gòu)化文件格式包括CSV、TXT、XLS、XLSX等，非結(jié)構(gòu)

化文件格式包括PDF、DOC、DOCX、WPS、ZIP以及圖片、音頻、視頻等資源的常用格式。CSV、XLS、XLSX

的首行數(shù)據(jù)應(yīng)為列名，字符編碼應(yīng)支持包括但不限于：UTF-8、UTF-16、GBK，且不應(yīng)存在特殊字符，不

應(yīng)存在行或列的合并，不應(yīng)存在相同列名，不應(yīng)有空白行等。

5.3.3文件信息表

文件信息表用來(lái)存儲(chǔ)待歸集的文件信息，包含記錄ID、批次號(hào)、文件名、文件路徑、文件大

小、文件格式、業(yè)務(wù)操作標(biāo)識(shí)、文件完整性校驗(yàn)、文件拆分標(biāo)志、拆分?jǐn)?shù)量、更新時(shí)間，字段說明如下：

a)記錄ID：業(yè)務(wù)數(shù)據(jù)主鍵，是業(yè)務(wù)數(shù)據(jù)的唯一記錄標(biāo)識(shí)，使用UUID主鍵策略；

b)批次號(hào)：業(yè)務(wù)數(shù)據(jù)按批次更新時(shí)生成，是數(shù)據(jù)日期和數(shù)據(jù)序號(hào)的組合，應(yīng)保證唯一性。其中數(shù)

據(jù)日期指數(shù)據(jù)更新的日期，格式為YYYYMMDD，數(shù)據(jù)序號(hào)為8位數(shù)字，每日從00000001順

序遞增；

示例：2023100100000001，表示2023年10月1日第1批次數(shù)據(jù)。

c)文件名：該文件的存儲(chǔ)名稱；

d)文件路徑：該文件的存儲(chǔ)路徑；

e)文件大?。涸撐募加玫拇鎯?chǔ)空間，單位為KB；

f)文件格式：文件的格式；

g)業(yè)務(wù)操作標(biāo)識(shí)：用于標(biāo)識(shí)業(yè)務(wù)數(shù)據(jù)的操作屬性，數(shù)據(jù)新增為“I”，數(shù)據(jù)修改為“U”，數(shù)據(jù)刪

除為“D”；

h)文件完整性校驗(yàn)：該文件對(duì)賬使用的完整性校驗(yàn)碼；

i)文件拆分標(biāo)識(shí)：用于標(biāo)識(shí)該文件是否進(jìn)行了拆分，1為已拆分，0為未拆分；

j)拆分?jǐn)?shù)量：該文件被拆分的數(shù)量；

k)更新時(shí)間：業(yè)務(wù)數(shù)據(jù)寫入業(yè)務(wù)數(shù)據(jù)表的時(shí)間，格式為YYYY-MM-DDhh:mm:ss。

示例：2023-10-0108:10:56。

文件信息表字段名稱和數(shù)據(jù)格式見表B.1。

5.3.4文件拆分信息表

-4-

DB3209/T1258-2023

文件拆分信息表用來(lái)存儲(chǔ)文件拆分信息，包含記錄ID、文件信息表記錄ID、文件名、文件路

徑、文件大小、文件完整性校驗(yàn)、更新時(shí)間，字段描述如下：

a)記錄ID：業(yè)務(wù)數(shù)據(jù)的唯一記錄標(biāo)識(shí)，使用UUID主鍵策略；

b)文件信息表記錄ID：拆分文件對(duì)應(yīng)文件信息表的記錄ID；

c)文件名：拆分文件的存儲(chǔ)名稱；

d)文件路徑：拆分文件的存儲(chǔ)路徑；

e)文件大?。翰鸱治募加玫拇鎯?chǔ)空間，單位為KB；

f)文件完整性校驗(yàn)：該文件對(duì)賬使用的完整性校驗(yàn)碼；

g)更新時(shí)間：業(yè)務(wù)數(shù)據(jù)寫入業(yè)務(wù)數(shù)據(jù)表的時(shí)間，格式為YYYY-MM-DDhh:mm:ss。

示例：2023-10-0108:10:56。

文件拆分信息表字段名稱和數(shù)據(jù)格式見表B.1。

5.3.5對(duì)賬數(shù)據(jù)表

文件的對(duì)賬數(shù)據(jù)表包括對(duì)賬記錄唯一標(biāo)識(shí)、文件路徑、文件類型、批次號(hào)、批次時(shí)間、批次

狀態(tài)，其中結(jié)構(gòu)化文件對(duì)賬數(shù)據(jù)表還應(yīng)包括批次條數(shù)等字段，文件類型字段以“SD”標(biāo)識(shí)，非結(jié)構(gòu)化文

件對(duì)賬數(shù)據(jù)表還應(yīng)包括批次個(gè)數(shù)、批次大小等字段，文件類型以“UD”標(biāo)識(shí)，字段描述如下：

a)對(duì)賬記錄唯一標(biāo)識(shí)：對(duì)賬表主鍵，使用UUID主鍵策略；

b)文件路徑：拆分文件的存儲(chǔ)路徑；

c)文件類型：區(qū)分結(jié)構(gòu)化文件、非結(jié)構(gòu)化文件；

d)批次號(hào)：與文件信息表中批次號(hào)一致；

e)批次時(shí)間：對(duì)賬數(shù)據(jù)寫入對(duì)賬表的時(shí)間，采用數(shù)據(jù)庫(kù)時(shí)間函數(shù)的值，格式為YYYY-MM-DD

hh:mm:ss;

示例：2023-10-0108:10:56。

f)批次條數(shù)：該批次更新的數(shù)據(jù)條數(shù)，應(yīng)與該批次結(jié)構(gòu)化文件中數(shù)據(jù)實(shí)際更新條數(shù)一致；

g)批次個(gè)數(shù)：該批次的文件的個(gè)數(shù)，應(yīng)與該批次非結(jié)構(gòu)化文件的實(shí)際個(gè)數(shù)相符；

h)批次大?。涸撆蔚奈募加玫拇鎯?chǔ)空間，應(yīng)與該批次文件實(shí)際大小相符，單位為KB；

i)批次狀態(tài)：本批次數(shù)據(jù)歸集狀態(tài)，0為初始默認(rèn)值，1為完成歸集，-1為對(duì)賬表批次條數(shù)或文

件個(gè)數(shù)與實(shí)際不一致。

文件對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表C.2。

5.4接口歸集

5.4.1基本要求

公共數(shù)據(jù)主管部門根據(jù)提供的庫(kù)表結(jié)構(gòu)開發(fā)服務(wù)接口，掛載到相關(guān)公共數(shù)據(jù)資源目錄下，通過公共

數(shù)據(jù)平臺(tái)發(fā)布。各機(jī)構(gòu)依據(jù)服務(wù)接口要求，開發(fā)服務(wù)接口調(diào)用程序，調(diào)用服務(wù)接口推送本機(jī)構(gòu)數(shù)據(jù)至公

共數(shù)據(jù)平臺(tái)，可采用壓縮、加密等技術(shù)實(shí)現(xiàn)數(shù)據(jù)高速傳輸、保障數(shù)據(jù)推送和調(diào)用的安全。

5.4.2服務(wù)接口調(diào)用形式

服務(wù)接口調(diào)用形式為：<protocol>://<hostname>:<port>/<URI>，其中：

a)protocol支持HTTPS、HTTP；

-5-

DB3209/T1258-2023

b)hostname指IP設(shè)備的IP地址；

c)port指端口號(hào)；

d)URI指資源URI，由接口唯一標(biāo)識(shí)、數(shù)據(jù)傳輸流水序列號(hào)、分布式存儲(chǔ)標(biāo)識(shí)、資源唯一標(biāo)識(shí)

符組成。

5.4.3服務(wù)接口資源描述

服務(wù)接口資源采用RESTful的數(shù)據(jù)標(biāo)準(zhǔn)協(xié)議格式，其中編碼方式為UTF-8，每個(gè)接口資源的資源標(biāo)

識(shí)唯一，接口返回的消息體要包含接口的自描述信息、消息的自描述信息。接口的返回?cái)?shù)據(jù)格式示例見

附錄D.1。

5.4.4服務(wù)接口功能

服務(wù)接口主要分為增刪改類數(shù)據(jù)服務(wù)接口和只增類數(shù)據(jù)服務(wù)接口，增刪改類數(shù)據(jù)服務(wù)接口的功能包

含增加信息、增加壓縮信息、刪除信息、刪除壓縮信息、修改信息、修改壓縮信息，只增類數(shù)據(jù)服務(wù)接

口的功能包含只增信息、只增壓縮信息。服務(wù)接口內(nèi)容描述見附錄D表D.1～表D.4。

6數(shù)據(jù)更新要求

6.1數(shù)據(jù)更新方法

對(duì)存在更新標(biāo)識(shí)的數(shù)據(jù)應(yīng)支持增量更新；對(duì)不存在更新標(biāo)識(shí)的數(shù)據(jù)應(yīng)支持全量更新。

6.2數(shù)據(jù)更新策略

確定數(shù)據(jù)更新的策略和周期，實(shí)時(shí)性和頻率需根據(jù)實(shí)際需求確定。根據(jù)公共數(shù)據(jù)平臺(tái)的使用情況和

業(yè)務(wù)需求，制定數(shù)據(jù)更新的頻率，可以是實(shí)時(shí)更新、每日更新、每周更新等。此外，也要考慮相關(guān)數(shù)據(jù)

源的更新頻率和數(shù)據(jù)變動(dòng)性，確保及時(shí)獲取最新數(shù)據(jù)。

7數(shù)據(jù)歸集安全

數(shù)據(jù)歸集安全應(yīng)符合GB/T22239中等級(jí)保護(hù)三級(jí)的要求，個(gè)人信息安全應(yīng)符合GB/T35273的要求，

其他安全要求應(yīng)符合GB/T37973的要求。歸集功能應(yīng)滿足數(shù)據(jù)源鑒別安全技術(shù)要求，數(shù)據(jù)提供方在歸

集數(shù)據(jù)過程中應(yīng)采用身份鑒別、數(shù)據(jù)源認(rèn)證等安全機(jī)制保障公共數(shù)據(jù)來(lái)源的真實(shí)性。

-6-

DB3209/T1258-2023

附錄A

（資料性）

庫(kù)表歸集業(yè)務(wù)數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

業(yè)務(wù)數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表A.1。

表A.1業(yè)務(wù)數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

字段名稱字段標(biāo)識(shí)符字段類型字段長(zhǎng)度主鍵標(biāo)識(shí)非空

記錄IDVARCHAR64主鍵是

ID

批次號(hào)VARCHAR20--是

BATCH

業(yè)務(wù)操作標(biāo)識(shí)VARCHAR1--是

OPERATION

更新時(shí)間DATETIME8--是

TIME

-7-

DB3209/T1258-2023

附錄B

（資料性）

文件歸集信息表字段名稱和數(shù)據(jù)格式

文件信息表、文件拆分信息表字段名稱和數(shù)據(jù)格式見表B.1。

表B.1文件信息表、文件拆分信息表字段名稱和數(shù)據(jù)格式

字段名稱字段標(biāo)識(shí)符字段類型字段長(zhǎng)度主鍵標(biāo)識(shí)非空

記錄IDVARCHAR64主鍵是

UD_ID

批次號(hào)VARCHAR20--是

UD_BATCH

文件名VARCHAR64--是

UD_FILE_NAME

文件路徑VARCHAR250--是

UD_FILE_PATH

文件大小LONG----是

UD_FILE_SIZE

文件格式VARCHAR64--是

UD_FILE_TYPE

文件中文名VARCHAR64--是

UD_FILE_CNAME

文件完整性校驗(yàn)VARCHAR128--是

UD_FILE_CHECK

業(yè)務(wù)操作標(biāo)識(shí)VARCHAR1--是

UD_OPERATION

文件拆分標(biāo)識(shí)INT1--是

UD_IS_SPLIT_FILE

拆分?jǐn)?shù)量INT----是

UD_SPLIT_COUNT

更新時(shí)間DATETIME8--是

UD_TIME

文件信息表記錄IDVARCHAR64--是

UD_FILE_INFO_ID

-8-

DB3209/TXXX-2023

附錄C

（資料性）

對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

C.1庫(kù)表歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

庫(kù)表歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表C.1。

表C.1庫(kù)表歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

字段名稱字段標(biāo)識(shí)符字段類型字段長(zhǎng)度主鍵標(biāo)識(shí)非空

對(duì)賬記錄唯一標(biāo)識(shí)IDVARCHAR64主鍵是

表名TABLE_NAMEVARCHAR100--是

批次號(hào)DATA_BATCHVARCHAR20--是

批次條數(shù)DATA_COUNTINT----是

批次時(shí)間DATA_DATEDATETIME8--是

批次狀態(tài)DATA_STATEVARCHAR1--是

C.2文件歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

文件歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式見表C.2。

表C.2文件歸集對(duì)賬數(shù)據(jù)表字段名稱和數(shù)據(jù)格式

字段名稱字段標(biāo)識(shí)符字段類型字段長(zhǎng)度主鍵標(biāo)識(shí)非空

對(duì)賬記錄唯一標(biāo)識(shí)IDVARCHAR64主鍵是

文件路徑FILE_PATHVARCHAR250--是

文件類型UD_SDVARCHAR2--是

批次號(hào)FILE_BATCHVARCHAR20--是

批次個(gè)數(shù)FILE_COUNTINT----是

批次大小FILE_SIZELONG

批次時(shí)間FILE_DATEDATETIME8--是

批次狀態(tài)FILE_STATEVARCHAR1--是

1

DB3209/TXXX-2023

附錄D

（資料性）

服務(wù)接口數(shù)據(jù)示例及內(nèi)容描述

D.1json格式消息體示例

以test內(nèi)容傳輸格式為例，定義數(shù)據(jù)模板，數(shù)據(jù)模板標(biāo)識(shí)為test，json消息體數(shù)據(jù)示例為：

200OK

Content-Type：application/json

Content-Length：xxx

{

“url”:"<serialnumber>/<dstributedStorageIdentifier>/<resouceIdentifier>"

“ineterfaceIdentifier”：“addoObjects”,

“l(fā)abel”:"test信息新增接口",

“items_url”:“<serialnumber>/<distributedStorageIdentifier>/<resouceIdentifier>”,

“status”:“success”,

“data”:[

{

“id”：“XXX”,

“name”：“XXX”,

……

}，

{

“id”：“XXX”,

“name”：“XXX”,

……

}

……

]

}

2

DB3209/TXXX-2023

D.2增加服務(wù)信息接口描述

增加信息服務(wù)接口信息描述見表D.1。

表D.1增加服務(wù)信息接口描述

名稱內(nèi)容備注

https://<hostname>:<port>ineterfaceIdentif

接口

<ineterfaceIdentifier>/<serialnumber>/<distributedStorageIdentifier>/<resouceier為addObjects

地址

Identifier>或addObjects_GZIP

功能批量增加信息

方法post

ineterfaceIdentifier=addobjects時(shí)消息體為application/json，字符集編碼為UTF-8

消息的標(biāo)準(zhǔn)json格式數(shù)據(jù)；

體ineterfaceIdentifier=addObjects_GZIP時(shí)數(shù)據(jù)格式為application/json，字符集編碼

為UTF-8的壓縮json格式數(shù)據(jù)；

200OK{status}=0，數(shù)據(jù)格

Content-Type:application/json式正確，{err}為空

Content-Length：xxx{status}不為0，數(shù)

返回

{據(jù)格式錯(cuò)誤，{err}

結(jié)果

“status”:“{status}”,為錯(cuò)誤描述

“err”:“{err}”

}

注釋----需主鍵信息

D.3刪除服務(wù)信息接口描述

刪除信息服務(wù)接口信息描述見表D.2。

表D.2刪除服務(wù)信息接口描述

名稱內(nèi)容備注

接口https://<hostname>:<port>ineterfaceIdentifier為

<ineterfaceIdentifier>/<serialnumber>/<distributedStorageIdentifier>/<resouceIdentifier>deleteObjects或

地址

deleteObjects_GZIP

功能批量刪除信息

方法post

ineterfaceIdentifier=deleteObjects時(shí)消息體為application/json，字符集編碼為UTF-8的

標(biāo)準(zhǔn)json格式數(shù)據(jù)；

消息

ineterfaceIdentifier=deleteObjects_GZIP時(shí)數(shù)據(jù)格式為application/json，字符集編碼為

體UTF-8的壓縮json格式數(shù)據(jù)；

200OK{status}=0，數(shù)據(jù)格式正

Content-Type：application/json確，{err}為空{(diào)status}不

返回Content-Length：xxx為0，數(shù)據(jù)格式錯(cuò)誤，

{{err}為錯(cuò)誤描述

結(jié)果

“status”:“{status}”,

“err”:“{err}”

}

注釋----需主鍵信息

3

DB3209/TXXX-2023

D.4修改服務(wù)信息接口描述

修改信息服務(wù)接口信息描述見表D.3。

表D.3修改服務(wù)信息接口描述

名稱內(nèi)容備注

接口https://<hostname>:<port>ineterfaceIdentifier為

<ineterfaceIdentifier>/<serialnumber>/<distributedStorageIdentifier>/<resouceIdentifier>updateObjects或

地址

updateObjects_GZIP

功能批量修改信息

方法post

ineterfaceIdentifier=updateObjects時(shí)消息體為application/json，字符集編碼為UTF-8的

消息標(biāo)準(zhǔn)json格式數(shù)據(jù)；

ineterfaceIdentifier=updateObjects_GZIP時(shí)數(shù)據(jù)格式為application/json，字符集編碼為

體

UTF-8的壓縮json格式數(shù)據(jù)；

200OK{status}=0，數(shù)據(jù)格式正

Content-Type：application/json確，{err}為空{(diào)status}

返回Content-Length：xxx不為0，數(shù)據(jù)格式錯(cuò)誤，

{{err}為錯(cuò)誤描述

結(jié)果

“status”：“{status}”,

“err”：“{err}”

}

注釋----需主鍵信息

D.5只增服務(wù)信息接口描述

只增信息服務(wù)接口信息描述見表D.4。

表D.4只增服務(wù)信息接口描述

名稱內(nèi)容備注

https://<hostname>:<port>ineterfaceIdentifier為

接口地址<ineterfaceIdentifier>/<serialnumber>/<distributedStorageIdentifier>/<resouceIdentifieraddEventInfos或

>addEventInfos_GZIP

功能批量歸集只增信息

方法post

ineterfaceIdentifier=addEventInfos時(shí)消息體為application/json，字符集編碼為UTF-8

的標(biāo)準(zhǔn)json格式數(shù)據(jù);

消息體ineterfaceIdentifier=addEventInfos_GZIP時(shí)數(shù)據(jù)格式為application/json，字符集編碼

為UTF-8的壓縮json格式數(shù)據(jù)；

200OK{status}=0，數(shù)據(jù)格式正

Content-Type:application/json確，{err}為空{(diào)status}

Content-Length:xxx不為0，數(shù)據(jù)格式錯(cuò)誤，

返回結(jié)果{{err}為錯(cuò)誤描述

“status”:“{status}”,

“err”:“{err}”

}

注釋----無(wú)

4

ICS35.020

CCSL70

DB3209

鹽城市地方標(biāo)準(zhǔn)

DB3209/T1258—2023

公共數(shù)據(jù)平臺(tái)數(shù)據(jù)歸集規(guī)范