Table Store Java SDK 查詢時序表資訊 - Tablestore

使用 Java SDK 查詢指定時序表的配置和狀態，包括生命週期、自訂時間軸標識、資料欄位主鍵、分析儲存和 Lastpoint 索引。

前提條件

安裝Tablestore Java SDK並初始化時序模型用戶端。

功能說明

調用 describeTimeseriesTable 方法查詢指定時序表的配置和狀態。響應還包含該表的分析儲存和 Lastpoint 索引列表；未配置時返回空列表。

public DescribeTimeseriesTableResponse describeTimeseriesTable(DescribeTimeseriesTableRequest request)

以下樣本查詢 example_timeseries_table 的配置和狀態，並讀取分析儲存及 Lastpoint 索引資訊。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
DescribeTimeseriesTableRequest request =
        new DescribeTimeseriesTableRequest(tableName);
DescribeTimeseriesTableResponse response =
        timeseriesClient.describeTimeseriesTable(request);

TimeseriesTableMeta tableMeta = response.getTimeseriesTableMeta();
System.out.println(tableMeta.getTimeseriesTableName());
System.out.println(tableMeta.getStatus());
System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes());

for (TimeseriesAnalyticalStore store : response.getAnalyticalStores()) {
    System.out.println(store.getAnalyticalStoreName());
    System.out.println(store.getTimeToLive());
    System.out.println(store.getSyncOption());
}

for (TimeseriesLastpointIndex index : response.getLastpointIndexes()) {
    System.out.println(index.getLastpointIndexName());
}

參數說明

DescribeTimeseriesTableRequest 包含以下參數。

名稱	類型	說明
timeseriesTableName（必選）	`String`	時序表名稱。

傳回值

DescribeTimeseriesTableResponse 包含以下業務返回欄位。

欄位	類型	說明
`timeseriesTableMeta`	`TimeseriesTableMeta`	通過 `getTimeseriesTableMeta()` 擷取時序表的配置和狀態。
`analyticalStores`	`List<TimeseriesAnalyticalStore>`	通過 `getAnalyticalStores()` 擷取分析儲存列表。未建立分析儲存時返回空列表。
`lastpointIndexes`	`List<TimeseriesLastpointIndex>`	通過 `getLastpointIndexes()` 擷取 Lastpoint 索引列表。未建立 Lastpoint 索引時返回空列表。

時序表資訊

timeseriesTableMeta 的類型為 TimeseriesTableMeta，包含以下欄位。

欄位	類型	說明
`timeseriesTableName`	`String`	通過 `getTimeseriesTableName()` 擷取時序表名稱。
`timeseriesTableOptions`	`TimeseriesTableOptions`	通過 `getTimeseriesTableOptions()` 擷取時序資料配置。
`timeseriesMetaOptions`	`TimeseriesMetaOptions`	通過 `getTimeseriesMetaOptions()` 擷取時間軸中繼資料配置。
`status`	`String`	通過 `getStatus()` 擷取時序表狀態。
`timeseriesKeys`	`List<String>`	通過 `getTimeseriesKeys()` 擷取自訂時間軸標識的欄位名稱列表。未自訂時返回空列表。
`fieldPrimaryKeys`	`List<PrimaryKeySchema>`	通過 `getFieldPrimaryKeys()` 擷取作為主鍵的資料欄位列表。未配置時返回空列表。

時序資料配置

timeseriesTableMeta.timeseriesTableOptions 的類型為 TimeseriesTableOptions，包含以下欄位。

欄位	類型	說明
`timeToLive`	`int`	通過 `getTimeToLive()` 擷取時序資料的生命週期，單位為秒。值為 `-1` 時，表示資料永不到期。

時間軸中繼資料配置

timeseriesTableMeta.timeseriesMetaOptions 的類型為 TimeseriesMetaOptions，包含以下欄位。

欄位	類型	說明
`metaTimeToLive`	`int`	通過 `getMetaTimeToLive()` 擷取時間軸中繼資料的生命週期，單位為秒。值為 `-1` 時，表示時間軸中繼資料永不到期。
`allowUpdateAttributes`	`boolean`	通過 `getAllowUpdateAttributes()` 擷取是否允許更新時間軸中繼資料的屬性列。

資料欄位主鍵

timeseriesTableMeta.fieldPrimaryKeys[] 中每個元素的類型為 PrimaryKeySchema，包含以下欄位。

欄位	類型	說明
`name`	`String`	通過 `getName()` 擷取資料欄位名稱。
`type`	`PrimaryKeyType`	通過 `getType()` 擷取資料欄位類型，取值為 `INTEGER` 或 `STRING`。

分析儲存

analyticalStores[] 中每個元素的類型為 TimeseriesAnalyticalStore，包含以下欄位。

欄位	類型	說明
`analyticalStoreName`	`String`	通過 `getAnalyticalStoreName()` 擷取分析儲存名稱。
`timeToLive`	`int`	通過 `getTimeToLive()` 擷取分析儲存中資料的生命週期，單位為秒。值為 `-1` 時，表示資料永不到期。
`syncOption`	`AnalyticalStoreSyncType`	通過 `getSyncOption()` 擷取資料同步方式。

Lastpoint 索引

lastpointIndexes[] 中每個元素的類型為 TimeseriesLastpointIndex，包含以下欄位。

欄位	類型	說明
`lastpointIndexName`	`String`	通過 `getLastpointIndexName()` 擷取 Lastpoint 索引名稱。