串連寬表引擎前,您需要根據使用的API安裝相應的SDK。Lindorm支援通過HBase Java API和HBase非Java API進行訪問。本文介紹如何安裝HBase SDK。
安裝HBase Java SDK
使用阿里雲發行的HBase用戶端可以使用Lindorm寬表引擎的所有功能,並享受Lindorm帶來的優秀體驗。安裝HBase Java SDK後,您可以通過HBase Java API訪問寬表引擎並進行應用開發。
前提條件
已安裝Java環境且JDK為1.8及以上版本。
HBase Java SDK不支援JDK17版本。
版本說明
開源HBase 1.x版本用戶端需添加阿里雲HBase 1.x版本的依賴。
開源HBase 2.x版本用戶端需添加阿里雲HBase 2.x版本的依賴。
新使用者安裝時建議選擇阿里雲HBase用戶端目前的版本下最新的子版本。例如您的開源HBase用戶端為1.1.1版本,阿里雲HBase用戶端最新版本為1.8.8,建議您安裝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.7</version> </dependency>
如果您的環境不支援安裝阿里雲發行的HBase用戶端,或您經常通過Hive、Spark、開源Flink(非阿里雲託管版)使用Lindorm寬表引擎,為避免配置更改出現錯誤,建議您使用開源HBase用戶端串連並使用Lindorm寬表引擎。
使用開源HBase用戶端串連並使用Lindorm寬表引擎需要注意以下問題:
開源HBase用戶端不支援通過公網訪問Lindorm寬表引擎。
當前不支援通過開源HBase用戶端訪問多可用性區域執行個體。
由於存在協議轉換,使用開源HBase用戶端直接存取Lindorm寬表引擎可能存在一定的效能損耗。
使用開源HBase用戶端無法使用Lindorm的完整功能, 如傳輸壓縮、請求認證、ACL、全鏈路trace、用戶端配置推送和調優等功能。
使用開源HBase用戶端直接存取Lindorm寬表引擎前需要將寬表引擎升級到2.6.2.8及以上版本。如何升級,請參見升級小版本。
支援的開源HBase用戶端的版本為0.98~2.x版本。
使用方式
HBase Java API不支援訪問SQL表,在串連寬表引擎前請先確認資料表的類型。
使用Java API串連寬表引擎前,請先查閱Java API使用限制,詳情請參見HBase API使用限制。
Java API的使用和串連參數說明,請參見基於HBase Java API的應用開發。
安裝非Java(C++/Python/Go等) SDK
非Java(C++/Python/Go等) SDK的安裝及存取方法,請參見通過HBase非Java SDK訪問Lindorm寬表引擎。
相關文檔
您還可以通過Lindorm提供的HBase用戶端工具Lindorm Shell來訪問寬表引擎,具體操作,請參見通過Lindorm Shell訪問寬表引擎。
通過HBase API建立的表支援通過SQL訪問,詳情請參見使用SQL訪問HBase表。