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

DB3209/T1258-2023

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

1范圍

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

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

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

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

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

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

文件。

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

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

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

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

3術(shù)語和定義

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

3.1

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

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

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

3.2

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

指各級行政機關(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ù)元素匯集而成的每個記錄的結(jié)構(gòu)都是一致的并且可以使用

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

[來源:GB/T35295-2017,2.2.13]

3.4

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

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

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

-1-

DB3209/T1258-2023

3.5

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

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

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

4歸集流程

4.1明確歸集范圍

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

據(jù)平臺。

4.2明確歸集方式

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

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

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

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

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

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

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

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

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

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

平臺的主題層。

4.4歸集結(jié)果確認

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

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

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

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

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

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

和準(zhǔn)確性。

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

5.1總體要求

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

質(zhì)量和高效。

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

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

驗，排除無效數(shù)據(jù)和錯誤數(shù)據(jù)，保持數(shù)據(jù)的準(zhǔn)確性和一致性；

-2-

DB3209/T1258-2023

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

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

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

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

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

5.2庫表歸集

5.2.1前置庫

在前置機中建設(shè)前置庫，用于臨時存儲業(yè)務(wù)數(shù)據(jù)表、對賬數(shù)據(jù)表等，可根據(jù)業(yè)務(wù)需要創(chuàng)建多個前置

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

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

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

字段，字段說明如下：

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

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

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

序遞增；

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

除為“D”；

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

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

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

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

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

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

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

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

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

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

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

hh:mm:ss；

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

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

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

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

5.3文件歸集

-3-

DB3209/T1258-2023

5.3.1文件系統(tǒng)

在前置機中建設(shè)文件系統(tǒng)，用于臨時存儲待歸集的文件。文件系統(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)拆分成多個小文件。

文件類型

文件類型包括結(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文件信息表

文件信息表用來存儲待歸集的文件信息，包含記錄ID、批次號、文件名、文件路徑、文件大

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

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

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

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

序遞增；

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

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

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

e)文件大?。涸撐募加玫拇鎯臻g，單位為KB；

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

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

除為“D”；

h)文件完整性校驗：該文件對賬使用的完整性校驗碼；

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

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

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

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

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

5.3.4文件拆分信息表

-4-

DB3209/T1258-2023

文件拆分信息表用來存儲文件拆分信息，包含記錄ID、文件信息表記錄ID、文件名、文件路

徑、文件大小、文件完整性校驗、更新時間，字段描述如下：

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

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

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

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

e)文件大小：拆分文件占用的存儲空間，單位為KB；

f)文件完整性校驗：該文件對賬使用的完整性校驗碼；

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

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

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

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

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

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

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

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

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

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

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

e)批次時間：對賬數(shù)據(jù)寫入對賬表的時間，采用數(shù)據(jù)庫時間函數(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ù)一致；

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

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

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

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

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

5.4接口歸集

5.4.1基本要求

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

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

共數(shù)據(jù)平臺，可采用壓縮、加密等技術(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指端口號；

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

符組成。

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

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

識唯一，接口返回的消息體要包含接口的自描述信息、消息的自描述信息。接口的返回數(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ù)更新方法

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

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

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

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

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

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

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

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

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

-6-

DB3209/T1258-2023

附錄A

（資料性）

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

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

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

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

記錄IDVARCHAR64主鍵是

ID

批次號VARCHAR20--是

BATCH

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

OPERATION

更新時間DATETIME8--是

TIME

-7-

DB3209/T1258-2023

附錄B

（資料性）

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

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

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

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

記錄IDVARCHAR64主鍵是

UD_ID

批次號VARCHAR20--是

UD_BATCH

文件名VARCHAR64--是

UD_FILE_NAME

文件路徑VARCHAR250--是

UD_FILE_PATH

文件大小LONG----是

UD_FILE_SIZE

文件格式VARCHAR64--是

UD_FILE_TYPE

文件中文名VARCHAR64--是

UD_FILE_CNAME

文件完整性校驗VARCHAR128--是

UD_FILE_CHECK

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

UD_OPERATION

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

UD_IS_SPLIT_FILE

拆分數(shù)量INT----是

UD_SPLIT_COUNT

更新時間DATETIME8--是

UD_TIME

文件信息表記錄IDVARCHAR64--是

UD_FILE_INFO_ID

-8-

DB3209/TXXX-2023

附錄C

（資料性）

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

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

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

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

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

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

表名TABLE_NAMEVARCHAR100--是

批次號DATA_BATCHVARCHAR20--是

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

批次時間DATA_DATEDATETIME8--是

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

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

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

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

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

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

文件路徑FILE_PATHVARCHAR250--是

文件類型UD_SDVARCHAR2--是

批次號FILE_BATCHVARCHAR20--是

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

批次大小FILE_SIZELONG

批次時間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)識為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時消息體為application/json，字符集編碼為UTF-8

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

體ineterfaceIdentifier=addObjects_GZIP時數(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ù)格式錯誤，{err}

結(jié)果

“status”:“{status}”,為錯誤描述

“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時消息體為application/json，字符集編碼為UTF-8的

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

消息

ineterfaceIdentifier=deleteObjects_GZIP時數(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ù)格式錯誤，

{{err}為錯誤描述

結(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時消息體為application/json，字符集編碼為UTF-8的

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

ineterfaceIdentifier=updateObjects_GZIP時數(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ù)格式錯誤，

{{err}為錯誤描述

結(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時消息體為application/json，字符集編碼為UTF-8

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

消息體ineterfaceIdentifier=addEventInfos_GZIP時數(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ù)格式錯誤，

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

“status”:“{status}”,

“err”:“{err}”

}

注釋----無

4

ICS35.020

CCSL70

DB3209

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

DB3209/T1258—2023

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