Une condition de filtre unique - Tablestore - Centre de documentation Alibaba Cloud

Spécifie une condition de filtre unique, telle que column_a>5. SingleColumnValueFilter sert aux fonctionnalités de mise à jour conditionnelle et de filtrage.

Structure des données

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;
     
}

Paramètre	Type	Obligatoire	Description
comparator	ComparatorType	Oui	Opérateur relationnel.
column_name	string	Oui	Nom de la colonne.
column_value	bytes	Oui	Valeur de la colonne après encodage PlainBuffer.
filter_if_missing	bool	Oui	Indique si la condition de filtre s'applique lorsque la colonne spécifiée dans une ligne n'existe pas. Valeurs possibles : true : conserve la ligne. Il s'agit de la valeur par défaut. false : exclut la ligne. Par exemple, si la condition de filtre est column_a>0 et que filter_if_missing est défini sur true, la ligne est conservée lorsque column_a n'existe pas.
latest_version_only	bool	Oui	Indique si la condition de filtre s'applique uniquement à la dernière version. Valeurs possibles : true : renvoie la ligne uniquement si la dernière version de la valeur de la colonne satisfait à la condition. Il s'agit de la valeur par défaut. false : renvoie la ligne si n'importe quelle version de la valeur de la colonne satisfait à la condition.
value_transfer_rule	ValueTransferRule	Non	Convertit une chaîne en type String, Integer ou Double après mise en correspondance par expression régulière. Si vous stockez les données de colonne dans un format personnalisé (par exemple, une chaîne JSON) et souhaitez les filtrer ou les interroger à l'aide d'une valeur de sous-champ, configurez ce paramètre.

Références

Utilisez la fonctionnalité de mise à jour conditionnelle lors de l'appel des opérations PutRow, UpdateRow, DeleteRow ou BatchWriteRow.
Utilisez la fonctionnalité de filtre lors de l'appel des opérations GetRow, GetRange ou BatchGetRow.