LindormTable に接続するには、ご利用の言語に対応した ApsaraDB for HBase SDK をインストールします。以下の手順は Java SDK に適用されます。C++、Python、Go については、「ApsaraDB for HBase SDK (Java 以外) を使用した LindormTable への接続」をご参照ください。
前提条件
開始する前に、以下が準備できていることを確認してください。
Java 開発キット (JDK) V1.8 以降
ApsaraDB for HBase SDK for Java は JDK 17 をサポートしていません。JDK 17 を実行している場合は、続行する前にサポートされているバージョンに切り替えてください。
SDK バージョンの選択
SDK のバージョンは、既存のオープンソース HBase クライアントと同じメジャーバージョン系列に従います。
| 現在の HBase クライアント | 追加する SDK 依存関係 |
|---|---|
| オープンソース HBase 1.x | ApsaraDB for HBase 1.x (alihbase-client 1.8.8) |
| オープンソース HBase 2.x | ApsaraDB for HBase 2.x (alihbase-client 2.8.7) |
今回が初めてのインストール (既存の HBase クライアントがない) の場合は、プロジェクトのターゲット HBase API に一致する系列の最新バージョンを使用してください。たとえば、HBase 1.x API をベースにビルドしており、ApsaraDB for HBase の最新バージョンが 1.8.8 の場合は、1.8.8 をインストールします。
ご利用の環境が ApsaraDB for HBase クライアントをサポートしていない場合、または通常 Hive、Spark、Flink を介して LindormTable に接続する場合は、代わりにオープンソースの HBase クライアントを使用してください。続行する前に、「オープンソースの HBase クライアントを使用する場合の制限事項」をご参照ください。
Maven 依存関係の追加
ご利用の SDK バージョンに一致する依存関係を pom.xml に追加します。
HBase 1.x — Maven：
<dependency>
<groupId>com.aliyun.hbase</groupId>
<artifactId>alihbase-client</artifactId>
<version>1.8.8</version>
</dependency>HBase 2.x — Maven：
<dependency>
<groupId>com.aliyun.hbase</groupId>
<artifactId>alihbase-client</artifactId>
<version>2.8.7</version>
</dependency>次のステップ
インストール後、LindormTable に接続してビルドを開始します。
API の使用制限の確認：接続する前に、ApsaraDB for HBase API の制約を確認してください。詳細については、「使用制限」をご参照ください。
接続と開発：接続パラメーターと使用例については、「ApsaraDB for HBase API for Java を使用したアプリケーション開発」をご参照ください。
ApsaraDB for HBase API for Java は SQL テーブルにアクセスできません。接続する前に、データテーブルのタイプを確認してください。
オープンソースの HBase クライアントを使用する場合の制限事項
ApsaraDB for HBase SDK の代わりにオープンソースの HBase クライアントを使用する場合は、以下の制約にご注意ください。
VPC のみ：LindormTable には、仮想プライベートクラウド (VPC) 経由でのみ接続できます。インターネット接続はサポートされていません。
シングルゾーンインスタンスのみ：オープンソースの HBase クライアントは、複数ゾーンにまたがってデプロイされた Lindorm インスタンスには接続できません。
パフォーマンスへの影響：オープンソースの HBase プロトコルと LindormTable のネイティブプロトコル間のプロトコル変換により、パフォーマンスが低下する可能性があります。
利用不可な機能：次の LindormTable 機能は利用できません：圧縮伝送、リクエスト認証、アクセス制御リスト (ACL)、エンドツーエンドのトレーシング、クライアント構成のプッシュと最適化。
LindormTable のバージョン要件：LindormTable はバージョン 2.6.2.8 以降である必要があります。アップグレードするには、「Lindorm インスタンスのマイナーエンジンバージョンのアップグレード」をご参照ください。
クライアントバージョンの範囲：オープンソースの HBase クライアントのバージョンは 0.98 から 2.x である必要があります。
関連項目
Lindorm Shell (Lindorm にバンドルされている HBase クライアントツール) を使用して、LindormTable にインタラクティブに接続します。詳細については、「Lindorm Shell を使用した LindormTable への接続」をご参照ください。
ApsaraDB for HBase API で作成された HBase テーブルに対して SQL ステートメントを実行します。詳細については、「SQL を使用した HBase テーブルへのアクセス」をご参照ください。