ts_create_with_metadata() 函数

ts_create_with_metadata() 函数使用所连接的用户定义的元数据来创建时间系列。

语法

ts_timeseries *
ts_create_with_metadata(MI_CONNECTION  *conn,
                       mi_string       *calname,
                       mi_datetime     *origin, 
                       mi_integer      threshold, 
                          mi_integer                   flags,
MI_TYPEID       *typeid,
                       mi_integer      nelem,
                       mi_string       *container,
                       mi_lvarchar     *metadata,
                       MI_TYPEID        *metadata_typeid)

conn

有效的 DataBlade API 连接。

calname

日历的名称。

origin

时间系列的原点。

threshold

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

flags

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

typeid

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

nelems

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

container

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

metadata

要放到时间系列中的元数据。请参阅使用元数据创建时间系列，以获取元数据的更多信息。可为 NULL。

metadata_typeid

元数据的类型标识。如果元数据参数是 NULL，那么该参数可以是 NULL。

描述

此函数的行为与 ts_create() 相同，但该函数还会将提供的元数据保存到时间系列中。元数据可以是 NULL 或零长度 LVARCHAR；如果是其中一个值，那么 ts_create_with_metadata() 的行为与 ts_create() 完全相同。如果 metadata 指针指向有效数据，那么 metadata_typeid 参数必须是用户定义类型的有效类型标识的有效指针。

等效 SQL 函数是 TSCreate 或 TSCreateIrr。

返回结果

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