svn commit: r1151257 - in /hbase/trunk: CHANGES.txt src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java

[ap...@apache.org]

Author: apurtell
Date: Tue Jul 26 21:41:17 2011
New Revision: 1151257

URL: http://svn.apache.org/viewvc?rev=1151257&view=rev
Log:
HBASE-4142 Advise against large batches in javadoc for HTable#put(List<Put>)

Modified:
    hbase/trunk/CHANGES.txt
    hbase/trunk/src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java

Modified: hbase/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/hbase/trunk/CHANGES.txt?rev=1151257&r1=1151256&r2=1151257&view=diff
==============================================================================
--- hbase/trunk/CHANGES.txt (original)
+++ hbase/trunk/CHANGES.txt Tue Jul 26 21:41:17 2011
@@ -334,6 +334,7 @@ Release 0.91.0 - Unreleased
                (Alejandro Abdelnur)
    HBASE-3899  enhance HBase RPC to support free-ing up server handler threads
                even if response is not ready (Vlad Dogaru)
+   HBASE-4142  Advise against large batches in javadoc for HTable#put(List<Put>)
 
   TASKS
    HBASE-3559  Move report of split to master OFF the heartbeat channel

Modified: hbase/trunk/src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java
URL: http://svn.apache.org/viewvc/hbase/trunk/src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java?rev=1151257&r1=1151256&r2=1151257&view=diff
==============================================================================
--- hbase/trunk/src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java (original)
+++ hbase/trunk/src/main/java/org/apache/hadoop/hbase/client/HTableInterface.java Tue Jul 26 21:41:17 2011
@@ -188,6 +188,10 @@ public interface HTableInterface {
    * <p>
    * If {@link #isAutoFlush isAutoFlush} is false, the update is buffered
    * until the internal buffer is full.
+   * <p>
+   * This can be used for group commit, or for submitting user defined
+   * batches, but sending large lists of values is not recommended. That may
+   * produce performance problems.
    * @param puts The list of mutations to apply. The batch put is done by
    * aggregating the iteration of the Puts over the write buffer
    * at the client-side for a single RPC call.