HBASE-11734 Document changed behavior of hbase.hstore.time.to.purge.deletes (Misty Stanley-Jones)

This commit is contained in:
Jonathan M Hsieh 2014-08-18 13:31:02 -07:00
parent c45a8832d2
commit 25a7b75560
2 changed files with 26 additions and 7 deletions

View File

@ -753,6 +753,15 @@ possible configurations would overwhelm and obscure the important.
same way as hbase.hstore.compaction.ratio. Only applies if hbase.offpeak.start.hour and
hbase.offpeak.end.hour are also enabled.</description>
</property>
<property>
<name>hbase.hstore.time.to.purge.deletes</name>
<value>0</value>
<description>The amount of time to delay purging of delete markers with future timestamps. If
unset, or set to 0, all delete markers, including those with future timestamps, are purged
during the next major compaction. Otherwise, a delete marker is kept until the major compaction
which occurs after the marker's timestamp plus the value of this setting, in milliseconds.
</description>
</property>
<property>
<name>hbase.offpeak.start.hour</name>
<value>-1</value>

View File

@ -811,13 +811,23 @@ htable.put(put);
list.</para>
<para>Also see <xref
linkend="keyvalue" /> for more information on the internal KeyValue format. </para>
<para>Delete markers are purged during the major compaction of store, unless the
KEEP_DELETED_CELLS is set in the column family. In some scenarios, users want to keep
the deletes for a time and you can set the delete TTL:
hbase.hstore.time.to.purge.deletes in the configuration. If this delete TTL is not set,
or set to 0, all delete markers including those with future timestamp are purged during
the later major compaction. Otherwise, a delete marker is kept until the major
compaction after marker's timestamp + delete TTL. </para>
<para>Delete markers are purged during the next major compaction of the store, unless the
<option>KEEP_DELETED_CELLS</option> option is set in the column family. To keep the
deletes for a configurable amount of time, you can set the delete TTL via the
<option>hbase.hstore.time.to.purge.deletes</option> property in
<filename>hbase-site.xml</filename>. If
<option>hbase.hstore.time.to.purge.deletes</option> is not set, or set to 0, all
delete markers, including those with timestamps in the future, are purged during the
next major compaction. Otherwise, a delete marker with a timestamp in the future is kept
until the major compaction which occurs after the time represented by the marker's
timestamp plus the value of <option>hbase.hstore.time.to.purge.deletes</option>, in
milliseconds. </para>
<note>
<para>This behavior represents a fix for an unexpected change that was introduced in
HBase 0.94, and was fixed in <link
xlink:href="https://issues.apache.org/jira/browse/HBASE-10118">HBASE-10118</link>.
The change has been backported to HBase 0.94 and newer branches.</para>
</note>
</section>
</section>