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

ICS3524050

L67..

中華人民共和國國家標準

GB/T34949—2017

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

Cprogramminglanguageinterfacespecificationofreal-timedatabase

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

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

中國國家標準化管理委員會

GB/T34949—2017

目次

前言

…………………………Ⅲ

范圍

1………………………1

規(guī)范性引用文件

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

術(shù)語和定義

3………………1

縮略語

4……………………1

概述

5………………………2

接口描述約定

6……………2

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

7………………………2

資源初始化接口

7.1……………………2

資源釋放接口

7.2………………………2

實時庫連接接口

7.3……………………2

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

7.4…………3

測點管理

8…………………3

測點名稱是否存在檢測接口

8.1………………………3

枚舉測點標識接口

8.2…………………3

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

8.3ID…………4

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

8.4………………4

根據(jù)測點名稱獲取單個測點標識接口

8.5……………4

根據(jù)測點名稱列表獲取多個測點標識接口

8.6………4

根據(jù)測點標識獲取單個測點屬性接口

8.7……………5

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

8.8……………5

根據(jù)測點標識列表批量獲取測點屬性接口

8.9………5

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

8.10………5

批量新建測點接口

8.11…………………6

修改單點測點屬性接口

8.12……………6

批量修改測點屬性接口

8.13……………6

根據(jù)測點標識刪除單個測點接口

8.14…………………6

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

8.15…………………6

根據(jù)測點標識批量刪除測點接口

8.16…………………7

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

8.17…………………7

搜索符合條件的測點接口

8.18…………7

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

9…………………7

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

9.1……………………7

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

9.2……………………8

批量寫入具有相同測點標識的實時數(shù)據(jù)接口

9.3……………………8

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

9.4……………8

Ⅰ

GB/T34949—2017

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

9.5…………9

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

9.6……………………9

批量寫入具有相同測點標識的歷史數(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

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

10.1…………………10

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

10.2…………………10

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

10.3………11

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

10.4……………………11

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

10.5……………11

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

10.6……………12

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

10.7………………12

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

10.8………………12

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

11………………13

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

11.1………………13

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

11.2……13

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

A()…………14

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

B()……………19

Ⅱ

GB/T34949—2017

前言

本標準按照給出的規(guī)則起草

GB/T1.1—2009。

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

。。

本標準由全國信息技術(shù)標準化技術(shù)委員會提出并歸口

(SAC/TC28)。

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

:、、、

海麥杰科技股份有限公司

。

本標準主要起草人張珂珩王遠季勝鵬鄭曉露粟勇史英杰周淳朱恒蔣樹嵩毛海泉

:、、、、、、、、、、

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

、、、、、、、。

Ⅲ

GB/T34949—2017

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

1范圍

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

C,、

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

。

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

,。

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

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

。,

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

。,()。

程序設(shè)計語言

GB/T15272—1994C

3術(shù)語和定義

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

。

31

.

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

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

。

32

.

測點measurementpoint

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

。

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

:,,