Todos los productos
Search
Centro de documentos

Tablestore:TableInBatchGetRowRequest

Última actualización: Sep 29, 2026

Especifica la configuración para leer datos de una sola tabla en una operación BatchGetRow.

Estructura de datos

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;
}

Nombre

Tipo

Obligatorio

Descripción

table_name

string

Sí

El nombre de la tabla de datos.

primary_key

bytes

Sí

Las columnas de clave principal de la fila especificada, incluidos sus nombres y valores. Estas columnas se codifican mediante Plainbuffer. Para obtener más información, consulte Plainbuffer.

token

bytes

No

La posición inicial para la siguiente lectura en una lectura de filas anchas. Este parámetro no está disponible actualmente.

columns_to_get

string

No

Los nombres de las columnas que se devolverán. Si no se especifica este parámetro, se devuelven todas las columnas.

time_range

TimeRange

Debe especificar este parámetro o max_versions.

El rango de versiones o la versión específica que se leerá. Las marcas de tiempo se expresan en milisegundos y deben estar dentro del rango [0, INT64.MAX].

  • Para leer datos dentro de un rango de versiones, establezca start_time y end_time. El rango es semiabierto: [start_time, end_time).

  • Para leer una versión específica, establezca specific_time.

max_versions

int32

Debe especificar este parámetro o time_range.

El número máximo de versiones que se devolverán por columna. Por ejemplo, si establece el valor en 2, se devolverán como máximo dos versiones por cada columna.

filter

bytes

No

La condición de filtro. Corresponde a la forma serializada en binario de un objeto Filter codificado con protobuf.

start_column

string

No

La columna inicial de la operación de lectura. Se utiliza principalmente en lecturas de filas anchas. Las columnas se ordenan lexicográficamente por nombre y el resultado incluye la columna inicial.

Por ejemplo, si una tabla tiene las columnas a, b y c, y usted establece start_column en b, se devolverán las columnas b y c.

end_column

string

No

La columna final de la operación de lectura. Se utiliza principalmente en lecturas de filas anchas. Las columnas se ordenan lexicográficamente por nombre y el resultado excluye la columna final.

Por ejemplo, si una tabla tiene las columnas a, b y c, y usted establece end_column en b, solo se devolverá la columna a.

Operaciones relacionadas

BatchGetRow