Tous les produits
Search
Centre de documentation

Tablestore:TableInBatchGetRowRequest

Dernière mise à jour :Aug 18, 2026

Spécifie la configuration de lecture des données d'une seule table lors d'une opération BatchGetRow.

Structure des données

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

Nom

Type

Obligatoire

Description

table_name

string

Oui

Nom de la table de données.

primary_key

bytes

Oui

Colonnes de clé primaire de la ligne spécifiée, incluant leurs noms et valeurs. L'encodage utilise Plainbuffer. Pour plus d'informations, consultez Plainbuffer.

token

bytes

Non

Position de départ pour la prochaine lecture lors d'une lecture de ligne étendue. Ce paramètre n'est pas encore disponible.

columns_to_get

string

Non

Noms des colonnes à renvoyer. Si ce paramètre est omis, toutes les colonnes sont renvoyées.

time_range

TimeRange

Ce paramètre ou max_versions est obligatoire.

Plage de versions ou version spécifique à lire. Les horodatages sont exprimés en millisecondes et doivent se situer dans la plage [0, INT64.MAX].

  • Pour lire les données dans une plage de versions, définissez start_time et end_time. La plage est semi-ouverte : [start_time, end_time).

  • Pour lire une version spécifique, définissez specific_time.

max_versions

int32

Ce paramètre ou time_range est obligatoire.

Nombre maximal de versions à renvoyer par colonne. Par exemple, avec la valeur 2, au maximum deux versions sont renvoyées pour chaque colonne.

filter

bytes

Non

Condition de filtrage. Il s'agit de la forme sérialisée binaire d'un objet Filter encodé via protobuf.

start_column

string

Non

Colonne de départ pour l'opération de lecture, utilisée principalement pour les lectures de lignes étendues. Les colonnes sont triées par ordre lexicographique selon leur nom et le résultat inclut la colonne de départ.

Par exemple, si une table possède les colonnes a, b et c, et que vous définissez start_column sur b, les colonnes b et c sont renvoyées.

end_column

string

Non

Colonne de fin pour l'opération de lecture, utilisée principalement pour les lectures de lignes étendues. Les colonnes sont triées par ordre lexicographique selon leur nom et le résultat exclut la colonne de fin.

Par exemple, si une table possède les colonnes a, b et c, et que vous définissez end_column sur b, seule la colonne a est renvoyée.

Opérations connexes

BatchGetRow