ICS3524050

L67..

中華人民共和國國家標準

GB/T34949—2017

實時數據庫C語言接口規范

Cprogramminglanguageinterfacespecificationofreal-timedatabase

2017-11-01發布2018-05-01實施

中華人民共和國國家質量監督檢驗檢疫總局發布

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

GB/T34949—2017

目次

前言

…………………………Ⅲ

范圍

1………………………1

規范性引用文件

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

術語和定義

3………………1

縮略語

4……………………1

概述

5………………………2

接口描述約定

6……………2

實時數據庫接口資源及連接管理

7………………………2

資源初始化接口

7.1……………………2

資源釋放接口

7.2………………………2

實時庫連接接口

7.3……………………2

實時數據庫連接斷開接口

7.4…………3

測點管理

8…………………3

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

8.1………………………3

枚舉測點標識接口

8.2…………………3

循環獲取測點列表接口

8.3ID…………4

釋放結果集資源接口

8.4………………4

根據測點名稱獲取單個測點標識接口

8.5……………4

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

8.6………4

根據測點標識獲取單個測點屬性接口

8.7……………5

根據測點名稱獲取單個測點屬性接口

8.8……………5

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

8.9………5

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

8.10………5

批量新建測點接口

8.11…………………6

修改單點測點屬性接口

8.12……………6

批量修改測點屬性接口

8.13……………6

根據測點標識刪除單個測點接口

8.14…………………6

根據測點名稱刪除單個測點接口

8.15…………………6

根據測點標識批量刪除測點接口

8.16…………………7

根據測點名稱批量刪除測點接口

8.17…………………7

搜索符合條件的測點接口

8.18…………7

數據寫入

9…………………7

寫入單個測點的實時數據接口

9.1……………………7

批量寫入測點的實時數據接口

9.2……………………8

批量寫入具有相同測點標識的實時數據接口

9.3……………………8

批量寫入具有相同時間戳的實時數據

9.4……………8

Ⅰ

GB/T34949—2017

寫入單個測點某一時刻的歷史數據接口

9.5…………9

批量寫入測點的歷史數據接口

9.6……………………9

批量寫入具有相同測點標識的歷史數據接口

9.7……………………9

批量寫入具有相同時間戳的歷史數據接口

9.8………9

從歷史數據中刪除某個時間的數據接口

9.9…………10

從歷史數據中刪除某個時間段的數據接口

9.10……………………10

修改單個歷史數據接口

9.11…………10

數據查詢

10………………10

讀取單個測點的實時數據接口

10.1…………………10

批量讀取測點的實時數據接口

10.2…………………10

讀取單個測點某個時間的歷史數據接口

10.3………11

讀取單個測點一段時間內的歷史數據接口

10.4……………………11

循環獲取結果集中的歷史值數接口

10.5……………11

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

10.6……………12

讀取單個測點一段時間內等間隔線性擬合后的歷史數據接口

10.7………………12

讀取單個測點一段時間內等間隔階梯擬合后的歷史數據接口

10.8………………12

數據統計

11………………13

查詢單個測點在某個時間段內的統計數據接口

11.1………………13

根據過濾條件查詢單個測點在某個時間內的統計數接口

11.2……13

附錄規范性附錄數據類型

A()…………14

附錄規范性附錄錯誤碼

B()……………19

Ⅱ

GB/T34949—2017

前言

本標準按照給出的規則起草

GB/T1.1—2009。

請注意本文件的某些內容可能涉及專利本文件的發布機構不承擔識別這些專利的責任

。。

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

(SAC/TC28)。

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

:、、、

海麥杰科技股份有限公司

。

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

:、、、、、、、、、、

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

、、、、、、、。

Ⅲ

GB/T34949—2017

實時數據庫C語言接口規范

1范圍

本標準規定了實時數據庫語言接口涉及實時數據庫通用接口的原型定義輸入參數和輸出參

C,、

數的數據類型以及接口調用的返回信息

。

本標準適用于實時數據庫接口的開發應用系統與實時數據庫集成的設計和開發可參照執行

,。

2規范性引用文件

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

。,

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

。,()。

程序設計語言

GB/T15272—1994C

3術語和定義

下列術語和定義適用于本文件

。

31

.

實時數據庫real-timedatabase

一種專門用于處理和存儲隨時間變化的值和狀態量的數據庫

。

32

.

測點measurementpoint

實時數據庫中時間序列數據的一個存儲單元

。

注測點數據可能直接源自采集設備也可能源自非采集設備如統計值等計算量

:,,