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

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

前提条件

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

注意事项

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

参数

说明

TimeseriesTableMeta

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

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

示例

以下示例用于创建一个时序表。

/**
 * CreateTimeseriesTableSample用于创建一个时序表，时序表名为timeseriesTableName，TTL为timeTolive。
 */
func CreateTimeseriesTableSample(client *tablestore.TimeseriesClient, timeseriesTableName string , timeToLive int64) {
    fmt.Println("[Info]: Begin to create timeseries table: " , timeseriesTableName)

    // 构造时序表配置信息。
    timeseriesTableOptions := tablestore.NewTimeseriesTableOptions(timeToLive)        

    // 构造表元数据信息。
    // 设置时序表名。
    timeseriesTableMeta := tablestore.NewTimeseriesTableMeta(timeseriesTableName)  
    // 设置时序表配置信息。
    timeseriesTableMeta.SetTimeseriesTableOptions(timeseriesTableOptions)      

    // 构造创建时序表请求。
    createTimeseriesTableRequest := tablestore.NewCreateTimeseriesTableRequest()    
    createTimeseriesTableRequest.SetTimeseriesTableMeta(timeseriesTableMeta)

    // 调用client创建时序表。
    createTimeseriesTableResponse , err := client.CreateTimeseriesTable(createTimeseriesTableRequest)    
    if err != nil {
        fmt.Println("[Error]: Failed to create timeseries table with error: " , err)
        return
    }
    fmt.Println("[Info]: CreateTimeseriesTable finished! RequestId: " , createTimeseriesTableResponse.RequestId)
}