表格存储 Java SDK 查询分析存储信息-表格存储 Tablestore(Tablestore)-阿里云帮助中心

使用 Java SDK 查询分析存储的配置、数据同步状态和存储量。

前提条件

安装Tablestore Java SDK并初始化时序模型客户端。分析存储功能需要使用 5.15.0 及以上版本，建议使用最新版本。

功能说明

调用 describeTimeseriesAnalyticalStore 方法查询指定分析存储的数据生命周期、同步方式、同步状态和存储量。

public DescribeTimeseriesAnalyticalStoreResponse describeTimeseriesAnalyticalStore(DescribeTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException

以下示例查询 example_timeseries_table 下 example_analytical_store 的信息。同步状态或存储量尚未生成时，对应字段可能为空。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

DescribeTimeseriesAnalyticalStoreRequest request =
        new DescribeTimeseriesAnalyticalStoreRequest(
                "example_timeseries_table", "example_analytical_store");
DescribeTimeseriesAnalyticalStoreResponse response =
        timeseriesClient.describeTimeseriesAnalyticalStore(request);

TimeseriesAnalyticalStore store = response.getAnalyticalStore();
System.out.println(store.getAnalyticalStoreName());
System.out.println(store.getTimeToLive());
System.out.println(store.getSyncOption());

AnalyticalStoreSyncStat syncStat = response.getSyncStat();
if (syncStat != null) {
    System.out.println(syncStat.getSyncPhase());
    System.out.println(syncStat.getCurrentSyncTimestamp());
}

AnalyticalStoreStorageSize storageSize = response.getStorageSize();
if (storageSize != null) {
    System.out.println(storageSize.getSizeInBytes());
    System.out.println(storageSize.getTimestamp());
}

参数说明

DescribeTimeseriesAnalyticalStoreRequest 包含以下参数。

名称	类型	说明
timeseriesTableName（必选）	`String`	时序表名称。
analyticalStoreName（必选）	`String`	分析存储名称。

返回值

DescribeTimeseriesAnalyticalStoreResponse 包含以下业务返回字段。

字段	类型	说明
`analyticalStore`	`TimeseriesAnalyticalStore`	通过 `getAnalyticalStore()` 获取分析存储配置。
`syncStat`	`AnalyticalStoreSyncStat`	通过 `getSyncStat()` 获取数据同步状态。同步状态尚未生成时可能为空。
`storageSize`	`AnalyticalStoreStorageSize`	通过 `getStorageSize()` 获取最近一次统计的存储量。存储量统计尚未生成时可能为空。

分析存储配置

analyticalStore 的类型为 TimeseriesAnalyticalStore，包含以下字段。

字段	类型	说明
`analyticalStoreName`	`String`	通过 `getAnalyticalStoreName()` 获取分析存储名称。
`timeToLive`	`int`	通过 `getTimeToLive()` 获取分析存储的数据生命周期，单位为秒。值为 `-1` 时，表示数据永不过期。
`syncOption`	`AnalyticalStoreSyncType`	通过 `getSyncOption()` 获取数据同步方式。

数据同步状态

syncStat 的类型为 AnalyticalStoreSyncStat，包含以下字段。

字段	类型	说明
`syncPhase`	`AnalyticalStoreSyncType`	通过 `getSyncPhase()` 获取当前同步阶段，取值为 `SYNC_TYPE_FULL` 或 `SYNC_TYPE_INCR`。
`currentSyncTimestamp`	`long`	通过 `getCurrentSyncTimestamp()` 获取当前同步时间戳。

存储量

storageSize 的类型为 AnalyticalStoreStorageSize，包含以下字段。

字段	类型	说明
`sizeInBytes`	`long`	通过 `getSizeInBytes()` 获取分析存储的数据量，单位为字节。
`timestamp`	`long`	通过 `getTimestamp()` 获取存储量统计时间戳。