时序表操作

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

1. 进入实例管理页面。

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

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

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

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

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

   说明

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

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

   参数	描述
   时序表名称	时序表的名称，用于在实例中唯一标识一张时序表。 时序表的命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1~128个字符之间。 重要 时序表的名称不能与当前已存在的数据表、二级索引表和时序表的名称相同。
   数据生命周期	时序表中数据的过期时间，单位为秒。当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时，系统会自动清理超过数据生命周期的数据。 重要 在时序表中，系统判断数据产生时间以用户传入的时间列为准，并非数据写入表中的时间。 取值必须大于等于86400秒（一天）或者必须为-1（数据永不过期）。
   时间线标识	时间线标识也称为时间序列标识，用来唯一标识一条时间线。时间线标识由度量名称、数据源和标签三部分组成，时间线标识在时序表中对应的名称分别为_m_name、_data_source和_tags。其中标签由多个字符串类型的键值对组成。 重要 时序表创建完成后不可变更自定义时间线标识字段，请谨慎操作。 自定义时间线标识字段名称必须由小写字母、数字和下划线组成，且不能以数字开头。长度为1~128个字节。 自定义时间线标识字段数量上限为6。 说明 通过单击添加时间线标识，您可以添加多个自定义时间线标识字段；单击自定义时间线标识字段后的图标，可以删除不需要添加的字段。
   主键字段	当实际业务中存在时间线标识和时间点相同，但是时序数据不同的数据存储需求时，您可以通过为时序表添加作为主键的数据字段来实现。 重要 时序表创建完成后不可变更作为主键的数据字段，请谨慎操作。 作为主键的数据字段名称必须由小写字母、数字和下划线组成，且不能以数字开头。长度为1~128个字节。 作为主键的数据字段数量上限为4。 作为主键的数据字段，数据类型可选为字符串和整型。 说明 通过单击添加主键字段，您可以添加多个作为主键的数据字段；单击作为主键的数据字段后的图标，可以删除不需要添加的字段。
   创建分析存储	分析存储功能主要用于时序数据长期存储和分析场景。使用分析存储（Analytical Store）功能，您可以低成本存储时序数据以及快速查询和分析时序数据。更多信息，请参见时序分析存储概述。 系统默认已开启分析存储，请根据实际业务场景进行分析存储配置。 如果不需要使用分析存储，关闭创建分析存储开关即可。 如果需要创建默认分析存储，创建分析存储保持默认配置即可。 如果需要自定义分析存储，创建分析存储保持默认，打开高级选项开关并配置分析存储名称和分析存储生命周期。
   创建Lastpoint索引	Lastpoint索引提供了快速获取时间线最新时间点数据的能力。创建Lastpoint索引后，您可以通过数据读取接口（包括GetRow、BatchGetRow和GetRange）、SQL或多元索引查询Lastpoint索引表中的数据。 系统默认关闭创建Lastpoint索引开关，请根据实际业务场景进行Lastpoint索引配置。 如果不需要创建Lastpoint索引，保持默认配置即可。 如果需要创建Lastpoint索引，请打开创建Lastpoint索引开关，并配置Lastpoint索引名称。 说明 Lastpoint索引名称必须由字母、数字和下划线组成，且不能以数字开头。长度为1~128个字节。 一个时序表最多只能创建10个Lastpoint索引。

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 createTimeseriesTable(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    timeseriesTableMeta.addTimeseriesKey("pk1");
    timeseriesTableMeta.addTimeseriesKey("pk2");
    timeseriesTableMeta.addFieldPrimaryKey("field1", PrimaryKeyType.INTEGER);
    timeseriesTableMeta.addFieldPrimaryKey("field2", PrimaryKeyType.STRING);
    timeseriesTableMeta.addFieldPrimaryKey("field3", PrimaryKeyType.BINARY);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
    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);
    request.addLastpointIndex(new CreateTimeseriesTableRequest.LastpointIndex("index1"));
    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);
}