当使用表格存储时序模型时,您需要使用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)
}