Valid

GB/T 34949-2017C programming language interface specification of real-time database (English PDF)

实时数据库C语言接口规范

Preview PDF

This is a limited preview

Buy now to download the full PDF (20 pages)

Need quotation for your management?

Get a formal quotation for GB/T 34949-2017 in 30 minutes.

Issued by

SAMR; SAC

Level / Type

National · Recommended

Issue date

November 1, 2017

Implementation date

May 1, 2018

Scope

GB/T 34949-2017 is the English-translated version of 实时数据库C语言接口规范.

GB/T 34949-2017 fixes the C language interface of a real-time database.

Clause 1 states that the standard specifies that interface, covering the prototype definitions of the common real-time database interfaces, the data types of the input and output parameters and the information returned by an interface call, and that it applies to the development of real-time database interfaces, with integration design and development between application systems and a real-time database able to refer to it.

The document is organised in eleven clauses, Scope, Normative references, Terms and definitions, Abbreviations, an overview, the interface description convention, then interface resources and connection management with interfaces for resource initialisation and release and for opening and disconnecting a real-time library connection, measuring point management with eighteen interfaces for testing the existence of a point name, enumerating and listing point identifiers, reading and modifying point attributes singly and in batches, adding and deleting points and searching qualifying points, data writing with eleven interfaces for real-time and historical data, data query with eight read interfaces including cross-section values and equal-interval linear fitting, and statistics with two query interfaces.

Two normative appendices follow, on data types and on error codes. Clause 3 defines the real-time database, the measuring point, the quality code, the real-time value, the historical value and the result set, and it records that each real-time and historical value consists of a timestamp, a data value and a quality code.

Clause 2 cites GB/T 15272-1994 on the C programming language. The foreword carries a patent notice and names the National Information Technology Standardization Technical Committee (SAC/TC28) as the body in charge.

The draft breaks off at the opening line of clause 4, so the abbreviations themselves are not shown. It was issued on 1 November 2017 and has applied since 1 May 2018.

Found what you need?

Document preview — GB/T 34949-2017

National Standard of the People's Republic of China

ICS
35.240.50
Classification
L 67

Issued by: State Administration for Market Regulation; Standardization Administration of the PRC

Contents

  • Foreword
  • 1 Scope
  • 2 Normative references
  • 3 Terms and definitions
  • 4 Abbreviations
  • 5 Overview
  • 6 interface description convention
  • 7 real-time database interface resources and connection management
  • 7.1 resource initialization interface
  • 7.2 resource release interface
  • 7.3 Real-time library connection interface
  • 7.4 Real-time database connection Disconnect the interface
  • 8 measuring point management
  • 8.1 Test point name existence of the test interface
  • 8.2 enumeration point identification interface
  • 8.3 Cycle Get ID List Interface
  • 8.4 Release result set resource interface
  • 8.5 Obtain a single point identification interface 4 according to the name of the point
  • 8.6 Obtain multiple measurement points according to the list of measurement points Identify the interface
  • 8.7 Obtain a single point attribute interface 5 according to the point identifier
  • 8.8 Obtain a single measurement point attribute interface 5 according to the measurement point name
  • 8.9 According to the list of measurement points batch measurement point interface
  • 8.10 According to the measurement point name list batch measurement point attribute interface
  • 8.11 Batch New Test Point Interface
  • 8.12 Modify the single point measuring point attribute interface
  • 8.13 Batch modify the measuring point attribute interface
  • 8.14 Delete a single measuring point interface 6 according to measuring point identification
  • 8.15 Delete a single measuring point interface 6 according to the measuring point name
  • 8.16 Delete measuring point interface in batches according to measuring point identification
  • 8.17 According to the measuring point name batch delete measuring point interface
  • 8.18 Search qualified point interface
  • 9 data is written to
  • 9.1 Write a single point of real-time data interface
  • 9.2 batch write measuring point real-time data interface
  • 9.3 Batch write real-time data interface with same measuring point identification
  • 9.4 Batch Write Real-Time Data with the Same Timestamps
  • 9.5 write a single point of history data interface 9 at a time
  • 9.6 batch write measuring point historical data interface
  • 9.7 Batch Write History Data Interface 9 with Identical Track Identifier
  • 9.8 Batch Write History Data Interface with Same Timestamp
  • 9.9 Remove the data interface 10 from the historical data at a certain time
  • 9.10 Remove the data interface 10 from the historical data for a certain period of time
  • 9.11 Modify Single Historical Data Interface
  • 10 data query
  • 10.1 read a single point of real-time data interface
  • 10.2 batch read measuring point real-time data interface
  • 10.3 Reading a single point of history data interface 11 at a time
  • 10.4 Reading a single measuring point for a period of time historical data interface
  • 10.5 Loop Get the historical value of the result set Interface
  • 10.6 Query the cross-section value interface 12 of a historical moment Statistics
  • 11.1 Query the statistical data interface of a single measuring point within a certain period of time
  • 11.2 Query the Statistics Interface of a Single Measurement Point at a Certain Time According to the Filter Condition
  • Appendix A (Normative) Data Types
  • Appendix B (Normative) error code

Foreword

This standard was drafted in accordance with the rules given in GB/T 1.1-2009.

1 Scope

This standard specifies the real-time database C language interface, involving real-time database common interface prototype definition, input parameters and output parameters The data type of the number and the return information of the interface call.

This standard applies to the development of real-time database interface, application systems and real-time database integration design and development can refer to the implementation.

2 Normative references

The following documents for the application of this document is essential. For dated references, only the dated version applies to this document. For undated references, the latest edition (including all amendments) applies to this document.

Programming language C GB/T 15272-1994

3 Terms and definitions

The following terms and definitions apply to this document.

3.1 Real-time database

real-timedatabase A database specifically designed to process and store values and status variables over time.

3.2 Measuring point

A storage unit of time series data in real time database.

NOTE Point data may be derived directly from the acquisition equipment or from non-acquisition equipment such as statistics.

3.3 Quality code (status code)

qualitycode A set of codes describing data quality attributes, each in 32-bit total.

3.4 Real-time value

currentvalue The latest value collected by the measuring point, that is, the value closest to the current time stored in the measuring point in the real-time database. Each real-time value includes the timestamp, number According to the value and quality code three parts.

3.5 Historical value

The historical value collected by the measuring point, that is, the non-latest value stored in the measuring point in the real-time database. Historical data is formed by precipitation of real-time data, each calendar Historical value includes time stamp, data value and quality code in three parts.

3.6 Result set

Call the real-time database common interface returns the resulting data collection, the results of the data format defined by the contents of the query.

4 Abbreviations

The following abbreviations apply to this document.

......
This preview omits tables, figures, formulas and parts of the technical clauses. The complete document — 20 pages — is available in the English PDF.

Similar standards

How to Download GB/T 34949-2017

  1. 1

    Add to cart

    Click "Download PDF" on this page and choose "Buy this standard". You can add more standards before checkout.

  2. 2

    Checkout

    Enter your email and billing details. Payment is processed securely by Stripe (cards or bank transfer). Prefer bank details? Request a quotation (min. order $300).

  3. 3

    Fast delivery

    After payment you'll receive an email confirmation. The English PDF is sent to the same address, usually within minutes and at the latest within 1 business day.

  4. 4

    Invoice included

    A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.

Related Standards

English PDF
20 pages
Fast delivery
Invoice included
View Cart

Secure payment via Stripe

Payments accepted

VisaMastercardAmerican ExpressApple PayGoogle PayStripe

GB/T 34949-2017

$355.00