全部产品
Search
文档中心

表格存储:创建时序表

更新时间:Jul 26, 2024

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

前提条件

注意事项

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

参数

参数

说明

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

相关文档

  • 创建时序表后,您可以写入时序数据以及读取表中时序数据。具体操作,请参见写入时序数据查询时序数据

  • 如果要修改时序表的数据生命周期,您可以通过更新时序表功能实现。具体操作,请参见更新时序表

  • 如果要查询当前实例下的所有时序表,您可以通过列出时序表名称实现。具体操作,请参见列出时序表名称

  • 如果要查看时序表的详细配置信息,您可以通过查询时序表描述信息实现。更多信息,请参见查询时序表描述信息

  • 如果不再使用时序表,您可以删除时序表。具体操作,请参见删除时序表

  • 如果要以更低成本备份表格存储中的时序数据或者以文件形式导出时序数据到本地,您可以通过DataWorks数据集成服务将表格存储中的时序数据导出到OSS后进行存储或者下载。更多信息,请参见将表格存储数据同步到OSS

  • 如果要可视化展示时序数据,您可以通过对接Grafana实现。更多信息,请参见对接Grafana

  • 通过Flink计算与分析数据后,您可以使用Tablestore时序表存储输出结果。更多信息,请参见使用教程(时序模型)