表格存储：查询时序数据

您可以使用控制台查询某一时间线在指定时间范围内的数据。

1. 进入实例管理页面。

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

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

   3. 在概览页面，单击实例名称或单击实例名称右侧的实例管理。

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

3. 在时序表列表页签，单击目标时序表操作列的数据管理。

4. 在数据管理页签，在目标时间线的操作列单击查询数据。

5. 设置查询条件。

   1. 查询结果默认按照时间从小到大排序。如需按照时间倒序读取数据，请选择倒序查询为是。

   2. 选择查询方式并设置时间。

6. 单击查询。

   符合查询条件的数据会显示在数据管理页签，查询结果支持按列表或者图的方式展示。

   按列表展示数据

   

   按图形展示数据

   

您可以使用命令行工具查询某一时间线在指定时间范围内的数据。

执行getts命令查询某一个时间线中指定范围内的时序数据。更多信息，请参见查询时序数据。

以下示例用于查询度量名称为cpu，数据源标识为localhost，且标签为"region=hangzhou"和"os=ubuntu"的时间线中时间戳在0到1667638230000000之间的最多前100条时序数据。返回结果按照时间戳升序排列。

getts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --time_start 0 --time_end 1667638230000000 --limit 100

您可以使用Java SDK和Go SDK查询某一时间线在指定时间范围内的数据。此处以Java SDK为例介绍时序数据查询功能的使用。

以下示例用于查询test_timeseries_table时序表中满足指定条件的时序数据。

private static void getTimeseriesData(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    GetTimeseriesDataRequest getTimeseriesDataRequest = new GetTimeseriesDataRequest(tableName);
    Map<String, String> tags = new HashMap<String, String>();
    tags.put("region", "hangzhou");
    tags.put("os", "Ubuntu16.04");
    // 通过measurementName、dataSource和tags构建TimeseriesKey。
    TimeseriesKey timeseriesKey = new TimeseriesKey("cpu", "host_0", tags);
    getTimeseriesDataRequest.setTimeseriesKey(timeseriesKey);
    // 指定时间范围。
    getTimeseriesDataRequest.setTimeRange(0, (System.currentTimeMillis() + 60 * 1000) * 1000);
    // 限制返回行数。
    getTimeseriesDataRequest.setLimit(10);
    // 设置是否倒序读取数据，可不设置，默认值为false。如果设置为true，则倒序读取数据。
    getTimeseriesDataRequest.setBackward(false);
    // 设置获取部分数据列，可不设置，默认获取全部数据列。
    getTimeseriesDataRequest.addFieldToGet("string_1", ColumnType.STRING);
    getTimeseriesDataRequest.addFieldToGet("long_1", ColumnType.INTEGER);

    GetTimeseriesDataResponse getTimeseriesDataResponse = client.getTimeseriesData(getTimeseriesDataRequest);
    System.out.println(getTimeseriesDataResponse.getRows().size());
    if (getTimeseriesDataResponse.getNextToken() != null) {
        // 如果nextToken不为空，可以发起下一次请求。
        getTimeseriesDataRequest.setNextToken(getTimeseriesDataResponse.getNextToken());
        getTimeseriesDataResponse = client.getTimeseriesData(getTimeseriesDataRequest);
        System.out.println(getTimeseriesDataResponse.getRows().size());
    }
}