表格存儲提供了ListStream和DescribeStream接口用于查看表的Stream信息,以及GetShardIterator和GetStreamRecord接口用于獲取Stream下Shard的起始迭代值和更新信息。
列出所有的Stream(ListStream)
調用ListStream接口列出當前實例和表下的所有Stream信息。
以下示例用于列出某個表的所有Stream信息。
private static void listStream(SyncClient client, String tableName) {
ListStreamRequest listStreamRequest = new ListStreamRequest(tableName);
ListStreamResponse result = client.listStream(listStreamRequest);
System.out.println(result.getStreams());
}
查詢表Stream描述信息(DescribeStream)
調用DescribeStream接口查詢Stream的創建時間(creationTime)、過期時間(expirationTime)、當前的狀態(status) 、包含shard的列表(shards)和下一個起始shard的id(如果還有尚未返回的shard)。
您可以獲取當前Stream的所有Shard信息或者根據指定條件獲取滿足指定條件的Shard信息。
獲取Stream的所有Shard信息
以下示例用于獲取當前Stream的所有Shard信息。
private static void describeStream(SyncClient client, String streamId) {
DescribeStreamRequest desRequest = new DescribeStreamRequest(streamId);
DescribeStreamResponse desStream = client.describeStream(desRequest);
// 打印Shard信息。
System.out.println("Shard Info: " + desStream.getShards());
// 打印創建時間,單位為微秒。
System.out.println("Creation Time: " + desStream.getCreationTime());
// 打印過期時間,單位為小時。
System.out.println("Expiration Time: " + desStream.getExpirationTime());
}
獲取Stream下滿足指定條件的Shard信息
以下示例用于根據開始shardID(InclusiveStartShardId)和每次返回的最大Shard數目獲取指定Shard信息。
private static void describeStream(SyncClient client, String streamId, String shardId) {
DescribeStreamRequest dsRequest = new DescribeStreamRequest(streamId);
// Shard ID必須實際存在。您可以通過獲取Stream下的所有Shard信息來獲取所需起始Shard ID。
dsRequest.setInclusiveStartShardId(shardId);
dsRequest.setShardLimit(10);
DescribeStreamResponse dscStream = client.describeStream(dsRequest);
// 打印Shard信息。
System.out.println(dscStream.getShards());
}
獲取Shard的讀取迭代值(GetShardIterator)
調用GetShardIterator接口用于獲取Shard的讀取起始迭代值。
以下示例用于獲取Shard的讀取起始迭代值。
private static void getShardIterator(SyncClient client, String streamId, String shardId) {
GetShardIteratorRequest getShardIteratorRequest = new GetShardIteratorRequest(streamId, shardId);
GetShardIteratorResponse shardIterator = client.getShardIterator(getShardIteratorRequest);
System.out.println(shardIterator.getShardIterator());
}
獲取Shard的更新記錄(GetStreamRecord)
調用GetStreamRecord接口用于獲取Shard的每條更新記錄。
以下示例用于獲取Shard的最初100條更新信息。
private static void getShardIterator(SyncClient client, String shardIterator) {
GetStreamRecordRequest streamRecordRequest = new GetStreamRecordRequest(shardIterator);
streamRecordRequest.setLimit(100);
GetStreamRecordResponse streamRecordResponse = client.getStreamRecord(streamRecordRequest);
List<StreamRecord> records = streamRecordResponse.getRecords();
for(int k=0;k<records.size();k++){
System.out.println("record info:" + records.get(k).toString());
}
System.out.println("next iterator:" + streamRecordResponse.getNextShardIterator());
}
文檔內容是否對您有幫助?