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 |
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].
|
|
|
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. |