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