阿里云-云小站(无限量代金券发放中)
【腾讯云】云服务器、云数据库、COS、CDN、短信等热卖云产品特惠抢购

HBase 参考文档翻译之 Getting Started

130次阅读
没有评论

共计 10689 个字符,预计需要花费 27 分钟才能阅读完成。

本篇是对 HBase 官方参考文档的大体翻译,介于本人英文水平实在有限,难免有纰漏之处。本篇不只是对官方文档的翻译,还加入了一些本人对 HBase 的理解。在翻译过程中,一些没有营养的废话,我就忽略了没有翻译。本篇按照 2016 年 5、6 月 最新版的 http://hbase.apache.org/book.html 进行翻译,此时:

HBase 参考文档翻译之 Getting Started

而 stable 文件夹中的内容:

HBase 参考文档翻译之 Getting Started

———————————————————————————————————————————————

Getting Started(准备开始)
1、简介
文档将带你搭建和运行一个单节点、单实例的 HBase,随后是一个伪分布式的单机实例,最后是一个完全分布式的集群。
2、快速开始 – 单机模式 HBase
本指南描述的是在本地文件系统中搭建单机模式下的 HBase。对于一个 HBase 生产环境下的实例来说,这是不恰当的配置,但是,在本地测试情况下运行是允许的。本章节将要像你展示使用 HBase shell 命令创建一个表,插入数据,对表进行 put 和 scan 操作,enable 或者 disable 表,并且运行和停止 HBase。除去下载 HBase,整个过程应该不超过十分钟。
在本地文件系统下使用 HBase 不保证耐久性。如果文件未正常关闭,本地 HDFS 文件系统实现将丢失编辑的内容。当你试用新软件时这是很有可能发生的,经常启动和停止守护进程通常是并不干净的。你需要确保在 HDFS 运行 HBase 所有的写入是已经保存了的。针对本地文件系统的运行能够让你快速熟悉怎样生产系统任务,获取第一阶段的评价。关于本地文件系统上的问题更详尽的描述,请访问 HBASE-3696。
在 HBase 0.94.X 版本之前,HBase 期望的 IP 地址是 127.0.0.1。Ubuntu 及一些其他分支默认是 127.0.0.1,这将给你带来麻烦。
*** Example 1. 对于 Ubuntu,HBase 0.94.x 及早期版本正确的配置如下。如果你陷入困境,请使用如下配置。

127.0.0.1 localhost
127.0.0.1 ubuntu.ubuntu-domain ubuntu

2.1、JDK 版本要求
*** HBase 0.98.5 及 更新版本,必须在集群的每一个节点设置 JAVA_HOME。hbase-env.sh 提供了一个便利的机制。

HBase 参考文档翻译之 Getting Started

2.2、开始使用 HBase
步骤:下载,配置,启动。
(1)、从 Apache Download Mirrors 列表中选择一个下载站。它为你提供 HBase 发布版的镜像。点击名为“stable”的文件夹,然后下载以“.tar.gz”结尾的二进制文件到本地文件系统。在 HBase 1.X 版本之前,一定要选择你可能用到的 Hadoop 的更迟版本对应的 HBase 版本(大部分情况下,你应该选择 hadoop 2.X 版本的,类似 hbase-0.98.13-hadoop2-bin.tar.gz)。暂时不下载以“src.tar.gz”结尾的文件。
(2)、解压下载文件,并打开目录。

$ tar xzvf hbase-<?eval ${project.version}?>-bin.tar.gz 
$ cd hbase-<?eval ${project.version}?>/

(3)、对于 HBase 0.98.5 及之后版本,在启动 HBase 前,你需要设置 JAVA_HOME 环境变量。在 HBase 0.98.5 之前,如果没有设置环境变量,HBase 尝试检测 Java 的位置。你可以通过操作系统的一般机制来设置环境变量,但 HBase 提供一个中枢机制 conf/hbase-env.sh。编辑该文件,取消 JAVA_HOME 前的注释符,并设置你本机适当的位置。
*** 这个指令假设集群的每个节点都采用同样的配置。如果不一致,你需要单独设置每个节点。
(4)、编辑 conf/hbase-site.xml 这个 HBase 主配置文件。这时候,你仅需要指定本地文件系统中 HBase 和 Zookeeper 写数据的目录即可。默认是在 /tmp 目录下新建一个目录。许多机器在重启后是会删除 /tmp 目录内容的,所以你需要存储数据到别处。下面的配置将存储 HBase 的数据在 testuser 用户主目录下的 hbase 目录。在标签 <configuration> 下粘贴 <property> 标签,在一个新安装的 HBase 中这应该是个空的。你不要创建 HBase 数据目录。HBase 会为你这么做。如果你创建了目录,HBase 会迁移,而这不是你想要的。
*** Example 2. HBase 的单例模式的 hbase-site.xml 配置:

<configuration>
    <property>
        <name>hbase.rootdir</name>
        <value>file:///home/testuser/hbase</value>
    </property>
    <property>
        <name>hbase.zookeeper.property.dataDir</name>
        <value>/home/testuser/zookeeper</value>
    </property>
</configuration>

(5)、bin/start-hbase.sh 此脚本为启动 HBase 提供了方便的途径。执行命令,在标准输出的日志里可以看到 HBase 启动成功的消息。你可以使用 jps 命令来确认你有一个正在运行的进行 HMaster。在 HBase 的单例模式中,所有的服务都运行在同一 JVM 中,如 HMaster,单例的 HRegionServer 和 ZooKeeper 的守护进程。
步骤:使用 HBase
1)、连接 HBase。
在 HBase 安装目录下 bin/ 目录下使用 hbase shell 命令连接正在运行的 HBase 实例。在下面这个例子中,当你启动 HBase Shell 并忽略打印的一些用法和版本信息后,HBase Shell 是以字符‘>’结尾。

$ ./bin/hbase shell
hbase(main):001:0>

2)、预览 HBase Shell 的帮助文本。
输入 help 并点击回车,可以看到一些基本的 HBase Shell 用法信息,以及一些示例命令。
3)、创建一个表。
使用 create 命令创建一个表,你必须执行一个表名和列族名。

hbase(main):001:0> create 'test', 'cf' 
0 row(s) in 0.4170 seconds 
=> Hbase::Table - test

4)、关于你的表的列表信息。
使用 list 命令:

hbase(main):002:0> list 'test'
TABLE
test
1 row(s) in 0.0180 seconds
=> ["test"]

5)、插入数据到表中。
使用 put 命令插入数据。

hbase(main):003:0> put 'test', 'row1', 'cf:a', 'value1' 
0 row(s) in 0.0850 seconds 
hbase(main):004:0> put 'test', 'row2', 'cf:b', 'value2' 
0 row(s) in 0.0110 seconds 
hbase(main):005:0> put 'test', 'row3', 'cf:c', 'value3' 
0 row(s) in 0.0100 seconds

        在这里,我们往 test 表中依次插入了三条数据。首先插入了一条 rowkey 为 row1、列为 cf:a、值为 value1 的数据。HBase 中的列是包含列族前缀的,在这个例子中,冒号前的为列族 cf,冒号后的为列限定符 a。

6)、扫描表的全部数据。

从 HBase 获取数据的途径之一就是 scan。使用 scan 命令扫描表数据。你可以对扫描做限制,不过现在,获取全部的数据。

hbase(main):006:0> scan 'test' 
ROW       COLUMN+CELL 
row1     column=cf:a, timestamp=1421762485768, value=value1 
row2     column=cf:b, timestamp=1421762491785, value=value2 
row3     column=cf:c, timestamp=1421762496210, value=value3 
3 row(s) in 0.0230 seconds

7)、获取一条数据。

使用 get 命令一次获取一条数据。

hbase(main):007:0> get 'test', 'row1'
COLUMN                    CELL
cf:a                      timestamp=1421762485768, value=value1
1 row(s) in 0.0350 seconds  

8)、禁用一个表。

如果你想删除一个表或者改变表的设置,以及一些其他的场景,首先你需要使用 disable 命令禁用表。你可以使用 enable 命令“反禁用”即启用表。

hbase(main):008:0> disable 'test' 
0 row(s) in 1.1820 seconds 
hbase(main):009:0> enable 'test' 
0 row(s) in 0.1770 seconds

9)、删除表。

使用 drop 命令删除一个表。

hbase(main):011:0> drop 'test' 
0 row(s) in 0.1370 seconds

10)、退出。

使用 quit 命令退出命令行并从集群断开连接。HBase 仍然在后台运行。

步骤:停止 HBase。

1)、bin/start-hbase.sh 这个脚本提供了便利的启动所有 HBase 服务,同样地,bin/stop-hbase.sh 脚本用来停止所有 HBase 服务。

$ ./bin/stop-hbase.sh
stopping hbase....................

2)、在使用这个命令后,它可能需要过几分钟才能停掉服务进程。使用 jps 命令来确认 HMaster 和 HRegionServer 进程是否关闭。

2.3 中级 —– 本地伪分布式安装

在你学习过前面内容后,你要重新配置 HBase 来运行伪分布式模式。伪分布式模式的意思是 HBase 仍然在一台机器上完整的运行,不过,每个 HBase 服务(HMaster,HRegionServer,Zookeeper)是在单独的一个进程中运行。默认的,如果你像上面描述的一样没有配置 hbase.rootdir,你的数据仍然存储在 /tmp 目录下。在本文的稍后部分中,假设你有可用的 HDFS,我们存储数据在 HDFS。你可以略过 HDFS 配置继续存储你的数据在本地文件系统。

(1)、如果正在运行,请先停掉 HBase。

如果你完成了单例模式的 HBase 并且正在运行,请停掉它。这个步骤将完全的创建一个存储 HBase 数据的新目录,所以之前你创建的数据库将丢失。

(2)、配置 HBase。

编辑 hbase-site.xml 进行配置。首先,添加 property,使 HBase 以分布式模式运行,并且一个 JVM 实例化一个守护进程。

<property> 
    <name>hbase.cluster.distributed</name> 
    <value>true</value> 
</property>

接下来,把 hbase.rootdir 的配置从本地文件系统改为你的 HDFS 实例的地址,并使用 hdfs:// 开头的 URL 语法。下面这个例子中,HDFS 是运行在本地端口 8020。

<property>
    <name>hbase.rootdir</name>
    <value>hdfs://localhost:8020/hbase</value>
</property>

你不需要在 HDFS 中创建 /hbase 目录,HBase 会自动创建。不过,如果你创建了 /hbase 目录,HBase 会尝试移动,而这不是你想要的。

(3)、启动 HBase。

使用 bin/start-hbase.sh 命令启动 HBase。如果你配置得当,使用 jps 命令可以查看到 HMaster 和 HRegionServer 进程正在运行。

(4)、检查 HDFS 中 HBase 目录。

如果一切正常,HBase 会在 HDFS 创建目录。在配置文件中,是存储在 HDFS 的 /hbase 目录。你可以使用 hadoop fs 命令查看这个目录。

$ hadoop fs -ls /hbase
Found 7 items
drwxr-xr-x   - hbase users          0 2014-06-25 18:58 /hbase/.tmp
drwxr-xr-x   - hbase users          0 2014-06-25 21:49 /hbase/WALs
drwxr-xr-x   - hbase users          0 2014-06-25 18:48 /hbase/corrupt
drwxr-xr-x   - hbase users          0 2014-06-25 18:58 /hbase/data
-rw-r--r--   3 hbase users         42 2014-06-25 18:41 /hbase/hbase.id
-rw-r--r--   3 hbase users          7 2014-06-25 18:41 /hbase/hbase.version
drwxr-xr-x   - hbase users          0 2014-06-25 21:49 /hbase/oldWALs

(5)、创建一个表,并插入数据。

你可以使用 HBase Shell 创建一个表,插入数据,并 scanget 数据,使用方法和上面一样。

(6)、启动和停止一个 HMaster 备份服务器。

对于生产环境而言在同一个机器上运行多个 HMaster 实例是没有意义的,同样的,在生产环境上运行伪分布式模式也是没有意义的。

HMaster 服务器用来管理 HBase 集群。你可以弄 10 个 HMaster,其中 9 个做备份 HMaster 服务器。使用 local-master-backup.sh 启动备份 HMaster。对于每个你想要启动的 master,可以添加一个参数代表这个 master 的端口。每个 HMaster 使用三个端口,默认是 16010,16020,16030。端口偏移量添加到这些端口,所以偏移量为 2,备份 HMaster 会使用 16012/16022/16032 的端口。以下命令使用 16012/16022/16032, 16013/16023/16033, 和 16015/16025/16035 作为端口号。

$ ./bin/local-master-backup.sh 2 3 5

从整个集群中移除某一个备份 master,你需要找到进程 ID(PID)。PID 存储在名称类似于 /tmp/hbase-USER-X-master.pid 的文件中。你可以使用 kill -9 命令来杀死这个 PID。下面的命令将从正在运行的集群中移除一个端口偏移量为 1 的 master。

$ cat /tmp/hbase-testuser-1-master.pid |xargs kill -9

(7)、启动和停止附加的 RegionServer。

HRegionServer 在 HMaster 的指导下管理 storefile 中的数据。一般的,一个 HRegionServer 在集群的每个节点上运行。伪分布式模式下在一个系统中运行多个 HRegionServer 对于测试是有用的。local-regionservers.sh 命令允许你运行多个 RegionServer。它的工作原理类似于 local-master-backup.sh 命令,你提供的参数代表实例端口偏移量。每个 RegionServer 需要两个端口,默认的是 16020 和 16030。无论怎样,附件的 RegionServer 的基本端口不能使用默认的,因为默认端口被 HMaster 端口占用,这也是 HBase 1.0.0 版本 RegionServer 的一个使用。基本端口用 16200 和 16300 替代。在同一台机器上,你可以运行 99 个附加的 RegionServer,不是 HMaster 或者备份 HMaster。下面这个命令启动 4 个附件的 RegionServer,运行在从 16202/16302 开始连续的端口(16200/16300 端口每次加 2)。

$ .bin/local-regionservers.sh start 2 3 4 5

使用 local-regionservers.sh 命令加上 stop 参数及服务器端口偏移量手动地停止一个 RegionServer 

$ .bin/local-regionservers.sh stop 3

2.4 高级 —–  完全分布式

实际上,你需要一个完全分布式配置并且使用真实情景去完全的测试 HBase。在一个分布式配置中,一个集群包含多个节点,每个节点运行一个或者多个 HBase 守护进程。他们包含主 HMaster 和备份 HMaster 实例,多个 Zookeeper 节点,和多个 RegionServer 节点。

添加大于两个的节点到你的集群,实例如下:

表 1. 分布式集群样例模板

HBase 参考文档翻译之 Getting Started

这个示例采取每个节点是在同一网段的虚拟机。分布式模式的搭建是根据之前的伪分布式的搭建,假设之前的配置步骤是在现在的 node-a 节点。停止掉 HBase 后再继续。

!请确保每个节点的防火墙关闭。

步骤:配置 SSH 互信

(略过,请自行 Google 或者某度!)

步骤:准备节点 node-a

node-a 节点用来运行主 master 和 Zookeeper 进程,不过没有 RegeionServer。

(1)、编辑 cong/regionservers,并且移除 lcoalhost 行。然后添加 node-b 和 node-c 的主机名或者 IP 地址。

如果你想要在节点 node-a 节点运行 RegionServer,你应该确保各主机间能够相互通信。这使你可以配置分发到任何主机冲突的节点。保存文件。

(2)、配置 HBase 使 node-b 节点作为备份 master。

创建一个新的文件 conf/backup-masters,并添加新的一行主机名 –node-b。在本例中,主机名是 node-b.example.com。

(3)、配置 Zookeeper。

实际上,你需要小心的考虑 Zookeeper 的配置。关于 Zookeeper 的更多配置,下面有专门解释。

在节点 node-a,编辑 conf/hbase-site.xml,添加以下配置。

<property>
    <name>hbase.zookeeper.quorum</name>
    <value>node-a.example.com,node-b.example.com,node-c.example.com</value>
</property>
<property>
    <name>hbase.zookeeper.property.dataDir</name>
    <value>/usr/local/zookeeper</value>
</property>

步骤:准备 node-c 和 node-b

node-c 上将要运行备份 master 和 一个 Zookeeper 实例。

(1)、下载和解压 HBase

下载和解压 HBase 到 node-b,就像之前单机模式和为分布式模式一样。

(2)、从 node-a 节点复制配置文件到 node-b 和 node-c。

集群上每个节点都应该保持同样的配置。复制目录 conf/ 内容到 node-b 和 node-c 目录下。

步骤:启动和测试你的集群

(1)、在各节点上确认 HBase 没有运行。

如果之前测试的时候你忘记停掉 HBase,你将要报错的。使用 jps 命令检验每台机器上的 HBase 是否运行。看下是否存在进程 HMaster、HRegionServer、HQuorumPeer,如果存在,kill 掉。

(2)、启动集群。

在节点 node-a 上,执行 start-hbase.sh 命令。你将看到和下面相似的输出。

$ bin/start-hbase.sh
node-c.example.com: starting zookeeper, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-h         buser-zookeeper-node-c.example.com.out
node-a.example.com: starting zookeeper, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-h        buser-zookeeper-node-a.example.com.out
node-b.example.com: starting zookeeper, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-h        buser-zookeeper-node-b.example.com.out
starting master, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-hbuser-master-node-a.exa            mple.com.out
node-c.example.com: starting regionserver, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-        hbuser-regionserver-node-c.example.com.out
node-b.example.com: starting regionserver, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-        hbuser-regionserver-node-b.example.com.out
node-b.example.com: starting master, logging to /home/hbuser/hbase-0.98.3-hadoop2/bin/../logs/hbase-hbus        er-master-nodeb.example.com.out

首先启动 Zookeeper,然后是 master,然后是 RegionServer,最后是 备份 master。

(3)、检验进程是否运行。

在每台节点上运行 jps 命令,检验每个机器上的相应进程是否运行。

Example 3. node-a jps Output

$ jps
20355 Jps
20071 HQuorumPeer
20137 HMaster

Example 4. node-b jps Output

$ jps
15930 HRegionServer
16194 Jps
15838 HQuorumPeer
16010 HMaster

Example 5. node-a jps Output

$ jps
13901 Jps
13639 HQuorumPeer
13737 HRegionServer

!Zookeeper 进程名

HQuorumPeer 进程是用来管理和启动 HBase 的 Zookeeper 实例。如果你按照这种方式使用 Zookeeper,那么他将被限制在集群每个节点上运行一个实例,这只是适用于测试。如果 Zookeeper 是运行在 HBase 外,进程名即是 QuorumPeer。

(4)、浏览器 WEB UI

在 HBase 0.98.X 更高版本,HBase Web 界面的 HTTP 端口从 Master 的 60010 和 每个 RegionServer 的 60030 改变为 Master 的 16010 和 RegionServer 的 16030。

如果一切准备妥当,你应该能够使用 web 浏览器连接到 Master http://node-a.example.com:16010/ 和第二 Master 的 http://node-b.example.com:16010/。如果你可以通过 localhost 连接,但不能从其他主机连接,请检查你的防火墙配置。

(5)、测试节点或者服务器消失会发生什么。

如上配置的三个节点的集群,并不是有弹性的。尽管如此,你仍然可以测试当主 Master 或者 RegionServer 消失发生什么,杀死进程并查看日志。

3、下一站

下一章节,将要讲述关于 HBase 相关的信息,关于不同 HBase 的运行模式,HBase 的运行时系统配置,一个分布式 HBase 集群的临界配置区域。

Hadoop+HBase 搭建云存储总结 PDF http://www.linuxidc.com/Linux/2013-05/83844.htm

Ubuntu Server 14.04 下 Hbase 数据库安装  http://www.linuxidc.com/Linux/2016-05/131499.htm

HBase 结点之间时间不一致造成 regionserver 启动失败 http://www.linuxidc.com/Linux/2013-06/86655.htm

Hadoop+ZooKeeper+HBase 集群配置 http://www.linuxidc.com/Linux/2013-06/86347.htm

Hadoop 集群安装 &HBase 实验环境搭建 http://www.linuxidc.com/Linux/2013-04/83560.htm

基于 Hadoop 集群的 HBase 集群的配置 http://www.linuxidc.com/Linux/2013-03/80815.htm‘

Hadoop 安装部署笔记之 -HBase 完全分布模式安装 http://www.linuxidc.com/Linux/2012-12/76947.htm

单机版搭建 HBase 环境图文教程详解 http://www.linuxidc.com/Linux/2012-10/72959.htm

HBase 的详细介绍 :请点这里
HBase 的下载地址 :请点这里

本文永久更新链接地址 :http://www.linuxidc.com/Linux/2016-08/134271.htm

正文完
星哥说事-微信公众号
post-qrcode
 
星锅
版权声明:本站原创文章,由 星锅 2022-01-21发表,共计10689字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
【腾讯云】推广者专属福利,新客户无门槛领取总价值高达2860元代金券,每种代金券限量500张,先到先得。
阿里云-最新活动爆款每日限量供应
评论(没有评论)
验证码
【腾讯云】云服务器、云数据库、COS、CDN、短信等云产品特惠热卖中