时序表操作

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

1. 进入实例管理页面。

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

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

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

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

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

   说明

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

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

   参数	描述
   时序表名称	时序表的名称，用于在实例中唯一标识一张时序表。 时序表的命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1~128个字符之间。 重要 时序表的名称不能与当前已存在的数据表、二级索引表和时序表的名称相同。
   数据生命周期	时序表中数据的过期时间，单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时，系统会自动清理超过数据生命周期的数据。 重要 在时序表中，系统判断数据产生时间以用户传入的时间列为准，并非数据写入表中的时间。 取值必须大于等于86400秒（一天）或者必须为-1（数据永不过期）。
   创建分析存储	分析存储功能主要用于时序数据长期存储和分析场景。使用分析存储（Analytical Store）功能，您可以低成本存储时序数据以及快速查询和分析时序数据。更多信息，请参见时序分析存储概述。 系统默认已开启分析存储，请根据实际业务场景进行分析存储配置。 如果不需要使用分析存储，关闭创建分析存储开关即可。 如果需要创建默认分析存储，创建分析存储保持默认配置即可。 如果需要自定义分析存储，创建分析存储保持默认，打开高级选项开关并配置分析存储名称和分析存储生命周期。

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为例介绍时序表的创建和管理。

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

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);
    //不创建默认分析存储。
    request.setEnableAnalyticalStore(false);    
    client.createTimeseriesTable(request);
}

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 createTimeseriesTable(TimeseriesClient client) {
    // 设置时序表名称和TTL。
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);

    // 自定义分析存储。
    List<TimeseriesAnalyticalStore> analyticalStores = new ArrayList<TimeseriesAnalyticalStore>();
    analyticalStores.add(new TimeseriesAnalyticalStore("test_analytical_store"));
    request.setAnalyticalStores(analyticalStores);

    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()); 
    //如果为时序表创建了分析存储，您可以使用如下代码获取时序表的分析存储信息。
    List<TimeseriesAnalyticalStore> analyticalStores = describeTimeseriesTableResponse.getAnalyticalStores(); // 查看时序表的分析存储配置。
    for (TimeseriesAnalyticalStore store : analyticalStores) {
        // 查看分析存储名称。
        System.out.println(store.getAnalyticalStoreName()); 
        // 查看分析存储TTL配置。
        System.out.println(store.getTimeToLive()); 
        // 查看分析存储同步配置。
        System.out.println(store.getSyncOption()); 
    }
}

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