Gunakan filter - Tablestore SDK for Go - Tablestore - Alibaba Cloud Documentation Center

Gunakan Tablestore SDK for Go untuk memfilter baris atau membatasi kolom atribut yang dikembalikan di sisi server saat membaca data model Kolom Lebar.

Prasyarat

Instal Tablestore SDK for Go dan inisialisasi klien.

Deskripsi

Filter menyaring hasil pembacaan di sisi server namun tidak mengurangi CU baca yang dikonsumsi. Anda dapat menentukan filter dalam kriteria kueri GetRow, GetRange, atau BatchGetRow. Tablestore SDK for Go mendukung jenis filter berikut:

Filter nilai kolom tunggal (SingleColumnCondition): mengevaluasi nilai kolom atribut.
Filter regex nilai kolom tunggal (SingleColumnValueRegexFilter): mengekstraksi substring dari kolom atribut bertipe STRING, mengonversi substring tersebut, lalu membandingkan hasilnya.
Filter komposit (CompositeColumnCondition): menggabungkan beberapa filter menggunakan AND, OR, atau NOT. Filter komposit dapat berisi hingga 32 kondisi.
Filter paginasi kolom (PaginationFilter): mengembalikan kolom atribut berdasarkan offset dan jumlah tanpa mengevaluasi nilai kolom.

Contoh berikut menggunakan filter nilai kolom tunggal untuk hanya mengembalikan baris dengan score >= 60.

filter := tablestore.NewSingleColumnCondition(
    "score",
    tablestore.CT_GREATER_EQUAL,
    int64(60),
)

request.RangeRowQueryCriteria.Filter = filter
response, err := client.GetRange(request)
if err != nil {
    log.Fatal(err)
}
fmt.Println(response.Rows)

Parameter

Filter nilai kolom tunggal

Panggil NewSingleColumnCondition(columnName, comparator, value) untuk membuat filter nilai kolom tunggal. SingleColumnCondition memiliki parameter berikut.

Nama	Tipe	Deskripsi
ColumnName (wajib)	`*string`	Kolom atribut yang akan dievaluasi.
Comparator (wajib)	`*ComparatorType`	Operator perbandingan. Nilai yang valid: `CT_EQUAL`, `CT_NOT_EQUAL`, `CT_GREATER_THAN`, `CT_GREATER_EQUAL`, `CT_LESS_THAN`, dan `CT_LESS_EQUAL`.
ColumnValue (wajib)	`interface{}`	Nilai yang digunakan untuk perbandingan.
FilterIfMissing (opsional)	`bool`	Menentukan apakah baris harus difilter jika kolom tidak tersedia. Nilai default: `false`, yang berarti baris tetap dikembalikan.
LatestVersionOnly (opsional)	`bool`	Menentukan apakah hanya versi terbaru yang dievaluasi. Nilai default: `false`, yang berarti baris dikembalikan jika ada versi apa pun yang memenuhi kondisi.

Filter regex nilai kolom tunggal

Panggil NewSingleColumnValueRegexFilter(columnName, comparator, rule, value) untuk membuat filter regex. Hanya kolom atribut bertipe STRING yang mendukung filter regex.

Selain parameter filter nilai kolom tunggal, tentukan ValueTransferRule dengan parameter berikut.

Nama

Tipe

Deskripsi

Regex (wajib)

string

Ekspresi reguler yang digunakan untuk mengekstraksi substring. Panjang maksimum: 256 byte.

Didukung Perl Compatible Regular Expressions (PCRE) dan ekspresi reguler satu byte.
Pola regex tidak boleh mengandung karakter Tionghoa.
Grup penangkapan didukung. Jika regex mengandung grup penangkapan, substring yang ditangkap oleh grup pertama yang digunakan. Misalnya, jika nilai kolom atribut adalah 1aaa51bbb5 dan regex-nya adalah 1([a-z]+)5, substring yang diekstraksi adalah aaa.

Cast_type (wajib)

VariantType

Tipe tujuan konversi substring yang diekstraksi. Nilai yang valid: Variant_INTEGER, Variant_DOUBLE, dan Variant_STRING.

Filter komposit

Panggil NewCompositeColumnCondition(lo) untuk membuat filter komposit, lalu panggil AddFilter untuk menambahkan subfilter.

Nama

Tipe

Deskripsi

Operator (wajib)

LogicalOperator

Operator logika. Nilai yang valid: LO_NOT, LO_AND, dan LO_OR.

Filters (wajib)

[]ColumnFilter

Subfilter yang akan digabungkan. Jenis berikut didukung:

Filter nilai kolom tunggal yang dibuat menggunakan NewSingleColumnCondition.
Filter regex nilai kolom tunggal yang dibuat menggunakan NewSingleColumnValueRegexFilter.
Filter komposit yang dibuat menggunakan NewCompositeColumnCondition. Filter komposit dapat berisi subfilter bersarang.

Filter paginasi kolom

PaginationFilter memiliki parameter berikut.

Nama	Type	Deskripsi
Limit (wajib)	`int32`	Jumlah kolom atribut yang dikembalikan. Nilainya harus lebih besar dari 0.
Offset (opsional)	`int32`	Jumlah kolom atribut yang dilewati. Nilainya harus lebih besar dari atau sama dengan 0. Nilai default: `0`.

Contoh

Filter regex

Contoh berikut mengekstraksi active dari nilai kolom profile dalam format level:active, lalu membandingkan hasilnya dengan nilai tertentu.

rule := tablestore.NewValueTransferRule(
    `level:([a-z]+)`,
    tablestore.Variant_STRING,
)
filter := tablestore.NewSingleColumnValueRegexFilter(
    "profile",
    tablestore.CT_EQUAL,
    rule,
    "active",
)
request.SingleRowQueryCriteria.Filter = filter

Filter komposit

Contoh berikut mengembalikan baris dengan score >= 60 dan status bernilai active.

filter := tablestore.NewCompositeColumnCondition(tablestore.LO_AND)
filter.AddFilter(
    tablestore.NewSingleColumnCondition("score", tablestore.CT_GREATER_EQUAL, int64(60)),
)
filter.AddFilter(
    tablestore.NewSingleColumnCondition("status", tablestore.CT_EQUAL, "active"),
)
request.RangeRowQueryCriteria.Filter = filter

Paginasi kolom atribut yang dikembalikan

Contoh berikut melewati kolom atribut pertama dan mengembalikan dua kolom atribut berikutnya.

request.SingleRowQueryCriteria.Filter = &tablestore.PaginationFilter{
    Offset: 1,
    Limit:  2,
}