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

Tablestore:GetStreamRecord

最終更新日:Dec 28, 2024

シャードの増分データをクエリします。

リクエスト構文

message GetStreamRecordRequest {
    required string shard_iterator = 1; // シャードの増分データを読み取るために使用されるイテレータ。
    optional int32 limit = 2; // 返されるデータレコードの最大数。
    optional string table_name = 3; // データテーブルの名前。
}

パラメーター

必須

説明

shard_iterator

string

はい

シャードの増分データを読み取るために使用されるイテレータ。

limit

int32

いいえ

返されるデータレコードの最大数。

table_name

string

いいえ

データテーブルの名前。

レスポンス構文

message GetStreamRecordResponse {
    repeated StreamRecord stream_records = 1; // 現在のシャードからデータを読み取るために使用されるレコードエントリ。
    optional raw_string next_shard_iterator = 2; // 次の GetStreamRecord リクエストで現在のシャードからデータを読み取るために使用されるイテレータ。
    optional ConsumedCapacity consumed = 3; // ストリームデータの読み取りに消費される容量ユニット (CU) の数は、次の式を使用して計算された値から切り上げられます。消費された読み取り CU の数 = 読み取られたすべての行のデータの合計サイズ/4 KB。実際に読み取られたすべての行のデータの合計サイズの計算方法については、ストレージの使用量を参照してください。
    optional bool may_more_record = 4; // 読み取ることができるレコードがさらに存在するかどうかを示します。このパラメーターは、クライアントがさらなるデータの読み取りまたは処理の決定を行うのに役立つ情報を提供します。
}

パラメーター

説明

StreamRecord

repeated StreamRecord

現在のシャードからデータを読み取るために使用されるレコードエントリ。

next_shard_iterator

string

次の GetStreamRecord リクエストで現在のシャードからデータを読み取るために使用されるイテレータ。

consumed

ConsumedCapacity

ストリームデータの読み取りに消費される容量ユニット (CU) の数は、次の式を使用して計算された値から切り上げられます。消費された読み取り CU の数 = 読み取られたすべての行のデータの合計サイズ/4 KB。実際に読み取られたすべての行のデータの合計サイズの計算方法については、ストレージの使用量 を参照してください。

may_more_record

bool

読み取ることができるレコードがさらに存在するかどうかを示します。このパラメーターは、クライアントがさらなるデータの読み取りまたは処理の決定を行うのに役立つ情報を提供します。

Tablestore SDK の使用

Java 用 Tablestore SDK: GetStreamRecord