HBase学习之路（六）过滤器

过滤器（Filter）

　　基础API中的查询操作在面对大量数据的时候是非常苍白的，这里Hbase提供了高级的查询方法：Filter。Filter可以根据簇、列、版本等更多的条件来对数据进行过滤，基于Hbase本身提供的三维有序（主键有序、列有序、版本有序），这些Filter可以高效的完成查询过滤的任务。带有Filter条件的RPC查询请求会把Filter分发到各个RegionServer，是一个服务器端（Server-side）的过滤器，这样也可以降低网络传输的压力。

　　要完成一个过滤的操作，至少需要两个参数。一个是抽象的操作符，Hbase提供了枚举类型的变量来表示这些抽象的操作符：LESS/LESS_OR_EQUAL/EQUAL/NOT_EUQAL等；另外一个就是具体的比较器（Comparator），代表具体的比较逻辑，如果可以提高字节级的比较、字符串级的比较等。有了这两个参数，我们就可以清晰的定义筛选的条件，过滤数据。

抽象操作符（比较运算符）

LESS <

LESS_OR_EQUAL <=

EQUAL =

NOT_EQUAL <>

GREATER_OR_EQUAL >=

GREATER >

NO_OP 排除所有

比较器（指定比较机制）

BinaryComparator 按字节索引顺序比较指定字节数组，采用 Bytes.compareTo(byte[])

BinaryPrefixComparator 跟前面相同，只是比较左端的数据是否相同

NullComparator 判断给定的是否为空

BitComparator 按位比较

RegexStringComparator 提供一个正则的比较器，仅支持 EQUAL 和非 EQUAL

SubstringComparator 判断提供的子串是否出现在 value 中

HBase过滤器的分类

比较过滤器

1、行键过滤器 RowFilter

Filter rowFilter = new RowFilter(CompareOp.GREATER, new BinaryComparator("95007".getBytes()));
scan.setFilter(rowFilter);

 1 public class HbaseFilterTest {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         Filter rowFilter = new RowFilter(CompareOp.GREATER, new BinaryComparator("95007".getBytes()));
20         scan.setFilter(rowFilter);
21         ResultScanner resultScanner = table.getScanner(scan);
22         for(Result result : resultScanner) {
23             List<Cell> cells = result.listCells();
24             for(Cell cell : cells) {
25                 System.out.println(cell);
26             }
27         }
28
29
30     }

View Code

运行结果部分截图

2、列簇过滤器 FamilyFilter

Filter familyFilter = new FamilyFilter(CompareOp.EQUAL, new BinaryComparator("info".getBytes()));
scan.setFilter(familyFilter);

 1 public class HbaseFilterTest {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         Filter familyFilter = new FamilyFilter(CompareOp.EQUAL, new BinaryComparator("info".getBytes()));
20         scan.setFilter(familyFilter);
21         ResultScanner resultScanner = table.getScanner(scan);
22         for(Result result : resultScanner) {
23             List<Cell> cells = result.listCells();
24             for(Cell cell : cells) {
25                 System.out.println(cell);
26             }
27         }
28
29
30     }
31
32
33 }

View Code

3、列过滤器 QualifierFilter

Filter qualifierFilter = new QualifierFilter(CompareOp.EQUAL, new BinaryComparator("name".getBytes()));
scan.setFilter(qualifierFilter);

 1 public class HbaseFilterTest {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         Filter qualifierFilter = new QualifierFilter(CompareOp.EQUAL, new BinaryComparator("name".getBytes()));
20         scan.setFilter(qualifierFilter);
21         ResultScanner resultScanner = table.getScanner(scan);
22         for(Result result : resultScanner) {
23             List<Cell> cells = result.listCells();
24             for(Cell cell : cells) {
25                 System.out.println(cell);
26             }
27         }
28
29
30     }
31
32
33 }

View Code

4、值过滤器 ValueFilter

Filter valueFilter = new ValueFilter(CompareOp.EQUAL, new SubstringComparator("男"));
scan.setFilter(valueFilter);

 1 public class HbaseFilterTest {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         Filter valueFilter = new ValueFilter(CompareOp.EQUAL, new SubstringComparator("男"));
20         scan.setFilter(valueFilter);
21         ResultScanner resultScanner = table.getScanner(scan);
22         for(Result result : resultScanner) {
23             List<Cell> cells = result.listCells();
24             for(Cell cell : cells) {
25                 System.out.println(cell);
26             }
27         }
28
29
30     }
31
32
33 }

View Code

5、时间戳过滤器 TimestampsFilter

List<Long> list = new ArrayList<>();
list.add(1522469029503l);
TimestampsFilter timestampsFilter = new TimestampsFilter(list);
scan.setFilter(timestampsFilter);

 1 public class HbaseFilterTest {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         List<Long> list = new ArrayList<>();
20         list.add(1522469029503l);
21         TimestampsFilter timestampsFilter = new TimestampsFilter(list);
22         scan.setFilter(timestampsFilter);
23         ResultScanner resultScanner = table.getScanner(scan);
24         for(Result result : resultScanner) {
25             List<Cell> cells = result.listCells();
26             for(Cell cell : cells) {
27                 System.out.println(Bytes.toString(cell.getRow()) + "\t" + Bytes.toString(cell.getFamily()) + "\t" + Bytes.toString(cell.getQualifier())
28                 + "\t" + Bytes.toString(cell.getValue()) + "\t" + cell.getTimestamp());
29             }
30         }
31
32
33     }
34
35
36 }

View Code

专用过滤器

1、单列值过滤器 SingleColumnValueFilter ----会返回满足条件的整行

SingleColumnValueFilter singleColumnValueFilter = new SingleColumnValueFilter("info".getBytes(), //列簇"name".getBytes(), //列CompareOp.EQUAL, new SubstringComparator("刘晨"));
//如果不设置为 true，则那些不包含指定 column 的行也会返回
singleColumnValueFilter.setFilterIfMissing(true);
scan.setFilter(singleColumnValueFilter);

 1 public class HbaseFilterTest2 {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         SingleColumnValueFilter singleColumnValueFilter = new SingleColumnValueFilter(
20                 "info".getBytes(),
21                 "name".getBytes(),
22                 CompareOp.EQUAL,
23                 new SubstringComparator("刘晨"));
24         singleColumnValueFilter.setFilterIfMissing(true);
25
26         scan.setFilter(singleColumnValueFilter);
27         ResultScanner resultScanner = table.getScanner(scan);
28         for(Result result : resultScanner) {
29             List<Cell> cells = result.listCells();
30             for(Cell cell : cells) {
31                 System.out.println(Bytes.toString(cell.getRow()) + "\t" + Bytes.toString(cell.getFamily()) + "\t" + Bytes.toString(cell.getQualifier())
32                 + "\t" + Bytes.toString(cell.getValue()) + "\t" + cell.getTimestamp());
33             }
34         }
35
36
37     }
38
39
40 }

View Code

2、单列值排除器 SingleColumnValueExcludeFilter

SingleColumnValueExcludeFilter singleColumnValueExcludeFilter = new SingleColumnValueExcludeFilter("info".getBytes(), "name".getBytes(), CompareOp.EQUAL, new SubstringComparator("刘晨"));
singleColumnValueExcludeFilter.setFilterIfMissing(true);scan.setFilter(singleColumnValueExcludeFilter);

 1 public class HbaseFilterTest2 {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         SingleColumnValueExcludeFilter singleColumnValueExcludeFilter = new SingleColumnValueExcludeFilter(
20                 "info".getBytes(),
21                 "name".getBytes(),
22                 CompareOp.EQUAL,
23                 new SubstringComparator("刘晨"));
24         singleColumnValueExcludeFilter.setFilterIfMissing(true);
25
26         scan.setFilter(singleColumnValueExcludeFilter);
27         ResultScanner resultScanner = table.getScanner(scan);
28         for(Result result : resultScanner) {
29             List<Cell> cells = result.listCells();
30             for(Cell cell : cells) {
31                 System.out.println(Bytes.toString(cell.getRow()) + "\t" + Bytes.toString(cell.getFamily()) + "\t" + Bytes.toString(cell.getQualifier())
32                 + "\t" + Bytes.toString(cell.getValue()) + "\t" + cell.getTimestamp());
33             }
34         }
35
36
37     }
38
39
40 }

View Code

3、前缀过滤器 PrefixFilter----针对行键

PrefixFilter prefixFilter = new PrefixFilter("9501".getBytes());scan.setFilter(prefixFilter);

 1 public class HbaseFilterTest2 {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         PrefixFilter prefixFilter = new PrefixFilter("9501".getBytes());
20
21         scan.setFilter(prefixFilter);
22         ResultScanner resultScanner = table.getScanner(scan);
23         for(Result result : resultScanner) {
24             List<Cell> cells = result.listCells();
25             for(Cell cell : cells) {
26                 System.out.println(Bytes.toString(cell.getRow()) + "\t" + Bytes.toString(cell.getFamily()) + "\t" + Bytes.toString(cell.getQualifier())
27                 + "\t" + Bytes.toString(cell.getValue()) + "\t" + cell.getTimestamp());
28             }
29         }
30
31
32     }
33
34
35 }

View Code

4、列前缀过滤器 ColumnPrefixFilter

ColumnPrefixFilter columnPrefixFilter = new ColumnPrefixFilter("name".getBytes());scan.setFilter(columnPrefixFilter);

 1 public class HbaseFilterTest2 {
 2
 3     private static final String ZK_CONNECT_KEY = "hbase.zookeeper.quorum";
 4     private static final String ZK_CONNECT_VALUE = "hadoop1:2181,hadoop2:2181,hadoop3:2181";
 5
 6     private static Connection conn = null;
 7     private static Admin admin = null;
 8
 9     public static void main(String[] args) throws Exception {
10
11         Configuration conf = HBaseConfiguration.create();
12         conf.set(ZK_CONNECT_KEY, ZK_CONNECT_VALUE);
13         conn = ConnectionFactory.createConnection(conf);
14         admin = conn.getAdmin();
15         Table table = conn.getTable(TableName.valueOf("student"));
16
17         Scan scan = new Scan();
18
19         ColumnPrefixFilter columnPrefixFilter = new ColumnPrefixFilter("name".getBytes());
20
21         scan.setFilter(columnPrefixFilter);
22         ResultScanner resultScanner = table.getScanner(scan);
23         for(Result result : resultScanner) {
24             List<Cell> cells = result.listCells();
25             for(Cell cell : cells) {
26                 System.out.println(Bytes.toString(cell.getRow()) + "\t" + Bytes.toString(cell.getFamily()) + "\t" + Bytes.toString(cell.getQualifier())
27                 + "\t" + Bytes.toString(cell.getValue()) + "\t" + cell.getTimestamp());
28             }
29         }
30
31
32     }
33
34
35 }

View Code

5、分页过滤器 PageFilter