全部產品
Search
文件中心

ApsaraDB for HBase:HBase SQL(Phoenix) 5.x 使用說明

更新時間:Mar 12, 2025

HBase SQL服務基於Phoenix 5.x為HBase 2.x提供SQL能力,通過輕用戶端即可快速串連訪問。SQL服務掛載了SLB負載平衡,通過round robin模式將請求均勻分發在每個query server節點。輕用戶端還支援Python、Go等多語言訪問。

使用步驟

  1. 開通HBase SQL服務。

    HBase執行個體開通後,進入控制台管理介面,在左側功能表列可以單擊HBase SQL服務項>立即開通,即可開通HBase SQL服務。開通服務

    開通HBase SQL服務時需要重啟HBase執行個體,並佔用部分記憶體資源,請在業務低峰期進行開通,開通過程需要十分鐘左右,節點數越多時間會相對越長。

  2. SQL服務管理。
    服務開通後,在HBase SQL頁面還可以對SQL服務進行日常管理,包括SQL服務小版本升級,SQL服務重啟,開通公網訪問操作。相關操作
    說明 SQL服務串連地址分為負載平衡串連和單點串連,分別在不同的情境中使用。
    • 負載平衡串連:使用SLB進行負載平衡,對於高並發讀寫請求能夠均發至後端的多個QueryServer中處理,提升叢集的整體吞吐能力。
    • 單點串連:使用大表建立索引或使用UPSERT…SELECT導資料以及複雜查詢等單點請求情境,由於請求時間過長使用負載平衡串連會出現連線逾時斷掉情況,需使用單點QueryServer串連。
  3. 準備用戶端。
    建立與HBase處在同一個網路內ECS執行個體,建議為同一個VPC內的ECS執行個體。
    1. 執行如下命令查看這台ECS的內網IP。
      hostname -i
    2. 把上一步驟中查詢出的ECS內網IP加到HBase的網路白名單中,請參見設定白名單
  4. 使用用戶端訪問HBase SQL服務。
    1. 在準備好的ECS客戶機上下載最新版本的HBase SQL用戶端。
      wget https://hbase-opt.oss-cn-hangzhou.aliyuncs.com/ali-phoenix-5.2.4.1-HBase-2.x.tar.gz
    2. 解壓用戶端壓縮包。
      tar zxvf ali-phoenix-5.2.4.1-HBase-2.x.tar.gz
    3. 啟動輕用戶端工具。
      bin/sqlline-thin.py http://xxx-proxy-phoenix.hbase.rds.aliyuncs.com:8765
  5. 執行如下命令驗證配置是否成功。
    !tables
    如果看到一個表的列表,那麼就說明已配置成功。可以開始更加深入的使用了。
    說明 首次串連會建立meta表,需等待一段時間。
  6. 執行如下命令退出Phoenix。
    !quit

對比