Table Store Java SDK 列出時序表 - Tablestore

使用 Java SDK 列出當前執行個體中的所有時序表，並擷取各表的名稱、配置和狀態。

前提條件

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

功能說明

調用 listTimeseriesTable 方法列出當前執行個體中的所有時序表。

public ListTimeseriesTableResponse listTimeseriesTable()

以下樣本列出執行個體中的時序表，並輸出每張表的名稱、狀態和時序資料生命週期。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

ListTimeseriesTableResponse response =
        timeseriesClient.listTimeseriesTable();

for (TimeseriesTableMeta tableMeta : response.getTimeseriesTableMetas()) {
    System.out.println(tableMeta.getTimeseriesTableName());
    System.out.println(tableMeta.getStatus());
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive());
}

參數說明

listTimeseriesTable 方法不接收請求參數。

傳回值

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

欄位	類型	說明
`timeseriesTableMetas`	`List<TimeseriesTableMeta>`	通過 `getTimeseriesTableMetas()` 擷取時序表列表。只需表名時，可通過 `getTimeseriesTableNames()` 擷取名稱列表。

時序表資訊

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

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

時序資料配置

timeseriesTableMetas[].timeseriesTableOptions 的類型為 TimeseriesTableOptions，包含以下欄位。

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

時間軸中繼資料配置

timeseriesTableMetas[].timeseriesMetaOptions 的類型為 TimeseriesMetaOptions，包含以下欄位。

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

資料欄位主鍵

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

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