超详细HBase 2.2.2单机版安装配置+实战测试+常见问题解决

超详细HBase 2.2.2单机版安装配置+实战测试+常见问题解决

前言

HBase是基于Hadoop的分布式列存数据库，具备高可靠、高并发、海量数据存储的特性，单机版部署简单、资源消耗低，非常适合大数据初学者进行入门学习和功能测试。本文将从安装包部署、环境配置、核心参数优化到实战验证，完整梳理HBase 2.2.2单机版的部署流程，步骤可直接复用，轻松规避常见部署坑。

前置条件

一、上传并解压HBase安装包

1. 上传安装包

将hbase-2.2.2-bin.tar.gz安装包通过XFTP、SCP等工具上传至服务器/opt/software目录。

2. 解压安装包

使用tar命令将安装包解压到指定目录

# 解压安装包到/opt/module目录
tar -zxvf /opt/software/hbase-2.2.2-bin.tar.gz -C /opt/module/

3. 可选：重命名目录（简化后续操作）

若需简化目录名称，可执行重命名命令（不重命名也可正常使用）：

cd /opt/module/
mv hbase-2.2.2 hbase # 重命名为hbase，后续路径可简化为/opt/module/hbase

二、配置HBase系统环境变量

1. 编辑全局环境变量

将HBase添加到系统环境变量，实现全局命令调用：

# 编辑全局环境变量文件（所有用户生效），也可编辑~/.bash_profile仅当前用户生效
vim /etc/profile

2. 添加环境变量配置

在文件末尾添加以下内容（若已重命名目录，需将HBASE_HOME改为/opt/module/hbase）：

# HBase环境变量配置
export HBASE_HOME=/opt/module/hbase-2.2.2
export PATH=$PATH:$HBASE_HOME/bin

3. 使环境变量立即生效

保存退出（Esc→:wq）后，执行以下命令让配置生效：

source /etc/profile

三、配置HBase核心配置文件

进入HBase配置目录，依次修改hbase-env.sh和hbase-site.xml两个核心配置文件，确保HBase正常运行。

1. 配置hbase-env.sh（环境依赖配置）

# 进入HBase配置目录（若已重命名，路径为/opt/module/hbase/conf）
cd /opt/module/hbase-2.2.2/conf

# 编辑环境配置文件
vim hbase-env.sh

在配置文件中添加/修改以下关键配置（注释已标注说明）：

# 1. 指定JDK安装路径（必填，与服务器JDK路径一致）
export JAVA_HOME=/opt/module/jdk1.8.0_261

# 2. 启用HBase自带Zookeeper管理（单机版必备，分布式需改为false）
export HBASE_MANAGES_ZK=true

# 3. 解决Hadoop与HBase类路径冲突问题（去除前面的#注释，必填）
export HBASE_DISABLE_HADOOP_CLASSPATH_LOOKUP="true"

# 4. 可选：指定HBase日志存储目录（默认在HBASE_HOME/logs，可自定义）
# export HBASE_LOG_DIR=/opt/module/hbase-2.2.2/logs

编辑完成后，保存并退出（:wq）。

2. 配置hbase-site.xml（核心功能配置）

编辑HBase核心配置文件，配置单机模式、存储路径、Zookeeper等关键参数：

vim hbase-site.xml

替换为以下完整配置（带详细注释，可根据实际环境调整路径）：

<configuration>
<!– 1. 指定HBase运行模式：false为单机模式，true为分布式模式（必填） –>
<property>
<name>hbase.cluster.distributed</name>
<value>false</value>
</property>

<!– 2. 指定HBase临时文件存储目录（自定义路径，需确保目录可读写） –>
<property>
<name>hbase.tmp.dir</name>
<value>/opt/module/hbase-2.2.2/tmp</value>
</property>

<!– 3. 关闭流能力强制校验（解决HDFS兼容性问题，避免启动报错） –>
<property>
<name>hbase.unsafe.stream.capability.enforce</name>
<value>false</value>
</property>

<!– 4. 指定HBase数据存储根目录（依赖HDFS，需与Hadoop的NameNode地址一致） –>
<property>
<name>hbase.rootdir</name>
<value>hdfs://master:8020/hbase</value>
</property>

<!– 5. 指定Zookeeper数据存储目录（与Zookeeper配置的dataDir一致） –>
<property>
<name>hbase.zookeeper.property.dataDir</name>
<value>/opt/module/zookeeper-3.5.6/data</value>
</property>

<!– 6. 指定HBase Master端口（0.98版本后新增，默认60000，改为16000避免端口冲突） –>
<property>
<name>hbase.master.port</name>
<value>16000</value>
</property>

<!– 7. 可选：指定Zookeeper集群地址（单机版可省略，默认本地） –>
<!– <property>
<name>hbase.zookeeper.quorum</name>
<value>master</value>
</property> –>
</configuration>

保存并退出（:wq），至此HBase核心配置完成。

四、验证HBase安装

1. 查看HBase版本

执行以下命令验证环境变量和安装是否正常：

hbase version

若输出类似以下内容，说明安装及环境配置正常：

HBase 2.2.2
Source code repository git://localhost.localdomain/home/larsgeorge/hbase.git revision=635d990b8a50a228f1f4f7c49f1f93893723379b
Compiled by larsgeorge on Mon May 27 16:15:22 PDT 2019
From source with checksum 2e519a1a1e1c09109a1b6bb0389ee361

2. 前置环境准备（启动依赖服务）

在启动HBase前，需确保Hadoop和Zookeeper已正常启动：

# 1. 启动HDFS（若未启动）
start-dfs.sh

# 2. 启动Zookeeper（若未启动，单机版也可依赖HBase自带ZK，建议单独启动）
zkServer.sh start

# 3. 验证依赖服务状态
jps # 应能看到NameNode、DataNode、QuorumPeerMain（ZK进程）

3. 创建HBase临时目录（可选，避免启动报错）

提前创建hbase.tmp.dir配置的临时目录，确保权限充足：

mkdir -p /opt/module/hbase-2.2.2/tmp
chmod 755 /opt/module/hbase-2.2.2/tmp

五、启动HBase并进行实战测试

1. 启动HBase集群（单机版）

执行以下命令启动HBase：

# 启动HBase
start-hbase.sh

# 验证HBase进程（jps查看，应出现HMaster进程）
jps

正常启动后，jps会显示HMaster进程，说明HBase单机版启动成功。

2. 进入HBase Shell交互模式

通过Shell命令操作HBase，进行表的创建、插入、查询等操作：

# 进入HBase Shell
hbase shell

进入后会显示HBase Shell版本信息，进入交互界面（提示符为hbase(main):001:0>）。

3. 实战操作：表的创建、插入、查询与删除

（1）创建表（表名：student，列族：info）

# 创建表：create '表名', '列族名1', '列族名2'（此处仅创建一个列族info）
create 'student', 'info'

# 查看所有表
list

（2）插入数据（向student表插入行键为1001的学生信息）

# 插入数据：put '表名', '行键', '列族:列名', '值'
put 'student', '1001', 'info:name', 'ZhangSan'
put 'student', '1001', 'info:age', '20'
put 'student', '1001', 'info:gender', 'Male'

# 插入另一行数据（行键1002）
put 'student', '1002', 'info:name', 'LiSi'
put 'student', '1002', 'info:age', '21'

（3）查询数据

# 方式1：查询指定行键的所有数据
get 'student', '1001'

# 方式2：扫描整张表的所有数据
scan 'student'

# 方式3：查询指定行键的指定列族数据
get 'student', '1002', 'info:name'

（4）删除表（需先禁用表，再删除）

# 禁用表
disable 'student'

# 删除表
drop 'student'

# 验证表是否删除
list

4. 退出HBase Shell

# 退出Shell交互模式
quit

5. 停止HBase

若需停止HBase服务，执行以下命令：

# 停止HBase
stop-hbase.sh

六、常见问题排查

1. 问题1：执行hbase version报错，提示类路径冲突

解决方案

确保hbase-env.sh中已添加export HBASE_DISABLE_HADOOP_CLASSPATH_LOOKUP="true"，并去除该行前面的注释，保存后重新加载环境变量。

2. 问题2：启动HBase后，jps看不到HMaster进程

排查步骤

3. 问题3：访问HBase Web UI失败（默认端口16010）

解决方案