使用GetTimeseriesData接口，您可以查询符合指定条件的时序数据。
前提条件
已写入时序数据。具体操作，请参见写入时序数据。
已初始化TimeseriesClient。具体操作，请参见初始化Tablestore Client。
参数
参数 | 说明 |
timeseriesKey | 要查询的时间线，包括如下内容：
|
timeRange | 要查询的时间范围，范围为左闭右开区间。包括如下内容：
|
backward | 是否按照时间倒序读取数据，可用于获取某条时间线的最新数据。取值范围如下：
|
fieldsToGet | 要获取的数据列列名。如果不指定，则默认获取所有列。 重要 fieldsToGet中需要指定要获取的每一列的列名和类型。如果类型不匹配，则读取不到对应列的数据。 |
limit | 本次最多返回的行数。 说明 limit仅限制最多返回的行数，在满足条件行数大于limit时，也可能由于扫描数据量等限制导致返回行数少于limit条，此时可以通过nextToken继续获取后面的行。 |
nextToken | 如果一次查询仅返回了部分符合条件的行，此时response中会包括nextToken，可在下一次请求中指定nextToken用来继续读取数据。 重要 如果需要持久化nextToken或者传输nextToken给前端页面，您可以使用Base64编码将nextToken编码为String后进行保存或传输。nextToken本身不是字符串，如果直接使用 |
示例
以下示例用于查询时序表中满足指定条件的时序数据。
private static void getTimeseriesData(TimeseriesClient client) {
String tableName = "<TIMESERIES_TABLE_NAME>";
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());
// 如果nextToken不为空，可以发起下一次请求。
if (getTimeseriesDataResponse.getNextToken() != null) {
// 获取nextToken。
byte[] nextToken = getTimeseriesDataResponse.getNextToken();
// 如果需要持久化nextToken或者传输nextToken给前端页面，您可以使用Base64编码将nextToken编码为String进行保存和传输。
{
// token本身不是字符串，直接使用new String(nextToken)将token编码为String会造成token信息丢失。
String tokenAsString = Base64.toBase64String(nextToken);
// 将String解码为byte。
byte[] tokenAsByte = Base64.fromBase64String(tokenAsString);
}
getTimeseriesDataRequest.setNextToken(nextToken);
getTimeseriesDataResponse = client.getTimeseriesData(getTimeseriesDataRequest);
System.out.println(getTimeseriesDataResponse.getRows().size());
}
}常见问题
如何删除时序数据
数据写入时序表后是否可以立即查询到？