本文介绍通过HBaseue Shell连接并使用Lindorm宽表引擎。

前提条件

已创建云原生多模数据库Lindorm实例。

注意事项

通过HBaseue Shell连接并使用Lindorm宽表引擎,强烈建议客户端部署在Linux或者macOS操作系统上。如果部署在Windows环境,可能会遇到报错或缺少库的问题,您需要根据报错信息自行在系统中添加相应的库。

准备工作

  • 如果应用部署在ECS,您需要确保云原生多模数据库Lindorm实例和ECS实例满足以下条件,以保证网络的连通性。ECS实例信息的查看方法请参见查看实例信息
    • 所在地域相同,并建议所在可用区相同(以减少网络延时)。
    • 网络类型相同。
      说明
      • 专有网络具有更高的安全性,建议使用专有网络。
      • 如果网络类型为专有网络,需确保使用相同的专有网络ID。
  • 将客户端IP地址添加至云原生多模数据库Lindorm实例的白名单中,添加方法请参见设置白名单
  • 已获取Lindorm宽表引擎的使用HBase Java API访问连接地址,具体操作请参见查看连接地址

操作步骤

  1. 下载HBaseue Shell工具。
    说明 您可以通过HBase官网下载所需版本的tar包,然后导入JAR文件升级客户端,具体操作请参见通过导入JAR文件升级HBase客户端
    1. 登录Lindorm管理控制台
    2. 在页面左上角,选择实例所属的地域。
    3. 实例列表页,单击目标实例ID。
    4. 在左侧导航栏单击数据库连接,单击宽表引擎页签。
    5. HBase兼容地址区域单击Lindorm Shell下载
  2. 执行以下命令解压HBaseue Shell压缩包,将压缩包解压至目标文件(以alihbase-2.0.18文件为例)。
    tar zxvf hbaseue-shell.tar.gz
  3. 配置连接参数。
    1. 进入alihbase-2.0.18/conf目录,打开hbase-site.xml文件。
      vi hbase-site.xml
    2. 配置Lindorm实例的连接地址和用户名密码。
      <configuration>
          <property>
              <name>hbase.zookeeper.quorum</name>
              <value>ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30020</value>
          </property>
          <property>
              <name>hbase.client.username</name>
              <value>root</value>
          </property>
          <property>
              <name>hbase.client.password</name>
              <value>root</value>
          </property>
      </configuration>
      说明
      • hbase.zookeeper.quorum:填写为Lindorm宽表引擎的使用HBase Java API访问连接地址。
      • hbase.client.usernamehbase.client.password:填写访问Lindorm宽表的用户名和密码,如果您忘记密码可以通过宽表引擎的集群管理系统修改密码,具体操作请参见修改用户密码
  4. 通过HBaseue Shell访问Lindorm宽表引擎。进入alihbase-2.0.18/bin目录执行以下命令。
    ./hbase shell
    返回如下信息表示成功访问。
    Version 2.0.18, r08b8d58a9d6ce89765d5ebe2ddff425aed644c16, Mon Feb  1 12:46:39 CST 2021
    Took 0.0034 seconds
    说明
    • Shell的使用方法可以参见HBase Shell使用介绍
    • 通过HBaseue Shell连接Lindorm宽表引擎仅支持简单的DDL操作和数据读写操作,详情请参见使用限制