Tüm Ürünler
Search
Belge Merkezi

Tablestore:TableInBatchGetRowRequest

Son Güncelleme:Oct 02, 2026

Bir BatchGetRow işlemi kapsamında tek bir tablodan veri okumak için gereken yapılandırmayı belirtir.

Veri yapısı

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

Name

Type

Required

Description

table_name

string

Yes

Veri tablosunun adı.

primary_key

bytes

Yes

Belirtilen satırın birincil anahtar sütunları (adlar ve değerler dahil). Sütunlar Plainbuffer kullanılarak kodlanır. Daha fazla bilgi için bkz. Plainbuffer.

token

bytes

No

Geniş satır okuma işleminde sonraki okumanın başlangıç konumu. Bu parametre şu anda kullanılamamaktadır.

columns_to_get

string

No

Döndürülecek sütunların adları. Belirtilmezse tüm sütunlar döndürülür.

time_range

TimeRange

Bu parametre veya max_versions belirtilmelidir.

Okunacak sürüm aralığı veya belirli sürüm. Zaman damgaları milisaniye cinsindendir ve [0, INT64.MAX] aralığında olmalıdır.

  • Bir sürüm aralığındaki verileri okumak için start_time ve end_time değerlerini ayarlayın. Aralık yarı açıktır: [start_time, end_time).

  • Belirli bir sürümü okumak için specific_time değerini ayarlayın.

max_versions

int32

Bu parametre veya time_range belirtilmelidir.

Sütun başına döndürülecek maksimum sürüm sayısı. Örneğin, bu değer 2 olarak ayarlanırsa her sütun için en fazla iki sürüm döndürülür.

filter

bytes

No

Filtre koşulu. Bu, protobuf kullanılarak kodlanmış bir Filter nesnesinin ikili serileştirilmiş halidir.

start_column

string

No

Okuma işlemi için başlangıç sütunu; öncelikle geniş satır okumalarında kullanılır. Sütunlar ada göre sözlük sırasına göre sıralanır ve sonuç başlangıç sütununu içerir.

Örneğin, bir tabloda a, b ve c sütunları varsa ve start_column değerini b olarak ayarlarsanız b ve c sütunları döndürülür.

end_column

string

No

Okuma işlemi için bitiş sütunu; öncelikle geniş satır okumalarında kullanılır. Sütunlar ada göre sözlük sırasına göre sıralanır ve sonuç bitiş sütununu içermez.

Örneğin, bir tabloda a, b ve c sütunları varsa ve end_column değerini b olarak ayarlarsanız yalnızca a sütunu döndürülür.

İlgili işlemler

BatchGetRow