All Products
Search
Document Center

Tablestore:Membaca satu baris data

Last Updated:May 12, 2026

Topik ini menjelaskan cara membaca satu baris data dari tabel Tablestore menggunakan .NET SDK.

Usage notes

Saat membaca data, Anda harus menyediakan nilai kunci primer lengkap, termasuk nilai kolom kunci utama auto-increment jika tersedia.

Prerequisites

Initialize the Tablestore client

Method

public GetRowResponse GetRow(GetRowRequest request)

Metode asinkron:

public Task<GetRowResponse> GetRowAsync(GetRowRequest request)

Parameter GetRowRequest

Parameter

Type

Description

tableName (Required)

string

Nama tabel data.

primaryKey (Required)

PrimaryKey

Informasi kunci primer, mencakup nama dan nilai kolom kunci primer.

  • Tipe data yang didukung untuk kolom kunci primer meliputi STRING, INTEGER, dan BINARY.

  • Jumlah dan tipe kolom kunci primer harus sama dengan yang telah didefinisikan pada tabel data.

maxVersion (Optional)

int

Jumlah maksimum versi yang dikembalikan. Nilai default: 1.

  • Anda tidak dapat mengatur maxVersion dan timeRange secara bersamaan.

  • Jika jumlah versi data yang memenuhi kondisi kueri melebihi jumlah maksimum versi yang ditentukan, hasil yang dikembalikan hanya berisi jumlah versi tersebut, diurutkan dari terbaru ke terlama.

timeRange (Optional)

TimeRange

Rentang versi data.

  • Anda tidak dapat mengatur maxVersion dan timeRange secara bersamaan.

  • Setiap kolom atribut dalam tabel data Tablestore dapat memiliki beberapa versi data. Jika Anda menentukan rentang versi, metode ini hanya mengembalikan data dalam rentang tersebut.

columnsToGet (Optional)

HashSet<string>

Kolom data yang akan dibaca. Kolom tersebut dapat berupa kolom kunci primer atau kolom atribut.

  • Jika Anda tidak menentukan columnsToGet, metode ini mengembalikan seluruh baris.

  • Jika Anda menentukan columnsToGet dan baris tersebut tidak berisi salah satu kolom data yang ditentukan, operasi ini mengembalikan null.

condition (Optional)

IColumnCondition

Kondisi filter. Untuk informasi lebih lanjut, lihat Filter.

  • Jika Anda mengatur columnsToGet dan condition secara bersamaan, sistem terlebih dahulu menerapkan condition untuk memfilter data. Jika kondisi terpenuhi, metode ini hanya mengembalikan data dari kolom yang ditentukan dalam columnsToGet.

Code example

Contoh berikut membaca satu baris dengan nilai kunci primer 'row1'.

try
{
    // Construct the primary key.
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };

    // Call the GetRow method to read the row.
    GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey);
    GetRowResponse getRowResponse = client.GetRow(getRowRequest);

    Console.WriteLine($"RequestId: {getRowResponse.RequestID}");
    Console.WriteLine($"Read CU Cost: {getRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"Write CU Cost: {getRowResponse.ConsumedCapacityUnit.Write}");
    Console.WriteLine($"Row Data: {getRowResponse.Row}");
}
catch (Exception ex)
{
    Console.WriteLine($"Get row failed, exception: {ex.Message}");
}
  • Tentukan rentang versi untuk data yang akan dibaca. Metode ini hanya mengembalikan data dalam rentang versi yang ditentukan.

    TimeRange timeRange = new TimeRange
    {
        StartTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - 86400 * 1000,
        EndTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()
    };
    
    // Call the GetRow method to read the row.
    GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, null, null, timeRange);
  • Tentukan kolom atribut yang akan dibaca.

    HashSet<string> columnsToGet = new HashSet<string> { "col2" };
    
    // Call the GetRow method to read the row.
    GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, columnsToGet);