全部产品
Search
文档中心

表格存储:创建时序表

更新时间:Nov 16, 2023

当使用表格存储时序模型时,您需要使用CreateTimeseriesTable接口创建时序表用于存储时序数据。创建时序表时支持配置数据生命周期。

前提条件

注意事项

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

    说明

    您可以使用ListTimeseriesTable接口列出指定实例下已有的时序表名称。具体操作,请参见列出时序表名称

  • 一个时序表只能创建一个分析存储。

参数

参数

说明

timeseriesTableName

时序表名。

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)
}