Java SDK创建时序表 - 表格存储

当使用表格存储时序模型时，您需要使用CreateTimeseriesTable接口创建时序表用于存储时序数据。创建时序表时支持配置数据生命周期、时序时间线表的配置信息。

前提条件

已通过控制台创建实例。具体操作，请参见创建时序模型实例。
已初始化TimeseriesClient。具体操作，请参见初始化OTSClient。

注意事项

时序表的名称不能与当前已存在的数据表名称相同。

接口

public class CreateTimeseriesTableRequest implements Request {
    /**时序表的结构信息。*/
    private TimeseriesTableMeta timeseriesTableMeta;
}

参数

说明

TimeseriesTableMeta

时序表的结构信息，包含如下内容：

timeseriesTableName：时序表名。
timeseriesMetaOptions：时序时间线表的配置信息，包括如下内容：
- metaTimeToLive：配置时序时间线表的时间线数据存活时间，单位为秒。取值必须大于等于604800秒（即7天）或者必须为-1（数据永不过期）。
- allowUpdateAttributes：是否允许更新时间线属性列。
您可以通过UpdateTimeseriesTable接口修改相应配置。
timeseriesTableOptions：时序表的配置信息，包括如下内容：
timeToLive：配置时序表的数据存活时间，单位为秒。如果希望数据永不过期，可以设置为-1。您可以通过UpdateTimeseriesTable接口修改。

示例

以下示例用于创建test_timeseries_table时序表，且该表中数据永不过期。

private static void createTimeseriesTable(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
    
    client.createTimeseriesTable(request);
}