Home

Awesome

AsyncBigtable

Travis CI status Maven Stack Overflow

This is an HBase library intended to work as a drop in replacement for the fantastic AsyncHBase library and integrate OpenTSDB with Google Bigtable. It is using the Apache HBase 1.0 API linking the Google Bigtable libraries.

This library started out as a fork of the asynchbase 1.5.0 library, therefore one may find code that at first sight may look strange. We are working on cleaning up the code base and removing irrelevant dependencies.

Basic Installation

Contrary to the original asynchbase library, asyncbigtable has adopted Maven as the building tool for this project.

To produce the jar file, simply run:

mvn clean package

Maven will produce the following two jar files under the target/ directory:

  1. asyncbigtable-<version>.jar which is the compiled jar file
  2. asyncbigtable-<version>-jar-with-dependencies.jar which is an assembly jar containing all dependencies required for asyncbigtable to run with OpenTSDB. Please note that this jar does not include all dependencies but only the ones for OpenTSDB.

Javadoc

Since AsyncBigtable tries to be 100% compatible with AsyncHBase, please read the AsyncHBase javadoc.

Integration Tests

Integration tests can be run as follows:

mvn clean verify -Pbt-integration-test -Dgoogle.bigtable.project.id=<projectId> -Dgoogle.bigtable.instance.id=<instanceId> 

Changelog

This project uses Semantic Versioning.

0.4.3

0.4.2

0.4.1

0.4.0

0.3.0

0.2.1

Disclaimer

Please note that the library is still under development and it was never meant to replace AsyncHBase when running with an HBase backend or be a general purpose HBase library.

<!-- references -->