全部產品
Search
文件中心

Tablestore:查詢表資訊

更新時間:Aug 05, 2026

Java SDK 可查詢資料表的表結構、表配置、Stream、加密、預留讀寫輸送量和二級索引資訊。

前提條件

安裝Tablestore Java SDK並初始化用戶端。

功能說明

調用 describeTable 查詢指定資料表的表結構、表配置、Stream、服務端加密、預留讀寫輸送量和二級索引等資訊。

public DescribeTableResponse describeTable(DescribeTableRequest request) throws TableStoreException, ClientException

以下樣本查詢 example_table 的表資訊並輸出主要返回內容。

DescribeTableRequest request = new DescribeTableRequest("example_table");
DescribeTableResponse response = client.describeTable(request);

System.out.println("Table metadata: " + response.getTableMeta());
System.out.println("Table options: " + response.getTableOptions());
System.out.println("Stream details: " + response.getStreamDetails());
SSEDetails sseDetails = response.getSseDetails();
System.out.println("Encryption enabled: " + sseDetails.isEnable());
if (sseDetails.isEnable()) {
    System.out.println("Encryption type: " + sseDetails.getKeyType());
}
System.out.println("Reserved throughput: " + response.getReservedThroughputDetails());
System.out.println("Secondary indexes: " + response.getIndexMeta());
System.out.println("Partition split points: " + response.getShardSplits());
System.out.println("Creation time: " + response.getCreationTime());

參數說明

DescribeTableRequest 包含以下參數。

名稱

類型

說明

tableName(必選)

String

資料表名稱。

傳回值

DescribeTableResponse 包含以下返回資訊。

欄位

類型

說明

tableMeta

TableMeta

通過 getTableMeta() 擷取資料表結構,包括資料表名稱、主鍵列、預定義列和表 ID 等資訊。

reservedThroughputDetails

ReservedThroughputDetails

通過 getReservedThroughputDetails() 擷取當前預留讀寫輸送量,以及最近一次上調和下調的時間。

tableOptions

TableOptions

通過 getTableOptions() 擷取表配置,包括資料生命週期、最大版本數、有效版本偏差、是否允許更新和是否整行更新。

shardSplits

List<PrimaryKey>

通過 getShardSplits() 擷取資料分區之間的分割點。

streamDetails

StreamDetails

通過 getStreamDetails() 擷取 Stream 配置,包括啟用狀態、Stream ID、到期時間、最近啟用時間和原始列。

sseDetails

SSEDetails

通過 getSseDetails() 擷取服務端加密配置,包括啟用狀態、密鑰類型、金鑰識別碼 和 RAM 角色 ARN。

indexMeta

List<IndexMeta>

通過 getIndexMeta() 擷取二級索引資訊,包括索引名稱、主鍵列、預定義列、索引類型、更新模式和同步階段。

creationTime

long

通過 getCreationTime() 擷取資料表建立時間,單位為微秒。