Membaca satu baris - Tablestore SDK untuk Go - Tablestore

Gunakan Tablestore SDK untuk Go untuk membaca satu baris dari tabel model Kolom Lebar dengan menentukan kunci utamanya secara lengkap.

Prasyarat

Pasang Tablestore SDK untuk Go dan inisialisasi klien.

Deskripsi

Panggil GetRow untuk membaca satu baris dengan menentukan kunci utamanya secara lengkap. Anda dapat membatasi kolom atribut yang dikembalikan, versi data, rentang waktu versi, atau menggunakan filter untuk menyaring kolom atribut.

func (tableStoreClient *TableStoreClient) GetRow(request *GetRowRequest) (*GetRowResponse, error)

Contoh berikut membaca baris dengan nilai kunci utama row1 dari tabel example_table.

primaryKey := &tablestore.PrimaryKey{}
primaryKey.AddPrimaryKeyColumn("id", "row1")

request := &tablestore.GetRowRequest{
    SingleRowQueryCriteria: &tablestore.SingleRowQueryCriteria{
        TableName:  "example_table",
        PrimaryKey: primaryKey,
        MaxVersion: 1,
    },
}

response, err := client.GetRow(request)
if err != nil {
    log.Fatal(err)
}

fmt.Println(response.PrimaryKey)
fmt.Println(response.Columns)

Parameter

GetRowRequest mencakup parameter berikut.

Name	Type	Description
SingleRowQueryCriteria (required)	`*SingleRowQueryCriteria`	Kriteria kueri baris.

Kriteria kueri baris

SingleRowQueryCriteria mencakup parameter berikut.

Name	Type	Description
TableName (required)	`string`	Nama tabel.
PrimaryKey (required)	`*PrimaryKey`	Kunci utama lengkap dari baris tersebut. Untuk membaca baris yang berisi kolom kunci utama auto-increment, tentukan juga nilai auto-increment aktualnya.
MaxVersion (optional)	`int32`	Jumlah maksimum versi yang akan dikembalikan. Setidaknya salah satu dari `MaxVersion` dan `TimeRange` wajib ditentukan.
TimeRange (optional)	`*TimeRange`	Rentang waktu versi, yang menentukan waktu mulai, waktu akhir, atau versi eksak dalam milidetik. Setidaknya salah satu dari `MaxVersion` dan `TimeRange` wajib ditentukan.
ColumnsToGet (optional)	`[]string`	Kolom atribut yang akan dikembalikan. Jika parameter ini tidak ditentukan, semua kolom atribut akan dikembalikan. Jika `ColumnsToGet` dan `Filter` keduanya ditentukan, Tablestore terlebih dahulu memilih kolom yang ditentukan oleh `ColumnsToGet`, lalu menerapkan `Filter` pada kolom yang dipilih tersebut. Jika `Filter` mereferensikan kolom yang tidak termasuk dalam `ColumnsToGet`, kolom tersebut dianggap tidak ada. Apakah baris tersebut difilter atau tidak ditentukan oleh `FilterIfMissing`.
Filter (optional)	`ColumnFilter`	Filter kolom atribut. Untuk informasi selengkapnya, lihat Use filters.
StartColumn (optional)	`*string`	Kolom atribut awal dari rentang nama. Kolom ini disertakan dalam hasil.
EndColumn (optional)	`*string`	Kolom atribut akhir dari rentang nama. Kolom ini tidak disertakan dalam hasil.
TransactionId (optional)	`*string`	ID transaksi lokal. Tentukan parameter ini hanya untuk pembacaan dalam transaksi lokal. Untuk informasi selengkapnya, lihat Use local transactions.

Respons

GetRowResponse berisi informasi bisnis berikut. Jika baris tersebut tidak ada, respons tidak menyertakan kunci utama maupun kolom atribut.

Field	Type	Description
`PrimaryKey`	`PrimaryKey`	Kunci utama dari baris tersebut.
`Columns`	`[]*AttributeColumn`	Kolom atribut yang dikembalikan, beserta nilai dan versinya.

Contoh

Membaca versi data dalam rentang waktu tertentu

Contoh berikut membaca versi data yang dihasilkan dalam satu hari terakhir.

now := time.Now().UnixMilli()
request.SingleRowQueryCriteria.MaxVersion = 0
request.SingleRowQueryCriteria.TimeRange = &tablestore.TimeRange{
    Start: now - 24*60*60*1000,
    End:   now,
}