全部产品
Search
文档中心

Tablestore:SingleColumnValueFilter

更新时间:Jun 24, 2025

Menentukan satu kondisi filter, seperti column_a>5. SingleColumnValueFilter digunakan untuk fitur pembaruan bersyarat dan penyaringan.

Struktur data

message SingleColumnValueFilter {
    required ComparatorType comparator = 1;
    required string column_name = 2;
    required bytes column_value = 3;
    required bool filter_if_missing = 4;
    required bool latest_version_only = 5; 
    optional ValueTransferRule value_transfer_rule =6;
     
}                

Parameter

Tipe

Diperlukan

Deskripsi

comparator

ComparatorType

Ya

Operator relasional.

column_name

string

Ya

Nama kolom

column_value

bytes

Ya

Nilai kolom setelah pengkodean PlainBuffer.

filter_if_missing

bool

Ya

Menentukan apakah kondisi filter berlaku ketika kolom tertentu dalam baris tidak ada. Nilai yang valid:

  • true: Baris dipertahankan. Ini adalah nilai default.

  • false: Baris disaring.

Sebagai contoh, jika kondisi filter adalah column_a>0 dan filter_if_missing diatur ke true, ketika column_a tidak ada dalam baris, baris tersebut dipertahankan.

latest_version_only

bool

Ya

Menentukan apakah kondisi filter hanya berlaku untuk versi terbaru. Nilai yang valid:

  • true: mengembalikan baris hanya ketika versi terbaru dari nilai kolom memenuhi kondisi. Ini adalah nilai default.

  • false: mengembalikan baris ketika versi apa pun dari nilai kolom memenuhi kondisi.

value_transfer_rule

ValueTransferRule

Tidak

Mengonversi string ke tipe String, Integer, atau Double setelah string cocok menggunakan ekspresi reguler.

Jika Anda menyimpan data kolom dalam format khusus seperti string JSON dan ingin menyaring serta menanyakan data kolom dengan menggunakan nilai subbidang, Anda harus mengonfigurasi parameter ini.

Referensi