ICS3524050

L67..

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

GB/T34949—2017

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

Cprogramminglanguageinterfacespecificationofreal-timedatabase

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

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

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

GB/T34949—2017

目次

前言

…………………………Ⅲ

范圍

1………………………1

規(guī)范性引用文件

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

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

3………………1

縮略語(yǔ)

4……………………1

概述

5………………………2

接口描述約定

6……………2

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

7………………………2

資源初始化接口

7.1……………………2

資源釋放接口

7.2………………………2

實(shí)時(shí)庫(kù)連接接口

7.3……………………2

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

7.4…………3

測(cè)點(diǎn)管理

8…………………3

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

8.1………………………3

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

8.2…………………3

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

8.3ID…………4

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

8.4………………4

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

8.5……………4

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

8.6………4

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

8.7……………5

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

8.8……………5

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

8.9………5

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

8.10………5

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

8.11…………………6

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

8.12……………6

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

8.13……………6

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

8.14…………………6

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

8.15…………………6

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

8.16…………………7

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

8.17…………………7

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

8.18…………7

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

9…………………7

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

9.1……………………7

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

9.2……………………8

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

9.3……………………8

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

9.4……………8

Ⅰ

GB/T34949—2017

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

9.5…………9

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

9.6……………………9

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

9.7……………………9

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

9.8………9

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

9.9…………10

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

9.10……………………10

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

9.11…………10

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

10………………10

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

10.1…………………10

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

10.2…………………10

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

10.3………11

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

10.4……………………11

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

10.5……………11

查詢某一歷史時(shí)刻的斷面取值接口

10.6……………12

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

10.7………………12

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

10.8………………12

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

11………………13

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

11.1………………13

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

11.2……13

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

A()…………14

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

B()……………19

Ⅱ

GB/T34949—2017

前言

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

GB/T1.1—2009。

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

。。

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

(SAC/TC28)。

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

:、、、

海麥杰科技股份有限公司

。

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

:、、、、、、、、、、

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

、、、、、、、。

Ⅲ

GB/T34949—2017

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

1范圍

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

C,、

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

。

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

,。

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

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

。,

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

。,()。

程序設(shè)計(jì)語(yǔ)言

GB/T15272—1994C

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

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

。

31

.

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

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

。

32

.

測(cè)點(diǎn)measurementpoint

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

。

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

:,,