LindormTable に接続するには、使用する言語に対応する SDK をインストールする必要があります。ApsaraDB for HBase SDK for Java または非 Java 言語向けの SDK を使用して、LindormTable に接続できます。このトピックでは、ApsaraDB for HBase SDK for Java のインストール方法について説明します。
ApsaraDB for HBase SDK for Java のインストール
ApsaraDB for HBase SDK for Java をインストールすると、LindormTable が提供するすべての機能を使用できます。インストールが完了したら、ApsaraDB for HBase SDK for Java を使用して LindormTable に接続し、アプリケーションを開発できます。
前提条件
Java 開発キット (JDK) V1.8 以降がインストールされていること。
ApsaraDB for HBase SDK for Java は JDK 17 をサポートしていません。
クライアントのバージョン
オープンソース HBase 1.x を使用するクライアントをアップグレードして ApsaraDB for HBase SDK for Java をインストールする場合は、ApsaraDB for HBase 1.x の依存関係を追加する必要があります。
オープンソース HBase 2.x を使用するクライアントをアップグレードして ApsaraDB for HBase SDK for Java をインストールする場合は、ApsaraDB for HBase 2.x の依存関係を追加する必要があります。
ApsaraDB for HBase SDK for Java を初めてインストールする場合は、ApsaraDB for HBase の最新バージョンを選択することを推奨します。たとえば、クライアントがオープンソース HBase 1.1.1 を使用していて、ApsaraDB for HBase の最新バージョンが 1.8.8 の場合は、ApsaraDB for HBase 1.8.8 をインストールすることを推奨します。
手順
クライアントがオープンソース HBase 1.x を使用している場合は、Maven プロジェクトの
pom.xmlファイルに次の依存関係を追加します:<dependency> <groupId>com.aliyun.hbase</groupId> <artifactId>alihbase-client</artifactId> <version>1.8.8</version> </dependency>クライアントがオープンソース HBase 2.x を使用している場合は、Maven プロジェクトの
pom.xmlファイルに次の依存関係を追加します:<dependency> <groupId>com.aliyun.hbase</groupId> <artifactId>alihbase-client</artifactId> <version>2.8.11</version> </dependency>
ApsaraDB for HBase を使用するクライアントが環境でサポートされていない場合、または通常 Hive、Spark、オープンソース Flink を使用して LindormTable に接続する場合は、オープンソース HBase クライアントを使用して LindormTable に接続して利用することを推奨します。
オープンソース HBase クライアントを使用して LindormTable に接続して利用する場合は、次の項目に注意してください:
オープンソース HBase クライアントを使用する場合、仮想プライベートクラウド (VPC) 経由でのみ LindormTable に接続できます。インターネット経由では接続できません。
オープンソース HBase クライアントを使用して Multi-AZ (High-Availability Edition) インスタンスにアクセスすることはできません。オープンソース クライアントによる直接アクセスをサポートするのは、シングル AZ インスタンスと Multi-AZ (Basic Edition) インスタンスのみです。
オープンソース HBase クライアントを使用して LindormTable に接続する場合、プロトコル変換により LindormTable のパフォーマンスが低下する可能性があります。
オープンソース HBase クライアントを使用して LindormTable を利用する場合、圧縮転送、リクエスト認証、アクセス制御リスト (ACL)、エンドツーエンドトレース、クライアント設定のプッシュおよび最適化など、LindormTable が提供する一部の機能を使用できません。
オープンソース HBase クライアントを使用して LindormTable に接続する場合、LindormTable のバージョンは 2.6.2.8 以降である必要があります。LindormTable のバージョンをアップグレードする方法の詳細については、「マイナーバージョンアップグレード」をご参照ください。
サポートされるオープンソース HBase クライアントのバージョンは 0.98 から 2.x までです。安定性とセキュリティを向上させるため、バージョン 1.4.0 以降の使用を推奨します。1.4.0 より前のバージョンは古く、コミュニティによるメンテナンスが終了しており、潜在的な問題がある可能性があります。
使用方法
ApsaraDB for HBase API for Java を使用して SQL テーブルにアクセスすることはできません。LindormTable に接続する前に、データテーブルの種類を確認してください。
ApsaraDB for HBase API for Java を使用して LindormTable に接続する前に、ApsaraDB for HBase API の制限を確認してください。詳細については、「HBase API の制限」をご参照ください。
ApsaraDB for HBase API for Java の使用方法と接続パラメーターの詳細については、「HBase Java API を使用して LindormTable に接続して利用する」をご参照ください。
非 Java 言語向け ApsaraDB for HBase SDK のインストール (C++、Python、Go など)
C++、Python、Go などの非 Java 言語向け ApsaraDB for HBase SDK のインストール方法、および非 Java 言語向け ApsaraDB for HBase SDK を使用して LindormTable に接続する方法の詳細については、「非 Java HBase SDK を使用して LindormTable にアクセスする」をご参照ください。
関連ドキュメント
Lindorm が提供する HBase クライアントツールである Lindorm Shell を使用して LindormTable に接続することもできます。詳細については、「Lindorm Shell を使用して LindormTable に接続する」をご参照ください。
ApsaraDB for HBase API を使用して作成した HBase テーブルにアクセスするために、SQL 文を実行できます。詳細については、「SQL を使用して HBase テーブルにアクセスする」をご参照ください。