Todos os produtos
Search
Central de documentação

Tablestore:TableInBatchGetRowRequest

Última atualização: Jul 03, 2026

Defina a configuração para leitura de dados de uma única tabela na operação BatchGetRow.

Estrutura de dados

message TableInBatchGetRowRequest {
    required string table_name = 1;
    repeated bytes primary_key = 2; // Encoded using Plainbuffer.
    repeated bytes token = 3;
    repeated string columns_to_get = 4;  // If not specified, all columns are read.
    optional TimeRange time_range = 5;
    optional int32 max_versions = 6;
    optional bytes filter = 8;
    optional string start_column = 9;
    optional string end_column = 10;
}

Nome

Tipo

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de dados.

primary_key

bytes

Sim

Colunas de chave primária da linha especificada, incluindo nomes e valores. As colunas usam codificação Plainbuffer. Para mais informações, consulte Plainbuffer.

token

bytes

Não

Posição inicial da próxima leitura em uma linha ampla. Este parâmetro não está disponível atualmente.

columns_to_get

string

Não

Nomes das colunas a retornar. Se não especificado, o sistema retorna todas as colunas.

time_range

TimeRange

Especifique este parâmetro ou max_versions.

Intervalo de versões ou versão específica para leitura. Os timestamps estão em milissegundos e devem estar no intervalo [0, INT64.MAX].

  • Para ler dados dentro de um intervalo de versões, defina start_time e end_time. O intervalo é semiaberto: [start_time, end_time).

  • Para ler uma versão específica, defina specific_time.

max_versions

int32

Especifique este parâmetro ou time_range.

Número máximo de versões a retornar por coluna. Por exemplo, se definido como 2, o sistema retorna no máximo duas versões para cada coluna.

filter

bytes

Não

Condição de filtro. Representa a forma serializada em binário de um objeto Filter codificado com protobuf.

start_column

string

Não

Coluna inicial da operação de leitura, usada principalmente para linhas amplas. As colunas seguem ordem lexicográfica por nome, e o resultado inclui a coluna inicial.

Por exemplo, se uma tabela tiver as colunas a, b e c, e você definir start_column como b, o sistema retorna as colunas b e c.

end_column

string

Não

Coluna final da operação de leitura, usada principalmente para linhas amplas. As colunas seguem ordem lexicográfica por nome, e o resultado exclui a coluna final.

Por exemplo, se uma tabela tiver as colunas a, b e c, e você definir end_column como b, o sistema retorna apenas a coluna a.

Operações relacionadas

BatchGetRow