src/main/asciidoc/_chapters/faq.adoc

   1 ////
   2 /**
   3  *
   4  * Licensed to the Apache Software Foundation (ASF) under one
   5  * or more contributor license agreements.  See the NOTICE file
   6  * distributed with this work for additional information
   7  * regarding copyright ownership.  The ASF licenses this file
   8  * to you under the Apache License, Version 2.0 (the
   9  * "License"); you may not use this file except in compliance
  10  * with the License.  You may obtain a copy of the License at
  11  *
  12  *     http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  */
  20 ////
  21
  22 [appendix]
  23 [[faq]]
  24 == FAQ
  25 :doctype: book
  26 :numbered:
  27 :toc: left
  28 :icons: font
  29 :experimental:
  30
  31 === General
  32 When should I use HBase?::
  33   See <<arch.overview>> in the Architecture chapter.
  34
  35 Does HBase support SQL?::
  36   Not really. SQL-ish support for HBase via link:https://hive.apache.org/[Hive] is in development, however Hive is based on MapReduce which is not generally suitable for low-latency requests. See the <<datamodel>> section for examples on the HBase client.
  37
  38 How can I find examples of NoSQL/HBase?::
  39   See the link to the BigTable paper in <<other.info>>, as well as the other papers.
  40
  41 What is the history of HBase?::
  42   See <<hbase.history,hbase.history>>.
  43
  44 Why are the cells above 10MB not recommended for HBase?::
  45   Large cells don't fit well into HBase's approach to buffering data. First, the large cells bypass the MemStoreLAB when they are written. Then, they cannot be cached in the L2 block cache during read operations. Instead, HBase has to allocate on-heap memory for them each time. This can have a significant impact on the garbage collector within the RegionServer process.
  46
  47 === Upgrading
  48 How do I upgrade Maven-managed projects from HBase 0.94 to HBase 0.96+?::
  49   In HBase 0.96, the project moved to a modular structure. Adjust your project's dependencies to rely upon the `hbase-client` module or another module as appropriate, rather than a single JAR. You can model your Maven dependency after one of the following, depending on your targeted version of HBase. See Section 3.5, “Upgrading from 0.94.x to 0.96.x” or Section 3.3, “Upgrading from 0.96.x to 0.98.x” for more information.
  50 +
  51 .Maven Dependency for HBase 0.98
  52 [source,xml]
  53 ----
  54 <dependency>
  55   <groupId>org.apache.hbase</groupId>
  56   <artifactId>hbase-client</artifactId>
  57   <version>0.98.5-hadoop2</version>
  58 </dependency>
  59 ----
  60 +
  61 .Maven Dependency for HBase 0.96
  62 [source,xml]
  63 ----
  64 <dependency>
  65   <groupId>org.apache.hbase</groupId>
  66   <artifactId>hbase-client</artifactId>
  67   <version>0.96.2-hadoop2</version>
  68 </dependency>
  69 ----
  70 +
  71 .Maven Dependency for HBase 0.94
  72 [source,xml]
  73 ----
  74 <dependency>
  75   <groupId>org.apache.hbase</groupId>
  76   <artifactId>hbase</artifactId>
  77   <version>0.94.3</version>
  78 </dependency>
  79 ----
  80
  81
  82 === Architecture
  83 How does HBase handle Region-RegionServer assignment and locality?::
  84   See <<regions.arch>>.
  85
  86 === Configuration
  87 How can I get started with my first cluster?::
  88   See <<quickstart>>.
  89
  90 Where can I learn about the rest of the configuration options?::
  91   See <<configuration>>.
  92
  93 === Schema Design / Data Access
  94
  95 How should I design my schema in HBase?::
  96   See <<datamodel>> and <<schema>>.
  97
  98 How can I store (fill in the blank) in HBase?::
  99   See <<supported.datatypes>>.
 100
 101 How can I handle secondary indexes in HBase?::
 102   See <<secondary.indexes>>.
 103
 104 Can I change a table's rowkeys?::
 105   This is a very common question. You can't. See <<changing.rowkeys>>.
 106
 107 What APIs does HBase support?::
 108   See <<datamodel>>, <<architecture.client>>, and <<external_apis>>.
 109
 110 === MapReduce
 111
 112 How can I use MapReduce with HBase?::
 113   See <<mapreduce>>.
 114
 115 === Performance and Troubleshooting
 116
 117 How can I improve HBase cluster performance?::
 118   See <<performance>>.
 119
 120 How can I troubleshoot my HBase cluster?::
 121   See <<trouble>>.
 122
 123 === Amazon EC2
 124
 125 I am running HBase on Amazon EC2 and...::
 126   EC2 issues are a special case. See <<trouble.ec2>> and <<perf.ec2>>.
 127
 128 === Operations
 129
 130 How do I manage my HBase cluster?::
 131   See <<ops_mgt>>.
 132
 133 How do I back up my HBase cluster?::
 134   See <<ops.backup>>.
 135
 136 === HBase in Action
 137
 138 Where can I find interesting videos and presentations on HBase?::
 139   See <<other.info>>.
 140
 141 :numbered: