すべてのプロダクト
Search
ドキュメントセンター

Tablestore:テーブル情報のクエリ

最終更新日:Jul 23, 2026

Tablestore SDK for Java は、テーブルのスキーマ、設定、ストリームステータス、暗号化設定、予約済みスループット、セカンダリインデックスメタデータを取得します。

前提条件

Tablestore SDK for Java をインストールし、クライアントを初期化します。

機能の説明

public DescribeTableResponse describeTable(DescribeTableRequest request) throws TableStoreException, ClientException

describeTable() は、指定されたテーブルに関する情報を含む DescribeTableResponse を返します。

次の例では、example_table にクエリを実行し、レスポンスの主なフィールドを出力します。

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

System.out.println("テーブルメタデータ: " + response.getTableMeta());
System.out.println("テーブルオプション: " + response.getTableOptions());
System.out.println("ストリーム詳細: " + response.getStreamDetails());
SSEDetails sseDetails = response.getSseDetails();
System.out.println("暗号化有効: " + sseDetails.isEnable());
if (sseDetails.isEnable()) {
    System.out.println("暗号化タイプ: " + sseDetails.getKeyType());
}
System.out.println("予約済みスループット: " + response.getReservedThroughputDetails());
System.out.println("セカンダリインデックス: " + response.getIndexMeta());
System.out.println("パーティション分割ポイント: " + response.getShardSplits());
System.out.println("作成時間: " + response.getCreationTime());

パラメーター

DescribeTableRequest には、次のパラメーターが含まれます。

  • tableName (必須) String :テーブルの名前。

レスポンス

DescribeTableResponse には以下の情報が含まれます。

フィールド

タイプ

説明

tableMeta

TableMeta

getTableMeta() を呼び出して、テーブル名、プライマリキー列、事前定義列、テーブル ID を含むテーブルスキーマを取得します。

reservedThroughputDetails

ReservedThroughputDetails

getReservedThroughputDetails() を呼び出して、現在の予約済みスループットと、直近の増加および減少の時刻を取得します。

tableOptions

TableOptions

getTableOptions() を呼び出して、Time To Live (TTL)、最大バージョン数、最大時間偏差、更新の可否、更新時に行全体を含める必要があるかどうかなどのテーブル設定を取得します。

shardSplits

List<PrimaryKey>

テーブルシャード間の分割点を取得するには、getShardSplits()を呼び出します。

streamDetails

StreamDetails

getStreamDetails() を呼び出して、Stream が有効かどうか、Stream ID、有効期限、Stream が最後に有効になった日時、元の列などの Stream の設定を取得します。

sseDetails

SSEDetails

getSseDetails() を呼び出して、暗号化が有効かどうか、キータイプ、キー ID、および RAM ロール ARN を含むサーバーサイド暗号化設定を取得します。

indexMeta

List<IndexMeta>

getIndexMeta() を呼び出して、インデックス名、プライマリキー列、事前定義列、インデックスタイプ、更新モード、同期フェーズを含むセカンダリインデックスのメタデータを取得します。

creationTime

long

getCreationTime() を呼び出して、テーブルの作成時刻をマイクロ秒単位で取得します。