You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hbase.apache.org by mi...@apache.org on 2014/10/27 23:09:10 UTC

git commit: HBASE-12316 Document scanner timeout troubleshooting for Thrift clients

Repository: hbase
Updated Branches:
  refs/heads/master f2c83704f -> 9ddb25cf3


HBASE-12316 Document scanner timeout troubleshooting for Thrift clients


Project: http://git-wip-us.apache.org/repos/asf/hbase/repo
Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/9ddb25cf
Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/9ddb25cf
Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/9ddb25cf

Branch: refs/heads/master
Commit: 9ddb25cf3af03362f5e590dd4057972590437265
Parents: f2c8370
Author: Misty Stanley-Jones <ms...@cloudera.com>
Authored: Thu Oct 23 14:02:16 2014 +1000
Committer: Misty Stanley-Jones <ms...@cloudera.com>
Committed: Tue Oct 28 08:08:56 2014 +1000

----------------------------------------------------------------------
 src/main/docbkx/troubleshooting.xml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase/blob/9ddb25cf/src/main/docbkx/troubleshooting.xml
----------------------------------------------------------------------
diff --git a/src/main/docbkx/troubleshooting.xml b/src/main/docbkx/troubleshooting.xml
index c2463b0..6ca4d06 100644
--- a/src/main/docbkx/troubleshooting.xml
+++ b/src/main/docbkx/troubleshooting.xml
@@ -607,6 +607,20 @@ java.lang.Thread.State: WAITING (on object monitor)
       <para>See <xref
           linkend="perf.hbase.client.caching" />. </para>
     </section>
+    <section>
+      <title>Performance Differences in Thrift and Java APIs</title>
+      <para>Poor performance, or even <code>ScannerTimeoutExceptions</code>, can occur if
+          <code>Scan.setCaching</code> is too high, as discussed in <xref
+          linkend="trouble.client.scantimeout"/>. If the Thrift client uses the wrong caching
+        settings for a given workload, performance can suffer compared to the Java API. To set
+        caching for a given scan in the Thrift client, use the <code>scannerGetList(scannerId,
+          numRows)</code> method, where <code>numRows</code> is an integer representing the number
+        of rows to cache. In one case, it was found that reducing the cache for Thrift scans from
+        1000 to 100 increased performance to near parity with the Java API given the same
+        queries.</para>
+      <para>See also Jesse Andersen's <link xlink:href="http://blog.cloudera.com/blog/2014/04/how-to-use-the-hbase-thrift-interface-part-3-using-scans/">blog post</link> 
+        about using Scans with Thrift.</para>
+    </section>
     <section
       xml:id="trouble.client.lease.exception">
       <title><classname>LeaseException</classname> when calling