單個條件,例如column_a>5等,適用於ConditionUpdate(條件更新)和Filter(過濾器)功能。

資料結構

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;
     
}                
名稱 類型 是否必選 描述
comparator ComparatorType 關係運算子。
column_name string 列名稱。
column_value bytes 列值經過Plainbuffer編碼後的值。
filter_if_missing bool 當某行的該列不存在時,設定條件是否過濾。取值範圍如下:
  • true(預設):該行的條件判斷通過。
  • false:該行的條件判斷不通過。

例如過濾條件為column_a>0,如果設定filter_if_missing為true,則當某一行沒有column_a列時,該行的條件判斷會通過。

latest_version_only bool 是否只對最新版本有效。取值範圍如下:
  • true(預設):只檢測最新版本的值是否滿足條件。
  • false:檢測所有版本的值是否滿足條件。
value_transfer_rule ValueTransferRule 使用Regex匹配到字串後,將字串轉換為String、Integer或者Double類型。

當某些列中儲存了自訂格式資料(例如JSON格式字串)時,如果使用者希望通過某個子欄位值來過濾查詢該列資料,則需要設定此參數。

相關操作