HBase 1.0.0 API的变化

最新推荐文章于 2020-05-03 22:07:50 发布

legend1975

最新推荐文章于 2020-05-03 22:07:50 发布

阅读量424

点赞数 1

文章标签： hbase api 1.0.0

本文介绍了HBase API的重要更新，包括连接管理和接口的变化，如新增ConnectionFactory、Connection、Table等类及其实现细节。同时对比了旧API的使用方式，并提供了新API的示例代码。

摘要由CSDN通过智能技术生成

这是一篇译文，原作者为carterp@google.com。

为什么有接口变化

把用户所需（功能）与（这些功能）如何递送区分开来（Separate what a user needs from how it’s delivered）
释放实现，实现能够单独演化
使注入客户代码变得容易（如基准测试，数据装饰等）

API变化初瞥

连接管理已经移到类ConnectionFactory
新增接口：Connection，Table，RegionLocator，和Admin
原始构造函数被标记为过时以支持工厂方法

一些冗余被清理：清理了一些不增加功能的重载函数

表现在只能用TableName，而不是String或byte[]
没有了tableNameOrRegionName参数

表上的数据操作：

Result get(Get get)
ResultScanner getScanner(Scan scan)
void put(Put put)
void delete(Delete delete)

还有其它有条件的修改，批操作，协程服务代用等。

Region信息: RegionLocator

HRegionLocation getRegionLocation(final byte [] row)
Pair<byte[][],byte[][]> getStartEndKeys()

以及一些以上调用的变体。

元数据操作：Admin

boolean isMasterRunning()
HTableDescriptor[] listTables(Pattern pattern)
void createTable(HTableDescriptor desc)
void deleteTable(final TableName tableName)
void compact(final TableName tableName)
void snapshot(final String snapshotName,
final TableName tableName)

等。

调用接口工厂：Connection

这个调用接口是连接句柄，但把它视为所有调用接口的工厂可能会更适合。

Table getTable(TableName tableName)
Table getTable(TableName tableName,ExecutorService pool)
RegionLocator getRegionLocator(TableName tableName)
Admin getAdmin()

如何使用它呢--以前的做法：

Configuration cfg = HBaseConfiguration.create();
HTable t = new HTable(cfg, “mytable”);
t.put(new Put(row).add(fam, qual, value));
t.close();

如何使用它呢--新的做法：

Connection conn = ConnectionFactory.createConnection();
TableName tablename = TableName.valueOf(“mytable”);
Table t = conn.getTable(tablename);
t.put(new Put(row).add(fam, qual, value));
t.close();
conn.close();

public class Putter {
    Connection conn_;
    public Putter(Connection conn) { conn_ = conn; }

    public void put(TableName tablename, byte[] row,
        byte[] fam, byte[] qual, byte[] value) {
        Table t = conn.getTable(tablename);
        t.put(new Put(row).add(fam, qual, value));
        t.close();
    }
}

对象生命周期
接口	Connection	Table, Admin, RegionLocator
重量级	重	轻
创建代价	高昂	廉价
线程安全性	是	否
使用方法	进程内创建一个并共享	单线程上下文中随需创建