TableInBatchGetRowRequest indicates the request information of the table to be read in the BatchGetRow operation.

Data structure

message TableInBatchGetRowRequest {
    required string table_name = 1;
    repeated bytes primary_key = 2; // Plainbuffer encoding
    repeated bytes token = 3;
    repeated string columns_to_get = 4;  // If it is not specified, all columns are read
    optional TimeRange time_range = 5;
    optional int32 max_versions = 6;
    optional bool cache_blocks = 7 [default = true]; // Whether the read data enters the BlockCache
    optional bytes filter = 8;
    optional string start_column = 9;
    optional string end_column = 10;
}
table_name:

  • Type: String

  • The name of the table.

primary_key:

  • Type: Repeated bytes

  • Required parameter: Yes

  • All primary key columns in the row, including the primary key names and values. The primary key columns are encoded in Plainbuffer format. For more information, see Plainbuffer encoding.

token:

  • Type: Repeated bytes

  • Required parameter: No

  • It specifies the starting position of a wide row to be read next time, which is unavailable currently.

columns_to_get:

  • Type: Repeated string

  • The names of all columns to be returned from this table.

time_range:

  • Type: TimeRange

  • Required parameter: Either time_range or max_versions must exist, or both.

  • The range of time stamps to read versions of data.

  • The time stamp is in the unit of millisecond. The minimum and maximum values of the time stamp is 0 and INT64. MAX, respectively.

  • To query data of a time range, specify start_time and end_time.

  • To query data of a specific time stamp, specify specific_time.

  • Example: If the value of time_range is (100, 200), the time stamp of the returned column data must be within [100, 200).

max_versions:

  • Type: int32

  • Required parameter: Either of max_versions and time_range must exist at least.

  • The maximum number of versions of data to be returned.

  • Example: If the value of max_versions is 2, data of a maximum of two versions is returned for each column.

cache_blocks:

  • Type: Bool

  • Required parameter: No

  • Whether the read data enters the BlockCache.

  • The default value is true.

  • This parameter cannot be set to false currently.

filter:

  • Type: Bytes

  • Required parameter: No

  • The filtering condition expression.

  • It indicates the binary data after the Filter is serialized in Protobuf format.

start_column:

  • Type: String

  • Required parameter: No

  • The starting column to be read, which is used for reading a wide row.

  • The returned results contain the current starting column.

  • The column names are sorted lexicographically.

  • Example: If a table contains columns “a”, “b”, and “c” and the value of start_column is “b”, the reading starts from column “b”, and columns “b” and “c” are returned.

end_column:

  • Type: String

  • Required parameter: No

  • The ending column to be read, which is used for reading a wide row.

  • The returned results do not contain the current ending column.

  • The column names are sorted lexicographically.

  • Example: If a table contains columns “a”, “b”, and “c” and the value of end_column is “b”, the reading ends at column “b”, and column “a” is returned.

Related operations

BatchGetRow