hbase-default.xml（Hbase 默认参数翻译）

hbase.tmp.dir ${java.io.tmpdir}/hbase-${user.name} 本地文件系统上的临时目录。将'/tmp'改为其他可以持久保存文件的位置，通常能够解决java.io.tmpdir。'/tmp'目录在机器重启后将会被清空。 hbase.rootdir ${hbase.tmp.dir}/hbase 该目录被region server共享并且用来保存HBase的持久化数据。这个URL应该完全按照文件系统模式的格式来指定。例如，假定使用HDFS目录'/hbase'，并且HDFS的namenode运行在namenode.example.org的9000端口上，那么，该值应该是： hdfs://namenode.example.org:9000/hbase。默认情况下，我们也应该将${hbase.tmp.dir}以这种格式进行设置，通常${hbase.tmp.dir}目录的值为/tmp。因此需要该变该值以可以防止数据在机器重启后丢失。 hbase.cluster.distributed false 该值指定了集群运行的模式。如果该值为false，表示运行在单机模式，如果该值为true，表示运行在分布式模式。当该值为false时，将会在同一个JVM中启动HBase和Zookeeper的守护进程。 hbase.zookeeper.quorum localhost Zookeeper服务器使用逗号分隔（这个配置项应该被命名为hbase.zookeeper.ensemble）。例如，"host1.mydomain.com,host2.mydomain.com,host3.mydomain.com"。默认该值被设置为localhost以便单机模式和伪分布式模式进行操作。对于完全分布式模式，它应该被设定为Zookeeper服务器的列表。如果hbase-env.sh中设定了HBASE_MANAGES_ZK，那么当集群启动/关闭的时候，也会按照该值启动/关闭Zookeeper。在客户端，我们将确定这个列表的值并且将该值与hbase.zookeeper.clientPort的值组合到一起，然后作为一个字符串参数传递给zookeeper的构造器。 hbase.local.dir ${hbase.tmp.dir}/local/ 本地文件系统的目录，用作本地存储。 hbase.master.info.port 16010 HBase Master的web界面。如果你不想使用web界面，那么将该值设置为-1。 hbase.master.info.bindAddress 0.0.0.0 HBase Master的web界面的地址。 hbase.master.logcleaner.plugins org.apache.hadoop.hbase.master.cleaner.TimeToLiveLogCleaner WAL/HLog清理程序。类名之间以逗号分割，类会被LogsCleaner服务顺序调用，这样就可以删除最早的HLog文件。用户可以实现自己的日志清理程序，只需要在HBase的classpath中加入完整的类名，将上述的日志清理类将hbase-site.xml文件中的默认设置覆盖即可。 hbase.master.logcleaner.ttl 600000 HLog文件在.oldlogdir目录中最长的生命周期，一旦超过这个值，HLog就会被Master的线程清理掉。 hbase.master.hfilecleaner.plugins org.apache.hadoop.hbase.master.cleaner.TimeToLiveHFileCleaner HFile清理程序。类名之间以逗号分割，类会被HFileCleaner服务顺序调用，这样可以删除最早的HFile文件。用户可以实现自己的HFile清理程序，只需要在HBase的classpath中加入完整的类名，将上述的HFile清理类将hbase-site.xml文件中的默认设置覆盖即可。 hbase.master.catalog.timeout 600000(1分钟) master监控.META目录的超时时间。 hbase.master.infoserver.redirect true 无论Master是否监听了Master的网页UI端口(hbase.master.info.port)，都将请求重定向到Master和RegionServer共享的网页UI服务器。 hbase.regionserver.port 16020 HBase RegionServer绑定的端口。 hbase.regionserver.info.port 16030 这是HBase RegionServer的网页UI端口。如果你不想运行RegionServer的网页UI，就将该值设置为-1。 hbase.regionserver.info.bindAddress 0.0.0.0 HBase RegionServer网页UI的绑定地址 hbase.regionserver.info.port.auto false Master或RegionServer是否应该寻找绑定的UI端口。如果hbase.regionserver.info.port已经在使用，就启用自动端口寻找功能。该值在测试时很有用，默认被关闭。 hbase.regionserver.handler.count 30 在RegionServer上统计RPC监听器实例的数量。同样的属性被master用来统计master处理器的数量。 hbase.ipc.server.callqueue.handler.factor 0.1 用来确定请求队列的数目。值为0表示所有的处理器共享一个队列，值为1表示每一个处理器都拥有自己的队列。 hbase.ipc.server.callqueue.read.ratio 0 将所有的请求队列分为读和写两种队列。指定的间隔（在0.0和1.0之间）将被用来和呼叫队列数相乘。值为0表示没有对呼叫队列进行切分，意味着读和写请求将被放入同一个队列集合中。值小于0.5表示读队列比写队列少。值为0.5表示渡河写队列的数目相同。值超过0.5表示读队列比写队列多。值为1.0表示除了一个队列之外的其他所有队列都用于分派读请求。 例如，假定请求队列数目为10。 read.ratio值为0表示：10个队列都包含读/写请求。 read.ratio值为0.3表示：3个队列只包含读请求，7个队列只包含写请求。 read.ratio值为0.5表示：5个队列只包含读请求，5个队列只包含写请求。 read.ratio值为0.8表示：8个队列只包含读请求，2个队列只包含写请求。 read.ratio值为1表示：9个队列只包含读请求，1个队列只包含写请求。 hbase.ipc.server.callqueue.scan.ratio 0 给定读请求队列的数目。根据总的请求队列乘以callqueue.read.ratio和scan.ratio属性值，来将读请求队列分为短读队列和长读队列。 值小于0.5表示长读队列比短读队列少。 值为0.5表示长读队列和短读队列一样多。 值大于0.5表示长读队列比短读队列多。 值为1表示对get和scan操作使用相同的队列集合。 例如：假定读请求队列的数目是8。 scan.ratio为0或者1表示：8个队列中既包含长读队列也包含短读队列。 scan.ratio为0.3表示：2个队列只包含长读请求，6个队列只包含短读请求。 scan.ratio为0.5表示：4个队列只包含长读请求，4个队列只包含短读请求。 scan.ratio为0.8表示：6个队列只包含长读请求，2个队列只包含短读请求。 hbase.regionserver.msginterval 3000(3秒) RegionServer和Master之间传递消息的时间间隔，单位是毫秒。 hbase.regionserver.regionSplitLimit 2147483647 如果在线的region数目超过该值，则不再进行split。该值不是一个硬性限定，但是它会指导regionserver在一个确定的限定值后就不再进行split操作。默认值是MAX_INT。设置为1就可以关闭自动split。 hbase.regionserver.logroll.period 3600000(1小时) 在这段时期内，所有的日志都会提交到同一个文件中。也就是说，每隔1小时（默认值），就会打开一个新的日志文件。单位是毫秒，默认值是1小时。 hbase.regionserver.logroll.errors.tolerated 2 日志轮转时，能承受的最大WAL Writer关闭失败次数。值为0时，当日志轮转时如果WAL Writer关闭失败，那么region server就会终止。即使是一个比较小的值(2或者3)也会使得在HDFS错误出现时，region server能有机会将错误修复。 hbase.regionserver.hlog.reader.impl org.apache.hadoop.hbase.regionserver.wal.ProtobufLogReader HLog file reader 的实现。 hbase.regionserver.hlog.writer.impl org.apache.hadoop.hbase.regionserver.wal.ProtobufLogWriter HLog file writer 的实现。 hbase.master.distributed.log.replay true 控制日志的split是在region的reopen前执行还是reopen后执行。如果是true表示在reopen后执行,否则相反。 'distributed log replay'作为服务器宕机时的默认切分WAL文件的引擎。在hbase 1.0中有新的默认值。为了兼容旧的'分布式日志切分器'，需要将该值设置为false。'Disributed log replay'减少了MTTR(Mean Time To Restoration，平均恢复时间)。因为它不需要写一些中间文件。'DLR'需要将'hfile.format.version'设置为3或者更高。 hbase.regionserver.global.memstore.size 0.4 单个region server的全部memstore的最大值。一旦超过这个值，一个新的更新操作会被挂起，强制执行刷写操作。默认值是堆的40%。直到单个region server上的全部memstore达到了hbase.regionserver.global.memstore.size.lower.limit，被挂起的更新操作和刷写操作会被强制执行。 hbase.regionserver.global.memstore.size.lower.limit 0.95 在被强制刷写之前，单个region server上的全部memstore所能达到的最大数目。默认值是hbase.regionserver.global.memstore.size的95%。一旦达到100%，即该值与hbase.regionserver.global.memstore.size相等时，更新操作由于memstore限制被阻塞时，系统会以尽可能小的刷写量刷写数据。 hbase.regionserver.optionalcacheflushinterval 3600000(1小时) 一个edit在内存中的最大生存时长，默认3600000毫秒，即1小时。设置为0的话则禁止自动flush。 hbase.regionserver.catalog.timeout 600000(10分钟) regionserver的Catalog监控.META.的超时时间。 hbase.regionserver.dns.interface default region server报告自己IP地址的dns接口。 hbase.regionserver.dns.nameserver default region server使用的dns主机名或者IP。 hbase.regionserver.region.split.policy org.apache.hadoop.hbase.regionserver.IncreasingToUpperBoundRegionSplitPolicy 当一个region进行split操作时使用的具体方法。当前可用的split方法有：ConstantSizeRegionSplitPolicy、 DisabledRegionSplitPolicy、DelimitedKeyPrefixRegionSplitPolicy、KeyPrefixRegionSplitPolicy等。 zookeeper.session.timeout 90000(90秒) ZooKeeper会话超时时间。单位是毫秒。它被用于两种不同的情况。其一，这个值被ZooKeeper客户端在和HBase建立链接时使用。它也被HBase用来启动Zookeeper服务器作为建立绘画的最大超时时间-'maxSessionTimeout'。查看 http://hadoop.apache.org/zookeeper/docs/current/zookeeperProgrammers.html#ch_zkSessions。 例如，如果HBase region server连接被HBase管理的Zookeeper，会话超时时间将会由这个配置项指定。但是连接Zookeeper的region服务器使用和Zookeeper的该配置不同的值来进行链接时，将会使用Zookeeper的该配置的值。因此，尽管可能HBase指定的超时时间是90秒，但是如果Zookeeper指定的时间比90秒更少，那么Zookeeper的配置将会被优先使用。当前Zookeeper的默认值是40秒，比HBase默认的该值要低。 zookeeper.znode.parent /hbase HBase在ZooKeeper中的根ZNode。 所有HBase的ZooKeeper文件的路径都使用了在这个node下的相对路径。 默认情况下，所有HBase的ZooKeeper文件路径都配置成了相对路径。因此，除非被改变，否则它们都会到这个目录下进行操作。 zookeeper.znode.rootserver root-region-server 保存根region位置的ZNode路径，这个值由master来更新，由客户端和region服务器来读取。如果将其设置为一个相对地址，父目录就是 ${zookeeper.znode.parent}。默认情况下，根region位置的存储路径是/hbase/root-region-server。 zookeeper.znode.acl.parent acl 根ZNode的访问控制列表。 hbase.zookeeper.dns.interface default 汇报自己IP地址的Zookeeper服务器的网络接口名。 hbase.zookeeper.dns.nameserver default ZooKeeper服务器用来确定正在通信的master的主机名的域名服务器(DNS)的主机名或IP地址。 hbase.zookeeper.peerport 2888 ZooKeeper服务器之间彼此通信使用的接口。查看http://hadoop.apache.org/zookeeper/docs/r3.1.1/zookeeperStarted.html#sc_RunningReplicatedZooKeeper 可以找到更多信息。 hbase.zookeeper.leaderport 3888 在ZooKeeper领导选举中使用的端口地址。 查看http://hadoop.apache.org/zookeeper/docs/r3.1.1/zookeeperStarted.html#sc_RunningReplicatedZooKeeper 可以找到更多信息。 hbase.zookeeper.useMulti false Zookeeper支持多重更新功能。它将使Zookeeper操作完成的更快并且能防止一些很难出现的复制失败问题（可以查看 HBASE-2611的作为一个实例）。重要的是：只有在集群中Zookeeper服务器的版本是3.4以上的时候，该值才能被设置为true。Zookeeper在3.4之前的版本不支持多重更新并且如果多重更新被调用会引发故障（查看ZOOKEEPER-1495）。 hbase.config.read.zookeeper.config false 该值为true的时候会允许HBaseConfiguration从zoo.cfg中读ZooKeeper的属性值，默认为false。切换该值为true不被推荐，因为从zoo.cfg中读取ZK的属性已经被废弃了。 hbase.zookeeper.property.initLimit 10 ZooKeeper的配置文件zoo.cfg中的属性，表示同步个数限制，默认10个。 hbase.zookeeper.property.syncLimit 5 ZooKeeper的配置文件zoo.cfg中的属性，表示同步时每次请求和响应的条数，默认是5个。 hbase.zookeeper.property.dataDir ${hbase.tmp.dir}/zookeeper ZooKeeper的配置文件zoo.cfg中的属性，snapshot存放的目录，默认是${hbase.tmp.dir}/zookeeper。 hbase.zookeeper.property.clientPort 2181 ZooKeeper的配置文件zoo.cfg中的属性，client连zk的端口，默认2181。 hbase.zookeeper.property.maxClientCnxns 300 ZooKeeper的配置文件zoo.cfg中的属性，允许接入zk的最大并发连接数的限制，按ip分配，默认300。当HBase运行在单机模式和伪分布式模式时，应该给将该值调高以防止zk连接出现问题。 hbase.client.write.buffer 2097152(2*1024*1024字节) HTable客户端写缓冲的默认字节大小。该值越大消耗的内存越多 -- 由于服务器端也需要消耗内存来处理传入 的数据，客户端与服务器端都会消耗更多的内存 -- 较大的缓冲区有助于减少RPC的调用次数。例如，服务器端的消耗大概等于 hbase.client.write.buffer * hbase.regionserver.handler.count。 hbase.client.pause 100 通常的客户端暂停时间。最多的用法是客户端在重试前的等待时间。比如失败的get操作和region查询操作等都很可能用到。 查看hbase.client.retries.number的描述以便了解这个暂停的初始值以及如果写/读仍然失败之后的避退策略。 hbase.client.retries.number 35 最大重试次数。例如，region查询、get和update操作等发生错误时最大重试次数的值。 重试的间隔时间为hbase.client.pause。刚开始使用一个初始的时间间隔，如果仍然失败会使用避退的时间间隔。可以查看HConstants#RETRY_BACKOFF来了解具体的避退策略。请根据你的工作负载来设置该值和hbase.client.pause的值。 hbase.client.max.total.tasks 100 一个HTable实例可以提交给集群的最大并发任务数，默认是100。 hbase.client.max.perserver.tasks 5 一个HTable实例给一台regionserver提交的最大并发任务数，默认是5。 hbase.client.max.perregion.tasks 1 客户端并发连接一个region的最大连接数，换句话说，当在region有hbase.client.max.perregion.tasks个写正在处理时，新的Put操作是不会被发送到这个region的，直到该region上的写操作执行完为止，默认是1。 hbase.client.scanner.caching 100 扫描器调用next方法的时候发现本地客户端内存的数据已经取完，就会向服务器端发起请求，该值就是扫描器调用next方法一次性从服务器返回的最大行数。该值越大，扫描器整体的返回速度就越快，但同时依赖的内存也就越多，并且当请求的数据没有在内存命中的话，next方法的返回时间可能会更长，因此要避免这个时间长于扫描器超时的时间。即hbase.client.scanner.timeout.period。 hbase.client.keyvalue.maxsize 10485760(10*1024*1024字节) 设置KeyValue实例大小的上限，这是为了协助设置存储文件中单个条目存储的上限。这种做法有利于避免region过大但不能被拆分的现象。最好将其设置为最大的region大小。如果用户想绕开这个检查，可以将这个参数设置为0或者更少。 hbase.client.scanner.timeout.period 60000(1分钟) 客户端扫描器的超时时间，单位是毫秒。 hbase.client.localityCheck.threadPoolSize 2 做localityCheck的线程池大小，默认是2。 hbase.bulkload.retries.number 0 做bulk load的最大重试次数，默认是0，即代表不断重试。 hbase.balancer.period 300000(5分钟) 在Master节点中运行region负载均衡器的周期。 hbase.balancer.backupMasterWeight 1 用来控制相对于普通的region server，region均衡器能分配给多少个region给备份Master。默认值为1代表着备份Master能拥有和普通region server一样多的region。权重越大，备份Master将持有的region数就越少。如果该权重小于1，那么均衡器将不会分配region给备份Master。 hbase.regions.slop 0.2 如果有regionserver的region数目超过average + (average * slop)，则重新balance，默认是0.2。 hbase.server.thread.wakefrequency 10000 两次查询工作的间隔时间，单位为毫秒。通常被用作像log roller这样的服务线程的休息间隔时间。 hbase.server.versionfile.writeattempts 3 退出前写version file文件的重试次数，默认值是3，每次尝试的间隔由参数hbase.server.thread.wakefrequency控制。 hbase.hregion.memstore.flush.size 134217728(128*1024*1024字节) 如果Memstore的大小超过这个值，Memstore的数据就会刷写到磁盘中。这个值由一个线程每隔hbase.server.thread.wakefrequency检查一次。 hbase.hregion.preclose.flush.size 5242880 当我们要关闭一个region，而该region的memstore的大小大于这个值，那么就会先运行“预刷写”操作，清理这个需要关闭的memstore，然后再将这个region下线。在关闭region时，关闭标签会触发一次清空内存的刷写。在region处于下线过程中时，我们就无法再对其进行任何写操作了。如果一个memstore的内容很大，刷写磁盘的操作就会消耗很多时间。预刷写操作意味着在region被打上关闭标签之前，会先把memstore清空。这样在最终执行关闭操作的时候，带关闭操作的刷写速度会很快。 hbase.hregion.memstore.block.multiplier 4 如果memstore达到了hbase.hregion.memstore.block.multiplier 乘以hbase.hregion.memstore.flush.size的大小，就会阻塞更新操作。这是为了预防在更新高峰期或导致的失控。如果不设上界，刷写的时候会花费很长的时间来合并或者拆分，最坏的情况会引发OOME异常。 hbase.hregion.memstore.mslab.enabled true 启动本地MemStore分配缓冲区(MemStore-Local Allocation Buffer)，这个特性是为了防止在大量写负载的时候堆的碎片太多。这将降低大堆中垃圾回收的频率。 hbase.hregion.max.filesize 10737418240 (10*1024*1024*1024字节) HFile的最大大小。如果一个region的HFile总的大小超过了这个上线，那么它会被拆分为两个region。 hbase.hregion.majorcompaction 604800000(7天) 两次major合并的间隔时间，单位是毫秒。默认值是7天。将其设置为0可以禁用major合并。当用户请求major合并或者满足major合并要求时将会进行。该值乘以hbase.hregion.majorcompaction.jitter的值以便在一个给定的时间窗口期间的一个随机时间来开启major合并操作。major合并可能会导致集群无法访问，你可以在你的配置中将它设置为在低峰时段运行，或者通过将它设置为0而禁用它，或者通过另外一种额外的机制来定时运行major合并操作。 hbase.hregion.majorcompaction.jitter 0.50 合并的时间不仅仅是由hbase.hregion.majorcompaction指定的，也就是说，hbase.hregion.majorcompaction并不是一个严格的时间。合并时间是存在抖动的。这个参数就是这个抖动的比例。假如该值和hbase.hregion.majorcompaction都使用默认值，则最终的合并时间在（7-7*0.5）~（7+7*0.5）之间。所以该值越小，合并的时间就会越接近hbase.hregion.majorcompaction指定的时间。 hbase.hstore.compactionThreshold 3 如果在一个Store（一个MemStore的一次刷写将产生一个一个StoreFile文件）中的StoreFile文件超过了该值，那么将会产生将会产生一个合并操作，该操作将多个StoreFile文件合并成一个StoreFile。该值越大意味着合并操作会延迟，但是当合并发生的时候，也会花费更长的时间。 hbase.hstore.flusher.count 2 刷写线程的数量。线程数越少，MemStore的刷写操作将会被排成队列。线程数越多，刷写将会并行执行，也将会增加HDFS的负载，并且也可能会引发更多的合并操作。 hbase.hstore.blockingStoreFiles 10 如果一个Store中StoreFile文件的数目（每次MemStore刷写到磁盘都会产生一个StoreFile文件）大于这个阈值，那么对这个region的更新操作就会被阻塞，直到合并操作完成或者一直阻塞到超过hbase.hstore.blockingWaitTime。 hbase.hstore.blockingWaitTime 90000 一个region的StoreFile数目达到了hbase.hstore.blockingStoreFiles设置的值后，它会阻塞对其他客户端的更新请求。超过当前设定的时间之后，即使合并没有完成，也会停止对更新操作的阻塞。 hbase.hstore.compaction.min 3 可以进行合并的StoreFile在一次合时并必须满足的最小的StoreFile数目。设置hbase.hstore.compaction.min的值是为了防止太多的小的StoreFile被合并。将该值设置为2将会导致一次minor合并每次只能合并2个StoreFile，并且这样可能不太恰当。如果你将该值设定的过大，其他的值也需要被适当的调整。大多数情况下，默认值是适当的。在之前的HBase版本中，hbase.hstore.compaction.min被称为hbase.hstore.compactionThreshold。 hbase.hstore.compaction.max 10 每次minor合并所要处理的最大的StoreFile数目，无论需要合并的数目是多少。hbase.hstore.compaction.max的值控制着单次合并完成所要花费的时间。将这个值设定的更大意味着一次合并将包括更多的StoreFile文件。大多数情况下，默认值是适当的。 hbase.hstore.compaction.min.size 134217728(128*1024*1024字节) StoreFile文件的大小如果小于该值，那在minor合并的时候，肯定会将该文件加入。会通过hbase.hstore.compaction.ratio来评估故HFile的大小，看它们在minor合并时是否应该被加入。因为该值代表着所有如果小于该值的StoreFile会被“自动加入”。如果在频繁写的环境中，刷写操作可能会产生很多大小在1~2MB的StoreFile文件，那么该值就应该被适当减小。因为这些小文件在合并之后很可能会继续触发合并操作。如果该值减小，合并的触发检查也会更加迅速。在早期的HBase版本中，如果该参数不设置可能会有一些问题。但是现在的大多数环境下，已经不再需要改变该参数了。该参数默认值是：128MB。 hbase.hstore.compaction.max.size 9223372036854775807 如果一个StoreFile的大小比该值还大，那么当minor合并发生时，该StoreFile就会被排除在外。把hbase.hstore.compaction.max.size的值增大带来的影响是很小的，大的StoreFile不会经常被合并。如果你觉得压缩的太频繁没有多少好处，那么可以将该值提高。默认值是LONG.MAX_VALUE，单位是字节。 hbase.hstore.compaction.ratio 1.2F 对于minor合并，该值被用来确定是否一个大小比hbase.hstore.compaction.min.size指定的值大的StoreFile可以进行合并。它通常用来限制大StoreFile的合并。 hbase.hstore.compaction.ratio是一个浮点数。该值越大，比如取值10，将会导致生成一个巨大的StoreFile文件。相反的，该值越小，比如取值0.25，将会和BigTable的合并算法类似 ，产生四个StoreFile文件。该值的推荐值在1.0到1.4之间。调整该值，你可以平衡写操作和读操作的消耗。将该值增大（比如1.4）,将会导致更多的写消耗，因为你需要合并更大的StoreFile文件。然而，在读操作期间，HBase需要寻找几个StoreFile文件就可以完成读操作。如果你没有使用布隆过滤器，你可以考虑该方法。否则，你可以降低该值到1.0来减少写操作的损耗，并且使用布隆过滤器来控制读操作期间的损耗。在大多数情况下，默认值是适用的。 hbase.hstore.compaction.ratio.offpeak 5.0F 对于确定是否一个大StoreFile文件是否在非高峰时段的合并过程中应该被加入，允许你设置一个不同的（通常情况下，更积极）比值。和hbase.hstore.compaction.ratio的工作方式相同。 但仅仅在hbase.offpeak.start.hour和hbase.offpeak.end.hour启用的时候会被应用。 hbase.hstore.time.to.purge.deletes 0 含有删除标记的那些值被完全删除的延迟时间。如果不设定该值，或者设定该值为0，那么在major合并期间，含有删除标记的记录将会被完全删除。 否则，在major合并期间，那些含有删除标记的记录会在时间（删除标记的时间戳加上该值）才会被完全删除。 hbase.offpeak.start.hour -1 非高峰时间段的开始时间。使用整数0-23来表示。设置为-1将禁止使用非高峰时段。 hbase.offpeak.end.hour -1 非高峰时段的结束时间。使用整数0-23来表示。设置为-1将禁止使用非高峰时段。 hbase.regionserver.thread.compaction.throttle 2560 合并时有两个不同的线程池，一个用于大合并，一个用于小合并。这有助于保证瘦表(例如hbase:meta) 合并快速完成。如果有一个大于该阈值的合并，它将会进入大合并池。在多数情况下，默认值是合适的。 默认值：2 x hbase.hstore.compaction.max x hbase.hregion.memstore.flush.size (默认值为128)。 该值假定hbase.hregion.memstore.flush.size使用默认值。 hbase.hstore.compaction.kv.max 10 进行刷写或合并操作时，一次批量读和写的KeyValue的最大数目。如果你有的KeyValue很大，并且可能会有OOM(Out Of Memory Exceptions)异常，那么将该值调小。反之，将该值调大。 hbase.storescanner.parallel.seek.enable false 在StoreScanner中启用并行查询，这样可以在一定条件下减少响应延迟。 hbase.storescanner.parallel.seek.threads 10 如果并行查找特性被启用，该值表示默认的线程池大小。 hfile.block.cache.size 0.4 用于StoreFile的块缓存使用最大堆(设置-Xmx)的百分比。默认的0.4意味着分配了40%.设置成0将禁用块缓存，但是不推荐这样做。你至少需要足够的 缓存来保存一些storefile。 hfile.block.index.cacheonwrite false 当索引被写入时是否允许插入非根的多层索引块到块缓存。 hfile.index.block.max.size 131072 当多层块索引的叶子层、中间层或者根的索引块的大小超过了该值，块将会写入完成并且开始一个新的块。 hfile.format.version 3 HFile的格式化版本号。现在已经在HFile的版本3中加入了对标签的支持 (查看 http://hbase.apache.org/book.html#hbase.tags)。 分布式日志回访需要启用标签。 hfile.block.bloom.cacheonwrite false 启用一个组合布隆过滤器的内联(inline)块的写缓存。 io.storefile.bloom.block.size 131072 组合布隆过滤器的单个块("chunk")的字节大小。 这个大小是大概值，因为布隆块仅仅在数据块的边界被插入，并且 每个数据块中包含的键(key)数目也不同。 hbase.rs.cacheblocksonwrite false 当块完成的时候，该HFile块是否应该被加入块缓存。 hbase.rpc.server.engine org.apache.hadoop.hbase.ipc.ProtobufRpcServerEngine org.apache.hadoop.hbase.ipc.RpcServerEngine的实现。用于服务器RPC调用。 hbase.rpc.timeout 60000 该值用于定义HBase客户端应用执行RPC远程调用需要花费的时间。它通常用来检查连接连通情况，但是最终会 抛出一个TimeoutException异常。 hbase.rpc.shortoperation.timeout 10000 这是另一个版本的"hbase.rpc.timeout"。对于那些集群中的RPC操作，我们使用该配置来对短操作设定一个超时限定。 例如，短的rpc超时用于服务器给master报告活动状态的时候，这将有利于master进行容灾处理。 hbase.ipc.client.tcpnodelay true 设置rpc套接字链接是否延迟。查看 http://docs.oracle.com/javase/1.5.0/docs/api/java/net/Socket.html#getTcpNoDelay()可以获取更多信息。 hbase.master.keytab.file 用于登录配置的HMaster服务器实体(HMaster server principal)的kerberos keytab文件的完整路径。 hbase.master.kerberos.principal 例如， "hbase/_HOST@EXAMPLE.COM"。HMaster进程运行时需要使用kerberos实体(kerberos principal)，实体可以使用这种格式：user/hostname@DOMAIN。 如果"_HOST"部分使用主机名，它在实际运行的时候将使用主机名来替代。 hbase.regionserver.keytab.file 用于登录配置的HRegionServer服务器实体(HRegionServer server principal)的kerberos keytab文件的完整路径。 hbase.regionserver.kerberos.principal 例如， "hbase/_HOST@EXAMPLE.COM"。HRegionServer进程运行时需要使用kerberos实体(kerberos principal)，实体可以使用这种格式：user/hostname@DOMAIN。 如果"_HOST"部分使用主机名，它在实际运行的时候将使用主机名来替代。这个实体的入口必须在hbase.regionserver.keytab.file文件中指定。 hadoop.policy.file hbase-policy.xml 用于HBase客户端请求发起时，RPC服务器做出认证决策的决策配置文件。仅仅当HBase启用了安全配置时可用。 hbase.superuser 在集群中拥有所有权利，可以无视ACLs文件，即HBase集群的超级用户或组，使用逗号分割。仅仅当HBase启用了安全配置时可用。 hbase.auth.key.update.interval 86400000 在服务器中用于认证令牌的master密钥的更新间隔，单位为毫秒。仅仅当HBase启用了安全配置时可用。 hbase.auth.token.max.lifetime 604800000 一个认证令牌过期之后的最大失效时间，单位为毫秒。仅仅当HBase启用了安全配置时可用。 hbase.ipc.client.fallback-to-simple-auth-allowed false 当一个配置成进行安全连接的客户端，试图连接一个不安全的服务器，服务器将会指导客户端切换到SASL简单认证（不安全）。 这个设置控制客户端是否将接受服务器的指导。如果是false（默认值），客户端将不允许进行简单认证并且将退出连接。 hbase.display.keys true 当该值设置为true，网页UI将显示所有的表的region名，起始和结束主键，以及表的其他信息。如果该值设置成false，那么主键值将被隐藏。 hbase.coprocessor.region.classes 协处理器之间使用逗号分隔，这些协处理器默认会被所有的表加载。用户可以实现自己的协处理器，只需将其添加到HBase的classpath中，并在此配置完整类名。用户也可以根据需求设置HTableDescriptor来选择性的加载协处理器。 hbase.rest.port 8080 用于HBase REST 服务器的端口。 hbase.rest.readonly false 定义REST服务器被启动的模式。可能的值为：false：允许所有的HTTP方法- GET/PUT/POST/DELETE。true:仅仅允许GET方法。 hbase.rest.threads.max 100 REST服务器线程池的最大线程数。线程池中的线程在处理REST请求时重用。这将控制并发处理请求的最大数目。它可以帮助控制REST服务器的内存使用，防止OOM错误。 如果线程池满了，新进入的请求将会等待直到有空闲的线程可用。 hbase.rest.threads.min 2 REST服务器线程池的最小线程数。REST服务器将会保证线程池中至少有一些线程来服务新进入的请求。 hbase.rest.support.proxyuser false 在运行REST服务器时启用对代理用户模式的支持。 hbase.defaults.for.version @@@VERSION@@@ 默认值是是被编译的${project.version}的版本号。这个值用来确定用户在classpath中没有一个旧版本的hbase-default.xml。 hbase.defaults.for.version.skip false 将当前参数设置为true可以跳过'hbase.defaults.for.version'检查。将该参数设置为true，它会在上下文中发挥作用。这一点不同于它在maven下的使用方法，即在IDE中通过maven使用HBase。用户也可以将该参数设置为true，以避免因为hbase-default.xml中的版本检查通不过而产生的运行时异常："hbase-default.xml file seems to be for and old version of HBase (${hbase.version}), this version is X.X.X-SNAPSHOT"。 hbase.coprocessor.master.classes HMaster进程默认使用的协处理器是org.apache.hadoop.hbase.coprocessor.MasterObserver，在该配置中，协处理器之间使用逗号分隔，协处理器中实现的方法将按照配置顺序执行。用户可以通过继承MasterObserver来实现自己的协处理器，只需要将其添加到classpath，并添加可用的类名。 hbase.coprocessor.abortonerror true 如果该值为true，当协处理器加载失败、初始化失败或者抛出异常时，托管的服务器（master或regionserver）将会中止。 设置为false则在错误发生时将允许服务器继续执行，但是协处理器的问题将会导致一部分服务器和其他服务器状态不一致。因此，false最好仅仅用于调试阶段。 hbase.online.schema.update.enable true 设定为true将启用在线模式更改。 hbase.table.lock.enable true 设置为true将启用在zookeeper中对该表的锁定以进行模式改变操作。表的锁定将使得master组织并发的模式修改，防止对表的状态造成破坏。 hbase.table.max.rowsize 1073741824 Get或Scan操作单行的最大字节（默认是1Gb）如果行的大小超过了这个限制，将会在客户端抛出RowTooBigException异常。 hbase.thrift.minWorkerThreads 16 线程池的“核心大小”。每个连接会创建新线程，一直创建到该值表示的数目为止。 hbase.thrift.maxWorkerThreads 1000 线程池的最大大小。当等待的请求队列溢出，新的线程将会被创建，直到数目达到该值表示的数目位置。之后，服务器将开始删除连接。 hbase.thrift.maxQueuedRequests 1000 在队列中等待的Thrift连接的最大数目。在服务器队列请求线程池中没有空闲的线程。只有当队列溢出时，新的线程才会被加入，，直到达到 hbase.thrift.maxQueuedRequests个线程为止。 hbase.thrift.htablepool.size.max 1000 Thrift网关服务器中的存储表的池的最大大小。因为对于每个表名，我们假定单个表，默认最大有1000个工作线程。对于负载超过该值的情况，需要对该值进行调整。 hbase.regionserver.thrift.framed false 在服务器端使用Thrift TFramedTransport。对于thrift服务器，推荐这个传输并且需要在客户端也做相同的配置。将该值改为false将选择默认的传输， 当请求格式不正确时，容易受DoS攻击。这归因于THRIFT-601。 hbase.regionserver.thrift.framed.max_frame_size_in_mb 2 当使用帧传输时，默认的帧大小。 hbase.regionserver.thrift.compact false 使用Thrift TCompactProtocol二进制序列化协议。 hbase.data.umask.enable false 如果值为true，启用。该文件的权限应该被分配给被regionserver写入的那些文件。 hbase.data.umask 000 当hbase.data.umask.enable值为true时，写入的数据文件应该被用于文件权限。 hbase.metrics.showTableName true 是否在每一个列簇metrics中包括这样一个前缀 "tbl.tablename"。如果为true，对于每一个metricsM，每一个列簇metrics将会被报告成tbl.T.cf.CF.M，如果为false， 则每一个列簇metrics将会被整个表的列簇汇总，并且被报告成cf.CF.M。在这两种情况下，整个表汇总的metric M和列簇总会在报告中出现。 hbase.metrics.exposeOperationTimes true 是否通过指定每个列簇和每个region的Hadoop metrics来报告在region server上完成一个操作(Get, Put, Delete, Increment, and Appen)花费的时间。 hbase.snapshot.enabled true 设置为true将允许快照被设置(taken）/ 恢复(restored) / 拷贝(cloned)。 hbase.snapshot.restore.take.failsafe.snapshot true 设置为true以便恢复之前操作的快照。 快照被用来防止失败，以便恢复到之前的状态。在快照恢复成功后，快照应该被删除。 hbase.snapshot.restore.failsafe.name hbase-failsafe-{snapshot.name}-{restore.timestamp} 在恢复操作时采用的故障安全快照的名字。你可以使用{snapshot.name}、{table.name}和{restore.timestamp}变量来创建一个名字。 hbase.server.compactchecker.interval.multiplier 1000 我们每隔一段时间需要查看是否需要合并。通常，合并发生在某些操作（比如memstore刷写）之后，但是如果在一段时间region没有接收 到大量写入，或者因为不同的合并策略，就需要定期进行检查。检查的时间间隔为： hbase.server.compactchecker.interval.multiplier * hbase.server.thread.wakefrequency。 hbase.lease.recovery.timeout 900000(15分钟) dfs租约超时时限，超时则放弃。默认是15分钟。 hbase.lease.recovery.dfs.timeout 64000 dfs恢复租约调用的超时时限。它应该比namenode给datanode发出块恢复命令花费的总时间（包括dfs.heartbeat.interval和它在主datanode上花费的时间以及在死亡的datanode的块恢复时间、dfs.client.socket-timeout）更长。 可以查看HBASE-8389以了解更多内容。 hbase.column.max.version 1 新的列簇描述符将使用该值作为默认保存的版本数。 hbase.dfs.client.read.shortcircuit.buffer.size 131072 如果DFSClient的配置项dfs.client.read.shortcircuit.buffer.size没被设置，我们将使用该配置作为一次短读默认读取的缓冲字节数。 DFSClient本地的默认值是1MB。HBase需要一直打开HDFS文件，因此打开大小为块数*1MB的文件将很快会造成OOME异常。因此，我们需要将默认值调低。在HColumnDescriptor 中将hbase默认的块大小设置为64k。 hbase.regionserver.checksum.verify true 如果设置为true(默认值)，HBase将验证hfile块的校验。HBase在写入数据时会将校验值一起写入hfile。 因为一些原因，HDFS（截止撰写本文档时）会将校验值写入一个独立的文件中。设定该值可以节省一些I/O。当该值被设定时，HDFS的校验检查将会被禁用。如果HBase的校验检查失败， 才会切换到HDFS的校验检查（因此不要禁用HDFS的校验检查！并且该特性只适用于HFile，不适用于WALs）。如果该参数被设置为false，hbase将不会验证任何校验值，它将仅仅依赖在HDFS客户端 上完成检查校验。 hbase.hstore.bytes.per.checksum 16384 在hfile块中新创建的HBase级别的校验块的字节数。 hbase.hstore.checksum.algorithm CRC32 用来计算校验值的算法名。可用的值有：NULL、CRC32和CRC32C。 hbase.status.published false 该设置激活master公布region server的状态。当一个regionserver死亡并且对于它的恢复开启，master将会将该消息发给客户端应用，让它们立刻切断连接并等待一段时间。 hbase.status.publisher.class org.apache.hadoop.hbase.master.ClusterStatusPublisher$MulticastPublisher 使用多播消息来实现的状态发布器。 hbase.status.listener.class org.apache.hadoop.hbase.client.ClusterStatusListener$MulticastListener 使用多播消息来实现的状态监听器。 hbase.status.multicast.address.ip 226.1.1.3 通过多播发布状态时使用的多播地址。 hbase.status.multicast.address.port 16100 通过多播发布状态时候使用的多播端口。 hbase.dynamic.jars.dir ${hbase.rootdir}/lib 该目录指向用户不需要重启就可以被动态加载的过滤器/协处理器的jar文件的目录。然而已经加载的过滤器/协处理器的类将不能被卸载。 可以查看HBASE-1936以了解更多细节。 hbase.security.authentication simple 用来控制HBase安全验证是否可用。可用的值有：'simple' (不验证)和'kerberos'。 hbase.rest.filter.classes org.apache.hadoop.hbase.rest.filter.GzipFilter 对于REST服务的Servlet过滤器。 hbase.master.loadbalancer.class org.apache.hadoop.hbase.master.balancer.StochasticLoadBalancer 当需要进行balance操作时，执行region的balance操作的类。可以在 http://hbase.apache.org/devapidocs/org/apache/hadoop/hbase/master/balancer/StochasticLoadBalancer.html 查看更多关于该类的细节以及它如何工作。它将替换默认值DefaultLoadBalancer（后改名为SimpleLoadBalancer）。 hbase.security.exec.permission.checks false 如果该设置被启用并且ACL访问控制处于激活状态（无论是系统或表设置了AccessController协处理器。）。那么如果用户需要执行协处理器endpoint调用，你需要授予他们EXEC权限。 和其他权限的授予一样，你可以授予用户所有权限，也可以授予用户对某一个表或某一个命名空间的权限。更多关于协处理器endpoint的信息，可以查看HBase指导手册的协处理器部分。 更多的使用AccessController授予或回收权限的内容，可以查看HBase指导手册的HBase安全部分。 hbase.procedure.regionserver.classes 一个用逗号分割的org.apache.hadoop.hbase.procedure.RegionServerProcedureManager列表。它们在激活状态的HRegionServer进程中被默认加载。生命周期方法（init/start/stop） 将会由一个激活状态的HRegionServer指定的程序来调用。你可以实现你自己的RegionServerProcedureManager，仅仅需要将它们放到HBase的类路径(classpath)下，并且将完整的类名放在这里。 hbase.procedure.master.classes 一个用逗号分割的 org.apache.hadoop.hbase.procedure.MasterProcedureManager列表。它在激活状态的HMaster进程中被默认加载。程序由它自己的签名和用户使用的签名以及执行程序时的一个临时名来进行验证。 你可以实现你自己的MasterProcedureManager，仅仅需要将它们放到HBase的类路径(classpath)下，并且将完整的类名放在这里。 hbase.coordinated.state.manager.class org.apache.hadoop.hbase.coordination.ZkCoordinatedStateManager 实现的协调状态管理器的完整的类名。 hbase.regionserver.storefile.refresh.period 0 备份region的store file文件的刷新周期（单位是毫秒）。值为0意味着该特性被禁用。一旦备份region刷新了region中的文件列表（没有一个通知机制），备份region将查看主region中新的文件（那些刷写和合并时产生的）。 但是太频繁的刷新将可能对Namenode造成额外的压力。如果文件在超过HFile TTL（hbase.master.hfilecleaner.ttl）的时间还不能被刷新，那么请求将会被拒绝。所以对于该设置，推荐将hbase.master.hfilecleaner.ttl设置为一个更大的值。 hbase.http.filter.initializers org.apache.hadoop.hbase.http.lib.StaticUserWebFilter 类名使用逗号分割。其中的每一个类都继承自org.apache.hadoop.hbase.http.FilterInitializer。相应的过滤器将会被初始化。紧接着，过滤器在所有用户访问jsp和servlet网页的时候使用。过滤器按照定义的顺序依次使用。默认的StaticUserWebFilter过滤器会增加一个在hbase.http.staticuser.user中定义的用户。 hbase.security.visibility.mutations.checkauths false 该属性如果启用，将会检查可见表达式中的标签是否与用户发出的行为相关联。 hbase.http.max.threads 10 HTTP服务器创建的线程池中线程的最大数目。 用户名过滤器。当在静态网页上呈现内容时的过滤器。一个使用的例子是HDFS的网页UI（用于浏览文件的用户）。 hbase.http.staticuser.user dr.stack