# 前言
> 贡献者:[xixici](https://github.com/xixici)
此处为[HBase](https://hbase.apache.org/)版本的官方参考指南。
从这里,你不仅能找到发布的 HBase 版本的最终文档,而且包括相关[Javadoc](https://hbase.apache.org/apidocs/index.html)和[JIRA](https://issues.apache.org/jira/browse/HBASE)信息。
## 关于指南
本指南仍在编辑当中。本指南的源码可以在文件夹 _src/main/asciidoc 当中找到。本指南最终使用 [AsciiDoc](http://asciidoc.org/) 构建,成为'站点'的一部分.
运行
```
mvn site
```
来生成此文档。并且欢迎对此进行修改和改进。点击[此链接](https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310753&issuetype=1&components=12312132&summary=SHORT+DESCRIPTION) 提供 bug 反馈.
## 文档贡献
有关 AsciiDoc 的概述以及文档参与的建议,请参阅本文档后面的[相关部分](#appendix_contributing_to_documentation)。
如果这是你第一次涉足分布式计算领域......
若这是你第一次踏入分布式计算的精彩世界,你会感到这是一个有趣的年代。分布式计算是很难的,做一个分布式系统需要很多软硬件和网络的技能。
你的集群可以会因为各式各样的错误发生故障。比如 HBase 本身的 Bug,错误的配置(包括操作系统),硬件的故障(网卡和磁盘甚至内存)(Issue 里有两个最近的硬件问题示例,表现为“HBase 很慢”) 如果你一直在写单机程序的话,你需要重新开始学习。这是一个很好的起点[分布式计算的谬论](http://en.wikipedia.org/wiki/Fallacies_of_Distributed_Computing).
所以,欢迎你。
这是一个有趣的地方。
HBase 社区。
# 报告 bugs
请使用 [JIRA](https://issues.apache.org/jira/browse/hbase) 报告与安全无关的错误。
为了保护现有 HBase 安装免受新漏洞的影响,**请勿**使用 JIRA 报告与安全相关的错误。 相反,请将您的报告发送到邮件列表[private@hbase.apache.org](mailto:private@hbase.apache.org),该列表允许任何人发送邮件,但限制谁可以阅读邮件。 该列表中的某个人将与您联系以跟进您的报告。
## 支持和测试
以下短语/支持/,/不支持/,/测试/,和/未测试/经常出现在本指南中。 为方便起见,这里先简要解释了这些短语在 HBase 背景下的含义
>许多 Hadoop 供应商都提供 Apache HBase 的商业版本的技术支持。 但这不是在 Apache HBase 项目中/ 支持 /的意义。 Apache HBase 团队对您的 HBase 集群,配置或数据不承担任何责任。
### 支持
在 Apache HBase 中,/ 支持 /意味着 HBase 被设计为以所描述的方式工作,并且应该将与定义的行为或功能的偏差报告为错误。
### 不支持
在 Apache HBase 中,/不支持/意味着用例或使用模式不会重视,应该被视为反模式。如果您认为应该针对给定功能或使用模式重新考虑,请提交 JIRA 或通过邮件讨论。
### 已测试
在 Apache HBase 中,/ 已测试 /意味着单元或集成测试涵盖了一个功能,并且已经证明可以按预期工作。
### 未测试
在 Apache HBase 中,/未测试/表示功能或使用模式可能或可能不以给定方式工作,并且可能会也可能不会损坏您的数据或导致操作问题。这是未知的,没有任何保证。如果您可以提供指定为/未经测试/的功能以特定方式工作的证据,请提交测试和指标,以便其他用户可以确定使用有关功能或使用模式。
- HBase™ 中文参考指南 3.0
- Preface
- Getting Started
- Apache HBase Configuration
- Upgrading
- The Apache HBase Shell
- Data Model
- HBase and Schema Design
- RegionServer Sizing Rules of Thumb
- HBase and MapReduce
- Securing Apache HBase
- Architecture
- In-memory Compaction
- Backup and Restore
- Synchronous Replication
- Apache HBase APIs
- Apache HBase External APIs
- Thrift API and Filter Language
- HBase and Spark
- Apache HBase Coprocessors
- Apache HBase Performance Tuning
- Troubleshooting and Debugging Apache HBase
- Apache HBase Case Studies
- Apache HBase Operational Management
- Building and Developing Apache HBase
- Unit Testing HBase Applications
- Protobuf in HBase
- Procedure Framework (Pv2): HBASE-12439
- AMv2 Description for Devs
- ZooKeeper
- Community
- Appendix