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