Repository: hbase
Updated Branches:
  refs/heads/master 7d10af125 -> f72c3ef34


HBASE-12648 Document per-cell TTLs (Andrew Purtell)


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

Branch: refs/heads/master
Commit: f72c3ef34d755dc0a1fef6cf744b8add931e166a
Parents: 7d10af1
Author: Misty Stanley-Jones <[email protected]>
Authored: Fri Dec 12 13:41:39 2014 +1000
Committer: Misty Stanley-Jones <[email protected]>
Committed: Fri Dec 12 13:41:39 2014 +1000

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


http://git-wip-us.apache.org/repos/asf/hbase/blob/f72c3ef3/src/main/docbkx/schema_design.xml
----------------------------------------------------------------------
diff --git a/src/main/docbkx/schema_design.xml 
b/src/main/docbkx/schema_design.xml
index 65e64b0..e4632ec 100644
--- a/src/main/docbkx/schema_design.xml
+++ b/src/main/docbkx/schema_design.xml
@@ -509,6 +509,21 @@ public static byte[][] getHexSplits(String startKey, 
String endKey, int numRegio
     <para> See <link
         
xlink:href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/HColumnDescriptor.html";
         >HColumnDescriptor</link> for more information. </para>
+    <para>Recent versions of HBase also support setting time to live on a per 
cell basis. See <link
+        
xlink:href="https://issues.apache.org/jira/browse/HBASE-10560";>HBASE-10560</link>
 for more
+        information. Cell TTLs are submitted as an attribute on mutation 
requests (Appends,
+        Increments, Puts, etc.) using Mutation#setTTL. If the TTL attribute is 
set, it will be applied
+        to all cells updated on the server by the operation. There are two 
notable differences
+        between cell TTL handling and ColumnFamily TTLs:</para>
+    <itemizedlist>
+      <listitem>
+        <para>Cell TTLs are expressed in units of milliseconds instead of 
seconds.</para>
+      </listitem>
+      <listitem>
+        <para>A cell TTLs cannot extend the effective lifetime of a cell 
beyond a ColumnFamily level
+          TTL setting.</para>
+      </listitem>
+    </itemizedlist>
   </section>
   <section
     xml:id="cf.keep.deleted">

Reply via email to