HBase获取特定行多列族列值及getFamilyMap使用疑问

首先得明确你大概率是混淆了HBase Result 类中两个同名但不同参数的 getFamilyMap 方法，这正是两段代码行为不同的核心原因。

先看两种常见的代码写法（对应你说的两段代码） #

代码1（无法获取数据的写法）

// 调用无参的getFamilyMap
Result result = table.get(get);
// 实际返回的是两层嵌套的Map：NavigableMap<byte[], NavigableMap<byte[], byte[]>>
NavigableMap<byte[], ?> familyMap = result.getFamilyMap(); 

for (Map.Entry<byte[], ?> entry : familyMap.entrySet()) {
    // 这里的entry.getValue()是一个子Map，不是具体的单元格值
    byte[] value = (byte[]) entry.getValue(); // 强制转换会出错，直接拿它当值自然取不到有效数据
}

代码2（能正常获取键值的写法）

Result result = table.get(get);
// 传入指定列族，直接拿到该列族下的<列限定符, 值>单层映射
NavigableMap<byte[], byte[]> columnMap = result.getFamilyMap(Bytes.toBytes("your_column_family"));

for (Map.Entry<byte[], byte[]> entry : columnMap.entrySet()) {
    String qualifier = Bytes.toString(entry.getKey());
    String value = Bytes.toString(entry.getValue());
    // 这里就能正常获取列限定符和对应的值了
}

核心差异拆解 #

1. 返回值类型完全不同

   • 无参的result.getFamilyMap()：返回两层嵌套Map，外层Map的key是列族名（byte[]），value是该列族下所有列的<列限定符, 值>的子Map。如果你直接拿外层entry的value，得到的是一个子Map，不是具体的单元格值，自然无法解析出有效数据。
   • 带列族参数的result.getFamilyMap(byte[] family)：返回单层Map，直接对应指定列族下的所有列限定符和它们的单元格值，遍历这个Map的entry就能直接拿到每一列的键（列限定符）和值。

2. 遍历逻辑的层级差异
   如果你的第一段代码确实用了无参方法，那正确的遍历逻辑应该是先遍历外层列族，再遍历内层列：

   NavigableMap<byte[], NavigableMap<byte[], byte[]>> familyMap = result.getFamilyMap();
   for (Map.Entry<byte[], NavigableMap<byte[], byte[]>> familyEntry : familyMap.entrySet()) {
       String familyName = Bytes.toString(familyEntry.getKey());
       NavigableMap<byte[], byte[]> columnMap = familyEntry.getValue();
       // 再遍历内层列的键值对
       for (Map.Entry<byte[], byte[]> columnEntry : columnMap.entrySet()) {
           String qualifier = Bytes.toString(columnEntry.getKey());
           String value = Bytes.toString(columnEntry.getValue());
           // 这里就能拿到数据了
       }
   }
   

简单来说，就是你可能误把两层嵌套的Map当成了单层Map来处理，导致拿不到实际的单元格值。只要区分开无参和带参的getFamilyMap方法，就能解决这个问题啦。

内容的提问来源于stack exchange，提问作者Manoj