GB/T 34949-2017實(shí)時數(shù)據(jù)庫C語言接口規(guī)范

ICS3524050

L67..

中華人民共和國國家標(biāo)準(zhǔn)

GB/T34949—2017

實(shí)時數(shù)據(jù)庫C語言接口規(guī)范

Cprogramminglanguageinterfacespecificationofreal-timedatabase

2017-11-01發(fā)布2018-05-01實(shí)施

中華人民共和國國家質(zhì)量監(jiān)督檢驗(yàn)檢疫總局發(fā)布

中國國家標(biāo)準(zhǔn)化管理委員會

GB/T34949—2017

目次

前言

…………………………Ⅲ

范圍

1………………………1

規(guī)范性引用文件

2…………………………1

術(shù)語和定義

3………………1

縮略語

4……………………1

概述

5………………………2

接口描述約定

6……………2

實(shí)時數(shù)據(jù)庫接口資源及連接管理

7………………………2

資源初始化接口

7.1……………………2

資源釋放接口

7.2………………………2

實(shí)時庫連接接口

7.3……………………2

實(shí)時數(shù)據(jù)庫連接斷開接口

7.4…………3

測點(diǎn)管理

8…………………3

測點(diǎn)名稱是否存在檢測接口

8.1………………………3

枚舉測點(diǎn)標(biāo)識接口

8.2…………………3

循環(huán)獲取測點(diǎn)列表接口

8.3ID…………4

釋放結(jié)果集資源接口

8.4………………4

根據(jù)測點(diǎn)名稱獲取單個測點(diǎn)標(biāo)識接口

8.5……………4

根據(jù)測點(diǎn)名稱列表獲取多個測點(diǎn)標(biāo)識接口

8.6………4

根據(jù)測點(diǎn)標(biāo)識獲取單個測點(diǎn)屬性接口

8.7……………5

根據(jù)測點(diǎn)名稱獲取單個測點(diǎn)屬性接口

8.8……………5

根據(jù)測點(diǎn)標(biāo)識列表批量獲取測點(diǎn)屬性接口

8.9………5

根據(jù)測點(diǎn)名稱列表批量獲取測點(diǎn)屬性接口

8.10………5

批量新建測點(diǎn)接口

8.11…………………6

修改單點(diǎn)測點(diǎn)屬性接口

8.12……………6

批量修改測點(diǎn)屬性接口

8.13……………6

根據(jù)測點(diǎn)標(biāo)識刪除單個測點(diǎn)接口

8.14…………………6

根據(jù)測點(diǎn)名稱刪除單個測點(diǎn)接口

8.15…………………6

根據(jù)測點(diǎn)標(biāo)識批量刪除測點(diǎn)接口

8.16…………………7

根據(jù)測點(diǎn)名稱批量刪除測點(diǎn)接口

8.17…………………7

搜索符合條件的測點(diǎn)接口

8.18…………7

數(shù)據(jù)寫入

9…………………7

寫入單個測點(diǎn)的實(shí)時數(shù)據(jù)接口

9.1……………………7

批量寫入測點(diǎn)的實(shí)時數(shù)據(jù)接口

9.2……………………8

批量寫入具有相同測點(diǎn)標(biāo)識的實(shí)時數(shù)據(jù)接口

9.3……………………8

批量寫入具有相同時間戳的實(shí)時數(shù)據(jù)

9.4……………8

Ⅰ

GB/T34949—2017

寫入單個測點(diǎn)某一時刻的歷史數(shù)據(jù)接口

9.5…………9

批量寫入測點(diǎn)的歷史數(shù)據(jù)接口

9.6……………………9

批量寫入具有相同測點(diǎn)標(biāo)識的歷史數(shù)據(jù)接口

9.7……………………9

批量寫入具有相同時間戳的歷史數(shù)據(jù)接口

9.8………9

從歷史數(shù)據(jù)中刪除某個時間的數(shù)據(jù)接口

9.9…………10

從歷史數(shù)據(jù)中刪除某個時間段的數(shù)據(jù)接口

9.10……………………10

修改單個歷史數(shù)據(jù)接口

9.11…………10

數(shù)據(jù)查詢

10………………10

讀取單個測點(diǎn)的實(shí)時數(shù)據(jù)接口

10.1…………………10

批量讀取測點(diǎn)的實(shí)時數(shù)據(jù)接口

10.2…………………10

讀取單個測點(diǎn)某個時間的歷史數(shù)據(jù)接口

10.3………11

讀取單個測點(diǎn)一段時間內(nèi)的歷史數(shù)據(jù)接口

10.4……………………11

循環(huán)獲取結(jié)果集中的歷史值數(shù)接口

10.5……………11

查詢某一歷史時刻的斷面取值接口

10.6……………12

讀取單個測點(diǎn)一段時間內(nèi)等間隔線性擬合后的歷史數(shù)據(jù)接口

10.7………………12

讀取單個測點(diǎn)一段時間內(nèi)等間隔階梯擬合后的歷史數(shù)據(jù)接口

10.8………………12

數(shù)據(jù)統(tǒng)計

11………………13

查詢單個測點(diǎn)在某個時間段內(nèi)的統(tǒng)計數(shù)據(jù)接口

11.1………………13

根據(jù)過濾條件查詢單個測點(diǎn)在某個時間內(nèi)的統(tǒng)計數(shù)接口

11.2……13

附錄規(guī)范性附錄數(shù)據(jù)類型

A()…………14

附錄規(guī)范性附錄錯誤碼

B()……………19

Ⅱ

GB/T34949—2017

前言

本標(biāo)準(zhǔn)按照給出的規(guī)則起草

GB/T1.1—2009。

請注意本文件的某些內(nèi)容可能涉及專利本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別這些專利的責(zé)任

。。

本標(biāo)準(zhǔn)由全國信息技術(shù)標(biāo)準(zhǔn)化技術(shù)委員會提出并歸口

(SAC/TC28)。

本標(biāo)準(zhǔn)起草單位江蘇瑞中數(shù)據(jù)股份有限公司中國電子技術(shù)標(biāo)準(zhǔn)化研究院南京南瑞集團(tuán)公司上

:、、、

海麥杰科技股份有限公司

。

本標(biāo)準(zhǔn)主要起草人張珂珩王遠(yuǎn)季勝鵬鄭曉露粟勇史英杰周淳朱恒蔣樹嵩毛海泉

:、、、、、、、、、、

李賢慧沈國輝周勁鷹孟小凡李瑩衛(wèi)鳳林王笑楊永軍

、、、、、、、。

Ⅲ

GB/T34949—2017

實(shí)時數(shù)據(jù)庫C語言接口規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了實(shí)時數(shù)據(jù)庫語言接口涉及實(shí)時數(shù)據(jù)庫通用接口的原型定義輸入?yún)?shù)和輸出參

C,、

數(shù)的數(shù)據(jù)類型以及接口調(diào)用的返回信息

。

本標(biāo)準(zhǔn)適用于實(shí)時數(shù)據(jù)庫接口的開發(fā)應(yīng)用系統(tǒng)與實(shí)時數(shù)據(jù)庫集成的設(shè)計和開發(fā)可參照執(zhí)行

,。

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

下列文件對于本文件的應(yīng)用是必不可少的凡是注日期的引用文件僅注日期的版本適用于本文

。,

件凡是不注日期的引用文件其最新版本包括所有的修改單適用于本文件

。,()。

程序設(shè)計語言

GB/T15272—1994C

3術(shù)語和定義

下列術(shù)語和定義適用于本文件

。

31

.

實(shí)時數(shù)據(jù)庫real-timedatabase

一種專門用于處理和存儲隨時間變化的值和狀態(tài)量的數(shù)據(jù)庫

。

32

.

測點(diǎn)measurementpoint

實(shí)時數(shù)據(jù)庫中時間序列數(shù)據(jù)的一個存儲單元

。

注測點(diǎn)數(shù)據(jù)可能直接源自采集設(shè)備也可能源自非采集設(shè)備如統(tǒng)計值等計算量

:,,