ts_create() 函数

ts_create() 函数用于创建时间系列。

语法

ts_timeseries *
ts_create(MI_CONNECTION *conn,
          mi_string     *calname,
          mi_datetime   *origin, 
          mi_integer    threshold, 
             mi_integer                   flags,
MI_TYPEID     *typeid,
          mi_integer    nelem,
          mi_string      *container)

conn

有效的 DataBlade API 连接。

calname

日历的名称。

origin

时间系列的原点。

threshold

时间系列的阈值。如果时间系列存储此数目或更多的元素，那么它会存储在容器中。如果时间系列保留少于此数目的元素，它会直接存储在包含它的行中。threshold 必须大于或等于 0 且小于 256。

flags

对于规则的时间系列，必须为 0；对于不规则的时间系列，为 TS_CREATE_IRR。

typeid

要创建的新类型时间系列的标识。

nelems

要用于在时间系列中创建空间的初始元素数。在时间系列写入到数据库后，如果不使用该空间，那么会进行回收。

container

用于保留时间系列的容器。如果时间系列适合行的大小或者不会分配给表，该值可能为 NULL。

描述

等效 SQL 函数是 TSCreate 或 TSCreateIrr。

返回结果

新时间系列的指针。用户可通过调用 ts_free() 释放此值。