Index: src/docbkx/book.xml
===================================================================
--- src/docbkx/book.xml (revision 1184830)
+++ src/docbkx/book.xml (working copy)
@@ -421,7 +421,8 @@
htable.put(put);
Caution: the version timestamp is internally by HBase for things like time-to-live calculations.
- It's usually best to avoid setting the timestamp yourself.
+ It's usually best to avoid setting this timestamp yourself. Prefer using a separate
+ timestamp attribute of the row, or have the timestamp a part of the rowkey, or both.
@@ -1614,25 +1615,27 @@
Even though these are for the same row, a KeyValue is created for each column:
Key portion for Put #1:
- rowlength (4)
- row (row1)
- columnfamilylength (2)
- columnfamily (cf)
- columnqualifier (attr1)
- timestamp (server time of Put)
- keytype (Put)
+ rowlength ------------> 4
+ row -----------------> row1
+ columnfamilylength ---> 2
+ columnfamily --------> cf
+ columnqualifier ------> attr1
+ timestamp -----------> server time of Put
+ keytype -------------> Put
Key portion for Put #2:
- rowlength (4)
- row (row1)
- columnfamilylength (2)
- columnfamily (cf)
- columnqualifier (attr2)
- timestamp (server time of Put)
- keytype (Put)
+ rowlength ------------> 4
+ row -----------------> row1
+ columnfamilylength ---> 2
+ columnfamily --------> cf
+ columnqualifier ------> attr2
+ timestamp -----------> server time of Put
+ keytype -------------> Put
+
It is critical to understand that the rowkey, ColumnFamily, and column (aka columnqualifier) are embedded within