# 前言
> 貢獻者:[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