时间系列 API 例程

时间系列应用程序编程接口例程允许应用程序程序员直接访问时间系列数据。

您可以扫描并更新时间戳记或时间系列索引引用的时间系列元素集或单个元素。这些例程可在客户机程序中使用,以访存二进制方式的时间系列数据;或者也可在具有参数的已注册服务器或客户机例程中使用,以返回时间系列类型的值。

如果失败,那么这些例程会发出错误条件,且不会返回值。

在 UNIX™ 上,两个归档中存在这些例程:tsfeapi.atsbeapi.a。要使用其中任何一个例程,请在生成服务器的共享库时包括 tsbeapi.a 文件,或者在编译客户机应用程序时使用 tsfeapi.a

当存在任一时间系列接口例程的调用时,必须包括 tseries.h 头文件。

在 UNIX 上,tsfeapi.atsbeapi.atseries.h 全部位于数据库服务器GBase 8s TimeSeries DataBlade 模块安装的 lib 目录中。

重要: 由于 mi_value 返回的值仅在下一次 mi_next_rowmi_query_finish 调用前有效,因此可能需要将时间系列放在保存集内,或者使用 ts_copy 访问 mi_get_results 循环外的时间系列。