584      人物

使用過濾器__最佳實踐_表格存儲-阿裏雲

過濾器 Filter 可以在服務端對讀取的結果再進行一次過濾，根據 Filter 中的條件決定返回哪些行。由於隻返回了符合條件的數據行，所以在大部分場景下，可以有效降低網絡傳輸的數據量，減少響應時間。

表格存儲 Filter 的過濾條件支持算術運算（=、!=、>、>=、<、<=）和邏輯運算（NOT、AND、OR），支持最多 10 個條件的組合，可以用於 GetRow、BatchGetRow 和 GetRange 接口中。

使用說明

目前表格存儲僅支持 SingleColumnValueFilter 和 CompositeColumnValueFilter，這兩個 Filter 都是基於參考列的列值決定某行是否會被過濾掉。前者隻判斷某個參考列的列值，後者會對多個參考列的列值判斷結果進行邏輯組合，決定最終是否過濾。

API 文檔參考：ColumnCondition。

1. 構造 SingleColumnValueFilter。

    // 設置過濾器, 當 Col0 的值為 0 時返回該行。
    SingleColumnValueFilter singleColumnValueFilter = new SingleColumnValueFilter("Col0",
            SingleColumnValueFilter.CompareOperator.EQUAL, ColumnValue.fromLong(0));
    // 如果不存在 Col0 這一列, 也不返回。
    singleColumnValueFilter.setPassIfMissing(false);

2. 構造 CompositeColumnValueFilter。

    // composite1 條件為 (Col0 == 0) AND (Col1 > 100)
    CompositeColumnValueFilter composite1 = new CompositeColumnValueFilter(CompositeColumnValueFilter.LogicOperator.AND);
    SingleColumnValueFilter single1 = new SingleColumnValueFilter("Col0",
            SingleColumnValueFilter.CompareOperator.EQUAL, ColumnValue.fromLong(0));
    SingleColumnValueFilter single2 = new SingleColumnValueFilter("Col1",
            SingleColumnValueFilter.CompareOperator.GREATER_THAN, ColumnValue.fromLong(100));
    composite1.addFilter(single1);
    composite1.addFilter(single2);
    // composite2 條件為 ( (Col0 == 0) AND (Col1 > 100) ) OR (Col2 <= 10)
    CompositeColumnValueFilter composite2 = new CompositeColumnValueFilter(CompositeColumnValueFilter.LogicOperator.OR);
    SingleColumnValueFilter single3 = new SingleColumnValueFilter("Col2",
            SingleColumnValueFilter.CompareOperator.LESS_EQUAL, ColumnValue.fromLong(10));
    composite2.addFilter(composite1);
    composite2.addFilter(single3);

需要注意的是，Filter 是對讀取後的結果再進行一次過濾，所以 SingleColumnValueFilter 或者 CompositeColumnValueFilter 中的參考列必須在讀取的結果內，如果用戶指定了要讀取的列，且其中不包含參考列，那麼 Filter 無法獲得這些參考列的值。當某個參考列不存在時，SingleColumnValueFilter 的 passIfMissing 參數決定此時是否滿足條件，即用戶可以選擇當參考列不存在時的行為。