Tablestore SDK と RESTful API 操作に加えて、Tablestore が提供する Tablestore HBase Client を使用して Tablestore にアクセスできます。オープンソースの HBase 操作をサポートする Java アプリケーションは、Tablestore HBase Client を使用して Tablestore にアクセスできます。
サポートされているバージョン
Java V4.2.x 以降向けの Tablestore SDK に基づいて、Tablestore HBase Client は、V1.x.x(HBase V1.2.0 と互換性あり)および V2.x.x(HBase V2.5.10 と互換性あり)のオープンソース HBase API 操作をサポートしています。
Tablestore HBase Client の入手
Tablestore HBase Clientを取得するために使用できるメソッドは、互換性のある HBase APIバージョンによって異なります。HBase Client V2.x.xと HBase Client V1.x.xは、異なる API 操作をサポートしています。HBase Clientのバージョンに基づいて、Tablestore HBase Clientバージョンを選択してください。
HBase Client V2.x.x を使用する場合は、Tablestore HBase Client V2.x.x を選択します。
HBase Client V1.x.x を使用する場合は、Tablestore HBase Client V1.x.x を選択します。
HBase Client V0.x.x を使用する場合は、「Tablestore HBase Client を 1.0 より前の HBase バージョンと互換性を持たせる」をご参照ください。
HBase Client V2.x.x
次のいずれかの方法で Tablestore HBase Client を取得します。
GitHub から tablestore-hbase-client プロジェクト をダウンロードします。
tablestore-hbase-client-2.0.12.zipをダウンロードします。
Maven
Tablestore HBase Client V2.0.12 は、HBase Client V2.5.10 と Tablestore SDK for Java V5.17.4 に依存しています。Maven プロジェクトの pom.xml ファイルに次の依存関係を追加します。
<dependencies> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore-hbase-client</artifactId> <version>2.0.12</version> </dependency> </dependencies>
他のバージョンの HBase Client または Tablestore SDK for Java を使用する場合、exclusion タグを使用できます。次の例では、HBase Client V2.5.0 と Tablestore SDK for Java V5.17.0 を使用しています。
<dependencies> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore-hbase-client</artifactId> <version>2.0.12</version> <exclusions> <exclusion> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore</artifactId> </exclusion> <exclusion> <groupId>org.apache.hbase</groupId> <artifactId>hbase-client</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.apache.hbase</groupId> <artifactId>hbase-client</artifactId> <version>2.5.0</version> </dependency> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore</artifactId> <classifier>jar-with-dependencies</classifier> <version>5.17.0</version> </dependency> </dependencies>
HBase Client V1.x.x
次のいずれかの方法で Tablestore HBase Client を取得します。
GitHub から tablestore-hbase-client プロジェクト をダウンロードします。
tablestore-hbase-client-1.2.0.zip をダウンロードします。
Maven
Tablestore HBase Client V1.2.0 は、HBase Client V1.2.0 と Tablestore SDK for Java V4.2.1 に依存しています。Maven プロジェクトの pom.xml ファイルに次の依存関係を追加します。
<dependencies> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore-hbase-client</artifactId> <version>1.2.0</version> </dependency> </dependencies>
他のバージョンの HBase Client または Tablestore SDK for Java を使用する場合、exclusion タグを使用できます。次の例では、HBase Client V1.2.1 と Tablestore SDK for Java V4.2.0 を使用しています。
<dependencies> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore-hbase-client</artifactId> <version>1.2.0</version> <exclusions> <exclusion> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore</artifactId> </exclusion> <exclusion> <groupId>org.apache.hbase</groupId> <artifactId>hbase-client</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.apache.hbase</groupId> <artifactId>hbase-client</artifactId> <version>1.2.1</version> </dependency> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore</artifactId> <classifier>jar-with-dependencies</classifier> <version>4.2.0</version> </dependency> </dependencies>
使用上の注意
HBase から Tablestore にデータを移行した後、Tablestore HBase Client を使用する場合、HBase Server について考慮する必要はありません。 テーブル操作またはデータ操作を実行するには、Tablestore HBase Client によって提供される操作のみを使用する必要があります。 Tablestore は、テーブル分割、Dump、Compact、Region Server などのインフラストラクチャの詳細を隠蔽します。 データの使用量にのみ注意を払う必要があります。
Tablestore データを Tablestore HBase Client を使用して読み書きする方法については、「Tablestore HBase Client の使用開始」をご参照ください。
Tablestore データに対して Tablestore HBase Client を使用して操作を実行する方法については、「HBase Client から Tablestore HBase Client への移行」をご参照ください。
課金ルール
Tablestore HBase Client を使用する場合、Tablestore へのデータの書き込みと読み取りに対して課金されます。また、データストレージ料金も課金されます。詳細については、「課金の概要」をご参照ください。
関連情報
Tablestore と HBase は、類似したデータモデルと機能を備えています。ただし、Tablestore HBase Client とネイティブ HBase API には、特定の違いがあります。詳細については、「Tablestore HBase Client でサポートされている機能」をご参照ください。