すべてのプロダクト
Search
ドキュメントセンター

Tablestore:SingleColumnValueFilter

最終更新日:Dec 28, 2024

単一のフィルター条件 (例: column_a>5) を指定します。SingleColumnValueFilter は、条件付き更新とフィルター機能で使用されます。

データ構造

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

いいえ

正規表現を使用して文字列が一致した後、文字列を String、Integer、または Double タイプに変換します。

JSON 文字列などのカスタム形式で列データを保存し、サブフィールド値を使用して列データをフィルタリングおよびクエリする場合、このパラメーターを設定する必要があります。

参照