表格存储：时序表操作

通过控制台创建一张时序表。

1. 进入实例管理页面。

   1. 登录表格存储控制台。

   2. 在页面上方，选择资源组和地域。

   3. 在概览页面，单击实例名称或者单击实例操作的实例管理。

2. 在实例详情页签，单击时序表列表页签。

3. 在时序表列表页签，单击创建时序表。

   说明

   您也可以单击一键生成样例，创建一张测试表以及样例数据来快速体验功能。对于新建的测试表，系统会进行一些初始化操作，因此需要等待几十秒左右才能看到时间线。

4. 在创建时序表对话框，按照如下说明配置时序表信息。

   参数	描述
   时序表名称	时序表的名称，用于在实例中唯一标识一张时序表。 时序表的命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1~128个字符之间。 重要 时序表的名称不能与当前已存在的数据表、二级索引表和时序表的名称相同。
   数据生命周期	时序表中数据的过期时间，单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时，系统会自动清理超过数据生命周期的数据。 重要 在时序表中，系统判断数据产生时间以用户传入的时间列为准，并非数据写入表中的时间。 取值必须大于等于86400秒（一天）或者必须为-1（数据永不过期）。

5. 单击确定。

   时序表创建完成后，在时序表列表页签，您可以查看已创建的时序表。如果新建的表未显示在列表中，可单击图标，刷新时序表列表。

创建时序表后，请根据实际需要执行相应操作管理时序表。

通过命令行工具执行create命令创建时序表。更多信息，请参见创建表。

以下示例用于创建名称为mytable的时序表，表中数据永不过期。

create -m timeseries -t mytable --ttl -1

执行表操作前，您需要执行use命令选择要使用的表。更多信息，请参见使用表。

以下示例用于使用mytable时序表。

use --ts -t mytable

创建并使用时序表后，请根据实际需要执行相应操作管理时序表。

list -t

alter --ttl 86400 --ts

desc --ts -t mytable

drop -t mytable --ts -y

您可以使用Java SDK和Go SDK创建时序表以及管理时序表。此处以Java SDK为例介绍时序表的创建和管理。

请根据实际场景选择合适的示例进行时序表创建。

以下示例用于创建test_timeseries_table时序表，且该表中数据永不过期。

private static void createTimeseriesTable(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
    
    client.createTimeseriesTable(request);
}

创建时序表后，请根据实际需要执行相应操作管理时序表。

private static void listTimeseriesTable(TimeseriesClient client) {
    ListTimeseriesTableResponse listTimeseriesTableResponse = client.listTimeseriesTable();
    for (String table : listTimeseriesTableResponse.getTimeseriesTableNames()) {
        System.out.println(table);
    }
}

private static void updateTimeseriesTable(TimeseriesClient client) {
    // 填写时序表名称。
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // 更新TTL为3年。
    updateTimeseriesTableRequest.setTimeseriesTableOptions(new TimeseriesTableOptions(86400 * 365 * 3)); 
    client.updateTimeseriesTable(updateTimeseriesTableRequest);

    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 查看更新后时序表的TTL配置。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
}

private static void describeTimeseriesTable(TimeseriesClient client) {
    // 填写时序表名称。
    String tableName = "<TIMESERIES_TABLE>";
    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 查看时序表名。
    System.out.println(tableMeta.getTimeseriesTableName()); 
    // 查看时序表状态。
    System.out.println(tableMeta.getStatus()); 
    // 查看时序表的TTL配置。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
    // 查看时间线表的TTL配置。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive()); 
    // 查看是否允许更新时间线属性列。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes()); 
}

private static void deleteTimeseriesTable(TimeseriesClient client) {
    // 填写时序表名称。
    String tableName = "<TIMESERIES_TIME>";
    DeleteTimeseriesTableRequest deleteTimeseriesTableRequest = new DeleteTimeseriesTableRequest(tableName);
    client.deleteTimeseriesTable(deleteTimeseriesTableRequest);
}