如何使用Lindorm Shell连接宽表引擎_云原生多模数据库 Lindorm-阿里云帮助中心

Lindorm Shell是Lindorm提供的HBase客户端工具。Lindorm Shell基于HBase Java API连接Lindorm宽表引擎，进行创建表、插入、查询等数据操作。本文介绍如何下载Lindorm Shell并连接Lindorm宽表引擎。

前提条件

已安装Java环境，要求安装JDK 1.8及以上版本。
已将客户端IP地址添加至云原生多模数据库 Lindorm实例的白名单中，添加方法请参见设置白名单。

注意事项

通过Lindorm Shell连接Lindorm宽表引擎仅支持简单的DDL操作和数据读写操作，不支持的操作请参见HBase API使用限制。
请勿使用HBase API的方式去访问基于SQL创建的宽表，可能会出现乱码。
推荐在Linux或者macOS操作系统使用Lindorm Shell。
在Windows系统使用Lindorm Shell，可能会遇到报错或缺少库的问题，请根据报错信息自行在系统中添加相应的库。

操作步骤

下载Lindorm Shell工具。
1. 在Lindorm管理控制台左上角，选择实例所属的地域。在实例列表页，单击目标实例ID。
2. 在左侧导航栏单击数据库连接，单击宽表引擎页签。
3. 单击HBase兼容地址，然后单击Lindorm Shell下载。
执行命令解压Lindorm Shell压缩包，将压缩包解压至目标文件（以alihbase-2.0.18文件为例）。
```
tar zxvf hbaseue-shell.tar.gz
```
配置连接参数。
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>testuser</value>
    </property>
    <property>
        <name>hbase.client.password</name>
        <value>password</value>
    </property>
</configuration>
```
  参数说明：
  - hbase.zookeeper.quorum：Lindorm宽表引擎的使用HBase Java API访问连接地址。
    - 专有网络地址：适用于Lindorm Shell安装在ECS实例上，且ECS实例与Lindorm实例位于同一VPC。
    - 公网地址：适用于Lindorm Shell安装在本地，或安装在ECS实例但ECS与Lindorm实例不在同一VPC。
  - hbase.client.username和hbase.client.password：访问Lindorm宽表引擎的用户名和密码。如果忘记密码可以通过宽表引擎的集群管理系统修改密码，具体操作请参见修改用户密码。
通过Lindorm 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使用介绍。