创建时序表

更新时间: 2023-08-02 14:21:36

使用CreateTimeseriesTable创建时序表时,需要指定表的配置信息。

前提条件

注意事项

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

参数

参数

说明

timeseriesTableName

时序表名。

timeseriesTableOptions

时序表的配置信息,包括如下内容:

timeToLive:配置时序表的数据存活时间,单位为秒。如果希望数据永不过期,可以设置为-1。您可以通过UpdateTimeseriesTable接口修改。

analyticalStores

重要

分析存储功能当前正在华东1(杭州)、华东2(上海)和华北2(北京)地域开启公测,公测期间免费使用。

分析存储配置,包括如下内容:

  • analyticalStoreName:分析存储名称。

  • timeToLive:分析存储的数据生命周期。单位为秒。取值范围为-1或者int32的正整数。

    如果希望数据永不过期,可以设置为-1。

  • syncOption:数据同步配置。固定取值为SYNC_TYPE_FULL。

示例

创建test_timeseries_table时序表,且该表中数据永不过期。同时创建一个名称为test_analytical_store的分析存储,且分析存储内的数据永不过期。

/**
 * CreateTimeseriesTableSample用于创建一个时序表,时序表名为timeseriesTableName,TTL为timeTolive,并且创建一个分析存储test_analytical_store。
 */
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)

    // 构造分析存储配置信息
    createTimeseriesTableRequest.SetAnalyticalStores([]*tablestore.TimeseriesAnalyticalStore{
        tablestore.NewTimeseriesAnalyticalStore("test_analytical_store"),
    })

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

阿里云首页 表格存储 相关技术圈